@riverbankcms/sdk 0.139.0 → 0.140.0

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

@@ -52,6 +52,8 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     scopedEvents: RegistrationEvent[];
     preSelectedEvent: RegistrationEvent | null;
     hasPreSelectedContext: boolean;
+    checkoutRecovery: boolean;
+    startCheckoutRecovery: () => void;
     step: RegistrationStep;
     setStep: (nextStep: RegistrationStep) => void;
     selectedEvent: RegistrationEvent | null;
@@ -127,6 +129,8 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
         kind: "none";
     }> | Readonly<{
         kind: "booked";
+    }> | Readonly<{
+        kind: "pending_payment";
     }> | Readonly<{
         kind: "waitlisted";
     }>;
@@ -148,7 +152,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
     handlePaymentSelect: () => Promise<void>;
     handleUseCardInsteadOfPass: () => void;
     handleBookForSomeoneElse: () => void;
-    handleSubmit: (method: import("./PaymentSelectionStep").PaymentMethod, passId?: string, membershipId?: string, selection?: PaymentSelection, submitOptions?: import("./useEventRegistrationSubmit").EventRegistrationSubmitOptions) => Promise<import("./useEventRegistrationSubmit").EventRegistrationSubmitResult>;
+    handleSubmit: import("./useEventRegistrationSubmit").EventRegistrationSubmit;
     handleEventSelect: (event: RegistrationEvent) => void;
     handleRetry: () => void;
 };
@@ -174,6 +178,8 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     scopedEvents: RegistrationEvent[];
     preSelectedEvent: RegistrationEvent | null;
     hasPreSelectedContext: boolean;
+    checkoutRecovery: boolean;
+    startCheckoutRecovery: () => void;
     step: RegistrationStep;
     setStep: (nextStep: RegistrationStep) => void;
     selectedEvent: RegistrationEvent | null;
@@ -249,6 +255,8 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
         kind: "none";
     }> | Readonly<{
         kind: "booked";
+    }> | Readonly<{
+        kind: "pending_payment";
     }> | Readonly<{
         kind: "waitlisted";
     }>;
@@ -270,7 +278,7 @@ export declare function useEventRegistrationWizardWithDeps(options: UseEventRegi
     handlePaymentSelect: () => Promise<void>;
     handleUseCardInsteadOfPass: () => void;
     handleBookForSomeoneElse: () => void;
-    handleSubmit: (method: import("./PaymentSelectionStep").PaymentMethod, passId?: string, membershipId?: string, selection?: PaymentSelection, submitOptions?: import("./useEventRegistrationSubmit").EventRegistrationSubmitOptions) => Promise<import("./useEventRegistrationSubmit").EventRegistrationSubmitResult>;
+    handleSubmit: import("./useEventRegistrationSubmit").EventRegistrationSubmit;
     handleEventSelect: (event: RegistrationEvent) => void;
     handleRetry: () => void;
 };

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

@@ -0,0 +1,18 @@
+import { useBlockApi } from '../../api';
+import type { PublicEvent } from '../../../blocks/events/shared/types';
+import type { EventRegistrationEventSource } from './eventSourceRecovery';
+export type EventSourceRecovery = Readonly<{
+    kind: 'ready';
+    events: PublicEvent[];
+}> | Readonly<{
+    kind: 'loading';
+}> | Readonly<{
+    kind: 'exhausted';
+    retry: () => void;
+}>;
+type RecoveryDeps = Readonly<{
+    useApi: typeof useBlockApi;
+    wait: (milliseconds: number, signal: AbortSignal) => Promise<void>;
+}>;
+export declare function useEventSourceRecovery(source: EventRegistrationEventSource, deps?: RecoveryDeps): EventSourceRecovery;
+export {};

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

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { EventRegistrationClientProps as InternalEventRegistrationClientProps } from './event-registration/types';
-import type { EventRegistrationInteractiveIslandProps } from './event-registration.interactive';
+import { type EventRegistrationInteractiveIslandProps } from './event-registration.interactive';
 export type { PublicEvent, OccurrenceContext } from './event-registration/types';
 export type EventRegistrationClientProps = InternalEventRegistrationClientProps;
 export type EventRegistrationIslandClientProps = EventRegistrationInteractiveIslandProps;

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

@@ -5,6 +5,7 @@ import type { OccurrenceContext } from '../../blocks/event-registration.shared';
 import type { EventRegistrationClientProps as InternalEventRegistrationClientProps } from './event-registration/types';
 import { type EventRegistrationPageSurfaceSubject } from './event-registration/eventScope';
 import { type InteractiveIslandProps } from '../../../contracts/islands';
+import { type EventRegistrationEventSource } from './event-registration/eventSourceRecovery';
 export declare const EVENT_REGISTRATION_GENERIC_SHELL_STEP_LABELS: readonly ["Date", "Tickets", "Details"];
 declare const EVENT_REGISTRATION_SHELL_STEP_LABELS: readonly ["Event", "Date", "Tickets", "Details", "Payment"];
 export type EventRegistrationGenericShellStepLabels = typeof EVENT_REGISTRATION_GENERIC_SHELL_STEP_LABELS;
@@ -19,6 +20,7 @@ export type EventRegistrationSourceProps = Readonly<{
     events?: PublicEvent[] | null;
     /** Runs for a whole-series page, loaded independently of the date page. */
     wholeSeriesRunEvents?: PublicEvent[] | null;
+    eventLoaderFailures?: Readonly<Record<string, unknown>> | null;
     className?: string | null;
     buttonText?: string | null;
     maxTickets?: string | null;
@@ -48,7 +50,9 @@ export type EventRegistrationDisplay = Readonly<{
     titleText: string;
     bodyText: string;
 }>;
-export type EventRegistrationHydration = Readonly<Omit<InternalEventRegistrationClientProps, 'siteId' | 'stage' | 'buttonText' | 'className'>>;
+export type EventRegistrationHydration = Readonly<Omit<InternalEventRegistrationClientProps, 'siteId' | 'stage' | 'buttonText' | 'className' | 'events'> & {
+    eventSource: EventRegistrationEventSource;
+}>;
 type EventRegistrationIslandMeta = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
@@ -56,6 +60,7 @@ type EventRegistrationIslandMeta = Readonly<{
     previewToken?: string | null;
     stage?: 'preview' | 'published';
 }>;
+export declare function buildEventRegistrationDisplayFromScopedEvents(source: EventRegistrationSourceProps, scopedSourceEvents: readonly PublicEvent[]): EventRegistrationDisplay;
 export type EventRegistrationInteractiveIslandProps = InteractiveIslandProps<EventRegistrationIslandMeta, 'event-registration', typeof eventRegistrationBlockRuntime>;
 export declare const eventRegistrationBlockRuntime: Readonly<{
     kind: "client-owned";
@@ -69,6 +74,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         events?: PublicEvent[] | null;
         /** Runs for a whole-series page, loaded independently of the date page. */
         wholeSeriesRunEvents?: PublicEvent[] | null;
+        eventLoaderFailures?: Readonly<Record<string, unknown>> | null;
         className?: string | null;
         buttonText?: string | null;
         maxTickets?: string | null;
@@ -88,7 +94,9 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         }> | null;
     }>) => Readonly<{
         display: EventRegistrationDisplay;
-        hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+        hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+            eventSource: EventRegistrationEventSource;
+        }>;
     }>;
     contracts: Readonly<{
         source: Readonly<{
@@ -102,6 +110,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 events?: PublicEvent[] | null;
                 /** Runs for a whole-series page, loaded independently of the date page. */
                 wholeSeriesRunEvents?: PublicEvent[] | null;
+                eventLoaderFailures?: Readonly<Record<string, unknown>> | null;
                 className?: string | null;
                 buttonText?: string | null;
                 maxTickets?: string | null;
@@ -130,6 +139,7 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
                 events?: PublicEvent[] | null;
                 /** Runs for a whole-series page, loaded independently of the date page. */
                 wholeSeriesRunEvents?: PublicEvent[] | null;
+                eventLoaderFailures?: Readonly<Record<string, unknown>> | null;
                 className?: string | null;
                 buttonText?: string | null;
                 maxTickets?: string | null;
@@ -152,11 +162,15 @@ export declare const eventRegistrationBlockRuntime: Readonly<{
         render: Readonly<{
             encode: (value: Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                    eventSource: EventRegistrationEventSource;
+                }>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+                hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                    eventSource: EventRegistrationEventSource;
+                }>;
             }>>;
         }>;
     }>;
@@ -174,7 +188,9 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
             mode: "event-registration";
         } & Readonly<{
             display: EventRegistrationDisplay;
-            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                eventSource: EventRegistrationEventSource;
+            }>;
         }>>;
     }>) => unknown;
     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<Readonly<{
@@ -189,7 +205,9 @@ export declare const eventRegistrationInteractiveIslandPropsCodec: Readonly<{
             mode: "event-registration";
         } & Readonly<{
             display: EventRegistrationDisplay;
-            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+            hydration: Readonly<Omit<InternalEventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                eventSource: EventRegistrationEventSource;
+            }>;
         }>>;
     }>>;
 }>;

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

@@ -1,13 +1,15 @@
 import React from 'react';
 import { type EventRegistrationSourceProps } from './event-registration.interactive';
-type EventRegistrationProps = Omit<EventRegistrationSourceProps, 'subject'> & Readonly<{
+import type { BlockLoaderFailures } from '../../data/types';
+type EventRegistrationProps = Omit<EventRegistrationSourceProps, 'subject' | 'eventLoaderFailures'> & Readonly<{
     blockId?: string | null;
     children?: React.ReactNode;
     subject?: unknown;
+    loaderFailures?: BlockLoaderFailures | null;
 }>;
 /**
  * Server-safe placeholder for event registration.
  * Provides a static container for island hydration without importing client hooks.
  */
-export declare function EventRegistrationSSR({ blockId, subject, children, ...sourceProps }: EventRegistrationProps): React.JSX.Element;
+export declare function EventRegistrationSSR({ blockId, subject, loaderFailures, children, ...sourceProps }: EventRegistrationProps): React.JSX.Element;
 export default EventRegistrationSSR;

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

@@ -7,6 +7,7 @@ export type NewsletterFormDisplay = Readonly<{
     availability: 'ready' | 'unavailable';
     className: string | null;
     buttonLabel: string;
+    successMessage: string;
     buttonVariant: NewsletterButtonVariant;
     privacyNote: string | null;
     fields: readonly NewsletterFieldDef[];
@@ -51,6 +52,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
             availability: "ready" | "unavailable";
             className: string | null;
             buttonLabel: string;
+            successMessage: string;
             buttonVariant: NewsletterButtonVariant;
             privacyNote: string | null;
             fields: readonly NewsletterFieldDef[];
@@ -79,6 +81,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
                     availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
+                    successMessage: string;
                     buttonVariant: NewsletterButtonVariant;
                     privacyNote: string | null;
                     fields: readonly NewsletterFieldDef[];
@@ -101,6 +104,7 @@ export declare const newsletterFormBlockRuntime: Readonly<{
                     availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
+                    successMessage: string;
                     buttonVariant: NewsletterButtonVariant;
                     privacyNote: string | null;
                     fields: readonly NewsletterFieldDef[];
@@ -135,6 +139,7 @@ export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
                 availability: "ready" | "unavailable";
                 className: string | null;
                 buttonLabel: string;
+                successMessage: string;
                 buttonVariant: NewsletterButtonVariant;
                 privacyNote: string | null;
                 fields: readonly NewsletterFieldDef[];
@@ -165,6 +170,7 @@ export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
                 availability: "ready" | "unavailable";
                 className: string | null;
                 buttonLabel: string;
+                successMessage: string;
                 buttonVariant: NewsletterButtonVariant;
                 privacyNote: string | null;
                 fields: readonly NewsletterFieldDef[];

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

@@ -33,6 +33,7 @@ type NewsletterFormCommonProps = {
 type BlockNewsletterFormSource = Readonly<{
     source: 'block';
     blockId?: string | null;
+    contentVersionId?: string | null;
 }>;
 type SignedFooterNewsletterFormSource = Readonly<{
     source: 'signed-footer';

package/dist/_dts/blocks/src/system/runtime/resolver.d.ts

@@ -30,6 +30,7 @@ export type ResolverContext = {
     entriesByIdentifier?: EntryIdentifierMap;
     pathBase?: string;
     blockId?: string | null;
+    contentVersionId?: string | null;
     blockKind?: string;
     blockContent?: unknown;
     blockBindings?: Record<string, unknown>;

package/dist/_dts/blocks/src/system/runtime/shared/components/index.d.ts

@@ -8,10 +8,6 @@ export { BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES, DiscountCodeDisclosure, } from
 export type { DiscountCodeDisclosureProps, DiscountCodeDisclosureSurface, } from './DiscountCodeDisclosure';
 export { ActionRow } from './ActionRow';
 export type { ActionRowProps } from './ActionRow';
-export { BookingOptionCompactRow } from './BookingOptionCompactRow';
-export type { BookingOptionCompactRowAction, BookingOptionCompactRowProps, BookingOptionCompactRowViewModel, BookingOptionMetaItem, } from './BookingOptionCompactRow';
-export { BookingOptionList } from './BookingOptionList';
-export type { BookingOptionGroupViewModel, BookingOptionListProps, } from './BookingOptionList';
 export { FieldValidationMessage, getFieldValidationControlProps, } from './FieldValidationMessage';
 export type { FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, } from './FieldValidationMessage';
 export { FeedbackMessage } from './FeedbackMessage';
@@ -24,8 +20,8 @@ export { ModalShell } from './ModalShell';
 export type { ModalShellProps } from './ModalShell';
 export { TabBarFragment } from './TabBarFragment';
 export { TerminalPanel } from './TerminalPanel';
-export type { TerminalPanelProps, TerminalPanelTitleElement } from './TerminalPanel';
+export type { TerminalPanelProps, TerminalPanelTitleElement, } from './TerminalPanel';
 export { StepIndicator } from './StepIndicator';
-export type { StepIndicatorBaseProps, StepIndicatorProps } from './StepIndicator';
+export type { StepIndicatorBaseProps, StepIndicatorProps, } from './StepIndicator';
 export { RB_OPTION_CARD_CLASSES, SelectableOptionCard, } from './SelectableOptionCard';
 export type { SelectableOptionCardProps } from './SelectableOptionCard';

package/dist/_dts/blocks/src/system/runtime/shared/index.d.ts

@@ -8,5 +8,5 @@ export { DEFAULT_CURRENCY } from './types';
 export { BOOK_TARGET_PARAMS, buildCheckoutReturnUrls, resolveDedicatedBookingHref, resolveDedicatedBookingPath, resolveDedicatedBookingTarget, formatPrice, scrollToBlock, consumeSearchParam, consumeSearchParams, validateFormData, getStepNumber, } from './utils';
 export type { DedicatedBookingTarget, UniversalBookingRouteTarget, } from './utils';
 export { createBodyThemePortalRoot } from './utils';
-export { ActionRow, BookingOptionCompactRow, BookingOptionList, CheckIcon, ClockIcon, CrossIcon, BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES, DiscountCodeDisclosure, FieldValidationMessage, FeedbackMessage, getFieldValidationControlProps, MembershipHero, ModalShell, RB_OPTION_CARD_CLASSES, SelectableOptionCard, StateIcon, StepIndicator, TerminalPanel, } from './components';
-export type { ActionRowProps, SelectableOptionCardProps, BookingOptionCompactRowAction, BookingOptionCompactRowProps, BookingOptionCompactRowViewModel, BookingOptionGroupViewModel, BookingOptionListProps, BookingOptionMetaItem, DiscountCodeDisclosureProps, DiscountCodeDisclosureSurface, FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, ModalShellProps, StepIndicatorBaseProps, StepIndicatorProps, TerminalPanelProps, TerminalPanelTitleElement, } from './components';
+export { ActionRow, CheckIcon, ClockIcon, CrossIcon, BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES, DiscountCodeDisclosure, FieldValidationMessage, FeedbackMessage, getFieldValidationControlProps, MembershipHero, ModalShell, RB_OPTION_CARD_CLASSES, SelectableOptionCard, StateIcon, StepIndicator, TerminalPanel, } from './components';
+export type { ActionRowProps, SelectableOptionCardProps, DiscountCodeDisclosureProps, DiscountCodeDisclosureSurface, FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, ModalShellProps, StepIndicatorBaseProps, StepIndicatorProps, TerminalPanelProps, TerminalPanelTitleElement, } from './components';

package/dist/_dts/blocks/src/system/runtime/shared/useWaitlistClaim.d.ts

@@ -1,8 +1,10 @@
 import { useBlockApi } from "../api";
 import type { ResolveWaitlistClaimResponse } from "../api/types";
 export declare function getWaitlistClaimTokenFromUrl(): string | null;
+export declare function getWaitlistClaimEntryIdFromUrl(): string | null;
 export type UseWaitlistClaimResult = {
     token: string | null;
+    entryId: string | null;
     claim: ResolveWaitlistClaimResponse | null;
     error: string | null;
     loginMessage: string | null;

package/dist/_dts/commerce/src/purchase/event-registration-errors.d.ts

@@ -8,6 +8,10 @@ export declare const eventRegistrationErrors: {
         readonly message: "We’re checking your booking and payment. Please don’t try to book again yet. If you’ve already paid, you don’t need to pay again.";
         readonly action: "payment-status";
     };
+    readonly paymentProviderUnavailable: {
+        readonly message: "We couldn’t reach the payment provider. Please try again in a minute.";
+        readonly action: "retry";
+    };
     readonly paymentPageUnavailable: {
         readonly message: "We couldn’t open the payment page. Please refresh this page and try again. If this keeps happening, contact the organiser for help.";
         readonly action: "retry";

package/dist/_dts/commerce/src/purchase/orderItemMetadata.d.ts

@@ -26,8 +26,17 @@ export declare const DATED_OFFERING_ORDER_ITEM_ENGINE_METADATA_KEYS: {
     readonly courseId: "courseId";
     readonly customerId: "customerId";
     readonly eventSeriesId: "eventSeriesId";
-    readonly nonCashProjectionIdempotencyKey: "datedOfferingNonCashProjectionIdempotencyKey";
+    readonly settlementKind: "datedOfferingEngineSettlementKind";
 };
+/**
+ * How a shared whole-series registration order item was settled.
+ *
+ * A checkout item is the one that consumed a capacity hold and carries its
+ * ids; a non-cash item names its settlement outright, because there is no hold
+ * to identify it by. The registration itself is `event_series_registration_id`
+ * on the row.
+ */
+export type DatedOfferingOrderItemSettlementKind = 'non_cash_registration';
 export type DatedOfferingOrderItemEngineMetadata = Readonly<{
     datedOfferingEngineContractVersion: 'shared_v1';
     datedOfferingEngineRouteKind: 'shared_whole_series_registration';
@@ -39,10 +48,24 @@ export type DatedOfferingOrderItemEngineMetadata = Readonly<{
 export type DatedOfferingNonCashOrderItemEngineMetadata = Readonly<{
     datedOfferingEngineContractVersion: 'shared_v1';
     datedOfferingEngineRouteKind: 'shared_whole_series_registration';
-    datedOfferingNonCashProjectionIdempotencyKey: string;
+    datedOfferingEngineSettlementKind: DatedOfferingOrderItemSettlementKind;
     customerId: CustomerId;
     eventSeriesId: EventSeriesId;
 }>;
+/**
+ * What each arm forbids the other from carrying.
+ *
+ * Both arms share the same version and route literals, so without these a
+ * hybrid carrying hold identity *and* a settlement kind satisfies the union —
+ * exactly the object both parsers below reject.
+ */
+type NoDatedOfferingSettlementKind = Readonly<{
+    datedOfferingEngineSettlementKind?: never;
+}>;
+type NoDatedOfferingCapacityHold = Readonly<{
+    datedOfferingCapacityHoldId?: never;
+    datedOfferingCapacityHoldAuditRef?: never;
+}>;
 export type DatedOfferingOrderItemEngineMetadataParseError = Readonly<{
     kind: 'invalid_engine_contract';
 }> | Readonly<{
@@ -66,11 +89,11 @@ export type DatedOfferingMetadataRefParseError = Readonly<{
     kind: 'invalid_uuid';
 }>;
 type LegacyDatedOfferingOrderItemEngineMetadata = Readonly<{
-    [TKey in keyof DatedOfferingOrderItemEngineMetadata]?: never;
+    [TKey in keyof DatedOfferingOrderItemEngineMetadata | keyof DatedOfferingNonCashOrderItemEngineMetadata]?: never;
 }>;
 export type EventSeriesRegistrationEngineMetadata = (LegacyDatedOfferingOrderItemEngineMetadata & Readonly<{
     courseId: RetiredCourseId;
-}>) | DatedOfferingOrderItemEngineMetadata | DatedOfferingNonCashOrderItemEngineMetadata;
+}>) | (DatedOfferingOrderItemEngineMetadata & NoDatedOfferingSettlementKind) | (DatedOfferingNonCashOrderItemEngineMetadata & NoDatedOfferingCapacityHold);
 export type EventTicketOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & BookableOrderItemPricingMetadata & Readonly<{
     eventSeriesId: string;
     occurrenceId: OccurrenceId;

package/dist/_dts/content-editor/src/controller/EntryControllerProvider.d.ts

@@ -1,5 +1,5 @@
 import { type ContentEntrySnapshot, type ContentTypeSchema, type ToolbarState } from '../../../content-model/src/index';
-import type { EditorBlockId } from '../../../core/src/index';
+import type { EditorBlockId, MailingListProviderScope } from '../../../core/src/index';
 import type { BlockItem } from '../../../editor-blocks/src/block-editor/types';
 import { type ReactNode } from 'react';
 import { type PublishOptions } from '../hooks/useEntryActions';
@@ -90,6 +90,7 @@ type BaseInternalProps = {
     onEntryUpdated?: (response: unknown) => void;
     historyShortcutsEnabled?: boolean;
     resolveBlockManifest?: ResolveBlockManifest;
+    getExpectedMailingListProviderScope?: () => MailingListProviderScope | null;
 };
 type EditorOwnerServiceProps = Readonly<{
     owner: {

package/dist/_dts/content-editor/src/hooks/useBlockAutosave.d.ts

@@ -1,3 +1,4 @@
+import { type MailingListProviderScope } from '../../../core/src/index';
 import type { ApiClient } from '../services';
 import type { EditorUiStoreInstance } from '../ui/editorUiStore';
 export type BlockAutosaveOptions = {
@@ -10,6 +11,7 @@ export type BlockAutosaveOptions = {
     /** Whether this entry has a route (pages have blocks, content entries don't) */
     hasRoute: boolean;
     owner: BlockAutosaveOwner;
+    getExpectedMailingListProviderScope?: () => MailingListProviderScope | null;
 };
 export type BlockAutosaveOwner = Readonly<{
     kind: 'contentEntry';
@@ -32,4 +34,4 @@ export declare function planBlockSaveRevisionForOwner(owner: BlockAutosaveOwner,
  *
  * Only enabled for pages (hasRoute=true), as content entries don't have blocks.
  */
-export declare function useBlockAutosave({ uiStore, apiClient, siteId, hasRoute, owner, }: BlockAutosaveOptions): import("./useSimpleAutosave").AutosaveHandle;
+export declare function useBlockAutosave({ uiStore, apiClient, siteId, hasRoute, owner, getExpectedMailingListProviderScope, }: BlockAutosaveOptions): import("./useSimpleAutosave").AutosaveHandle;

package/dist/_dts/content-editor/src/useFooterComposerState.d.ts

@@ -33,6 +33,9 @@ export declare function useFooterComposerState({ apiClient, canEdit, initialTarg
     engagementOptions: Readonly<{
         forms: readonly import("../../api/src/footerSettings").FooterFormSummary[];
         mailingList: import("../../core/src/index").MailingListRuntimeContext;
+        expectedMailingListProviderScope: import("../../core/src/index").MailingListProviderScope | null;
+        confirmation: import("../../core/src/index").ConfiguredMailingListProvider["confirmation"] | null;
+        canManageMailingListSetup: boolean;
     }> | null;
     load: () => Promise<void>;
     loadError: string | null;

package/dist/_dts/core/src/branded.d.ts

@@ -60,7 +60,6 @@ export type BookingSessionId = Brand<string, 'BookingSessionId'>;
 export type DatedOfferingCapacityHoldId = Brand<string, 'DatedOfferingCapacityHoldId'>;
 export type DatedOfferingCapacityHoldAuditRef = Brand<string, 'DatedOfferingCapacityHoldAuditRef'>;
 export type DatedOfferingRevocationAuditEventId = Brand<string, 'DatedOfferingRevocationAuditEventId'>;
-export type DatedOfferingNonCashProjectionClaimToken = Brand<string, 'DatedOfferingNonCashProjectionClaimToken'>;
 export type DatedOfferingWaitlistCapacityEffectId = Brand<string, 'DatedOfferingWaitlistCapacityEffectId'>;
 export type DatedOfferingWaitlistCapacityEffectClaimToken = Brand<string, 'DatedOfferingWaitlistCapacityEffectClaimToken'>;
 export type DatedOfferingRunCancellationOperationId = Brand<string, 'DatedOfferingRunCancellationOperationId'>;
@@ -99,7 +98,6 @@ export type EventRegistrationCommandId = Brand<string, 'EventRegistrationCommand
  * is meant.
  */
 export type EventRegistrationCommandRowId = Brand<string, 'EventRegistrationCommandRowId'>;
-export type EventRegistrationProjectionClaimToken = Brand<string, 'EventRegistrationProjectionClaimToken'>;
 export type CustomerPassId = Brand<string, 'CustomerPassId'>;
 export type CustomerMembershipId = Brand<string, 'CustomerMembershipId'>;
 export type AppointmentId = Brand<string, 'AppointmentId'>;
@@ -146,7 +144,6 @@ export type ParticipantId = Brand<string, 'ParticipantId'>;
 export type ParticipantParticipationId = Brand<string, 'ParticipantParticipationId'>;
 export type ParticipantRosterAssertionJobId = Brand<string, 'ParticipantRosterAssertionJobId'>;
 export type ParticipantBookingQuestionsTaskId = Brand<string, 'ParticipantBookingQuestionsTaskId'>;
-export type EventAttendeeGuestId = Brand<string, 'EventAttendeeGuestId'>;
 export type PersonRecordId = Brand<string, 'PersonRecordId'>;
 export type EncounterRecordId = Brand<string, 'EncounterRecordId'>;
 export type RecordEntryId = Brand<string, 'RecordEntryId'>;
@@ -212,7 +209,6 @@ export declare const unsafeAsBookingSessionId: (id: string) => BookingSessionId;
 export declare const unsafeAsDatedOfferingCapacityHoldId: (value: string) => DatedOfferingCapacityHoldId;
 export declare const unsafeAsDatedOfferingCapacityHoldAuditRef: (value: string) => DatedOfferingCapacityHoldAuditRef;
 export declare const unsafeAsDatedOfferingRevocationAuditEventId: (value: string) => DatedOfferingRevocationAuditEventId;
-export declare const unsafeAsDatedOfferingNonCashProjectionClaimToken: (value: string) => DatedOfferingNonCashProjectionClaimToken;
 export declare const unsafeAsDatedOfferingWaitlistCapacityEffectId: (value: string) => DatedOfferingWaitlistCapacityEffectId;
 export declare const unsafeAsDatedOfferingWaitlistCapacityEffectClaimToken: (value: string) => DatedOfferingWaitlistCapacityEffectClaimToken;
 export declare const unsafeAsDatedOfferingRunCancellationOperationId: (value: string) => DatedOfferingRunCancellationOperationId;
@@ -236,7 +232,6 @@ export declare const unsafeAsCheckoutLineId: (id: string) => CheckoutLineId;
 export declare const unsafeAsAttendeeId: (id: string) => AttendeeId;
 export declare const unsafeAsEventRegistrationCommandId: (id: string) => EventRegistrationCommandId;
 export declare const unsafeAsEventRegistrationCommandRowId: (id: string) => EventRegistrationCommandRowId;
-export declare const unsafeAsEventRegistrationProjectionClaimToken: (id: string) => EventRegistrationProjectionClaimToken;
 export declare const unsafeAsCustomerPassId: (id: string) => CustomerPassId;
 export declare const unsafeAsCustomerMembershipId: (id: string) => CustomerMembershipId;
 export declare const unsafeAsAppointmentId: (id: string) => AppointmentId;
@@ -282,7 +277,6 @@ export declare const unsafeAsParticipantId: (id: string) => ParticipantId;
 export declare const unsafeAsParticipantParticipationId: (id: string) => ParticipantParticipationId;
 export declare const unsafeAsParticipantRosterAssertionJobId: (id: string) => ParticipantRosterAssertionJobId;
 export declare const unsafeAsParticipantBookingQuestionsTaskId: (id: string) => ParticipantBookingQuestionsTaskId;
-export declare const unsafeAsEventAttendeeGuestId: (id: string) => EventAttendeeGuestId;
 export declare const unsafeAsPersonRecordId: (id: string) => PersonRecordId;
 export declare const unsafeAsEncounterRecordId: (id: string) => EncounterRecordId;
 export declare const unsafeAsRecordEntryId: (id: string) => RecordEntryId;
@@ -318,11 +312,9 @@ export declare const parseAppointmentReservationRunId: (value: unknown) => Resul
 export declare const parseAttendeeId: (value: unknown) => Result<AttendeeId, BrandedIdParseError>;
 export declare const parseEventRegistrationCommandId: (value: unknown) => Result<EventRegistrationCommandId, BrandedIdParseError>;
 export declare const parseEventRegistrationCommandRowId: (value: unknown) => Result<EventRegistrationCommandRowId, BrandedIdParseError>;
-export declare const parseEventRegistrationProjectionClaimToken: (value: unknown) => Result<EventRegistrationProjectionClaimToken, BrandedIdParseError>;
 export declare const parseDatedOfferingCapacityHoldId: (value: unknown) => Result<DatedOfferingCapacityHoldId, BrandedIdParseError>;
 export declare const parseDatedOfferingCapacityHoldAuditRef: (value: unknown) => Result<DatedOfferingCapacityHoldAuditRef, BrandedIdParseError>;
 export declare const parseDatedOfferingRevocationAuditEventId: (value: unknown) => Result<DatedOfferingRevocationAuditEventId, BrandedIdParseError>;
-export declare const parseDatedOfferingNonCashProjectionClaimToken: (value: unknown) => Result<DatedOfferingNonCashProjectionClaimToken, BrandedIdParseError>;
 export declare const parseDatedOfferingWaitlistCapacityEffectId: (value: unknown) => Result<DatedOfferingWaitlistCapacityEffectId, BrandedIdParseError>;
 export declare const parseDatedOfferingWaitlistCapacityEffectClaimToken: (value: unknown) => Result<DatedOfferingWaitlistCapacityEffectClaimToken, BrandedIdParseError>;
 export declare const parseDatedOfferingRunCancellationOperationId: (value: unknown) => Result<DatedOfferingRunCancellationOperationId, BrandedIdParseError>;

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

@@ -35,6 +35,7 @@ export * from './participants';
 export * from './participant-identity';
 export * from './public-url-validation';
 export * from './public-profile';
+export * from './public-experience';
 export * from './rich-text';
 export * from './footer-composition';
 export * from './footer-navigation-layout';

package/dist/_dts/core/src/mailing-list-setup-parser.d.ts

@@ -6,7 +6,7 @@ export type MailingListSetupParseError = Readonly<{
 }>;
 export type MailingListGlobalFormParseError = Readonly<{
     tag: 'invalid_mailing_list_global_form';
-    field: 'shape' | 'fields' | 'includeOptionalPhone' | 'buttonLabel' | 'privacyNote';
+    field: 'shape' | 'fields' | 'includeOptionalPhone' | 'buttonLabel' | 'successMessage' | 'privacyNote';
 }>;
 export declare function parseMailingListGlobalForm(value: unknown): Result<MailingListGlobalForm, MailingListGlobalFormParseError>;
 export declare function parseMailingListSiteSetup(value: unknown): Result<MailingListSiteSetup, MailingListSetupParseError>;

package/dist/_dts/core/src/mailing-list-setup.d.ts

@@ -1,6 +1,9 @@
 import type { Brand, SiteId } from './branded';
-import type { BrevoAccountId, BrevoConfirmationTemplateId, BrevoConnectionId, BrevoListId, MailchimpAccountId, MailchimpAudienceId, MailchimpConnectionId, NewsletterListId } from './mailing-list-identifiers';
+import { type BrevoAccountId, type BrevoConfirmationTemplateId, type BrevoConnectionId, type BrevoListId, type MailchimpAccountId, type MailchimpAudienceId, type MailchimpConnectionId, type NewsletterListId } from './mailing-list-identifiers';
+import { type Result } from './result';
 export type MailingListProvider = 'native' | 'mailchimp' | 'brevo';
+/** The name shown to people for each provider; the native one is the product brand. */
+export declare function mailingListProviderName(provider: MailingListProvider): string;
 export type NativeMailingListTopicId = NewsletterListId;
 export type MailingListSetupRevision = Brand<number, 'MailingListSetupRevision'>;
 export type MailingListProfileField = 'name' | 'first_name' | 'last_name' | 'company' | 'phone';
@@ -22,8 +25,15 @@ export type MailingListGlobalForm = Readonly<{
     fields: MailingListGlobalFields;
     includeOptionalPhone: boolean;
     buttonLabel: string;
+    successMessage: string;
     privacyNote: string | null;
 }>;
+export declare const DEFAULT_MAILING_LIST_SUCCESS_MESSAGE = "Thanks \u2014 you're on the list.";
+/**
+ * Seeded into a new setup so every signup form carries a preferences/unsubscribe
+ * reassurance out of the box. Administrators can edit or clear it.
+ */
+export declare const DEFAULT_MAILING_LIST_PRIVACY_NOTE = "Change your preferences or unsubscribe at any time.";
 export type ToggleConfirmation = Readonly<{
     tag: 'off';
 }> | Readonly<{
@@ -126,4 +136,7 @@ export type MailingListProviderScope = Readonly<{
     provider: 'brevo';
     accountId: BrevoAccountId;
 }>;
+export declare function mailingListProviderScopeFromConfigured(provider: ConfiguredMailingListProvider): MailingListProviderScope;
+export declare function parseMailingListProviderScope(value: unknown): Result<MailingListProviderScope, 'invalid_mailing_list_provider_scope'>;
+export declare function sameMailingListProviderScope(previous: MailingListProviderScope, next: MailingListProviderScope): boolean;
 export declare function countDefaultMailingListPlacements(placementModes: readonly ('default' | 'custom')[]): number;

package/dist/_dts/core/src/mailing-list-submission.d.ts

@@ -34,23 +34,22 @@ export type MailingListSignupSource = Readonly<{
 export type MailingListSignupSourceRef = Readonly<{
     tag: 'block_ref';
     blockId: MailingListBlockId;
+    contentVersionId: ContentVersionId;
 }> | Readonly<{
     tag: 'signed_source_ref';
     token: MailingListSignedSourceToken;
 }>;
 /** Source identity signed into managed-footer and SDK-footer form tokens. */
 export type MailingListSignupTokenSource = Readonly<{
-    kind: 'block';
-    blockId: MailingListBlockId;
-}> | Readonly<{
     kind: 'footer-composition';
     sectionId: FooterModuleId;
+    revision: MailingListFooterRevision;
 }> | Readonly<{
     kind: 'sdk-footer-block';
     blockId: MailingListSdkFooterBlockId;
     contentHash: MailingListSdkContentHash;
 }>;
-export declare function buildMailingListSignupBlockSourceRef(blockId: unknown): MailingListSignupSourceRef | null;
+export declare function buildMailingListSignupBlockSourceRef(blockId: unknown, contentVersionId: unknown): MailingListSignupSourceRef | null;
 type MailingListSignupProfileBase = Readonly<{
     email: NormalizedSubscriberEmail;
     phone: Readonly<{
@@ -108,27 +107,6 @@ type ResolvedMailingListSignupIntentBase = Readonly<{
     source: MailingListSignupSource;
     consentedAt: string;
 }>;
-type ResolvedMailingListFormProfile = Readonly<{
-    formPreset: 'emailOnly';
-    profile: Extract<MailingListSignupProfile, {
-        preset: 'emailOnly';
-    }>;
-}> | Readonly<{
-    formPreset: 'emailName';
-    profile: Extract<MailingListSignupProfile, {
-        preset: 'emailName';
-    }>;
-}> | Readonly<{
-    formPreset: 'emailFirstLast';
-    profile: Extract<MailingListSignupProfile, {
-        preset: 'emailFirstLast';
-    }>;
-}> | Readonly<{
-    formPreset: 'emailNameCompany';
-    profile: Extract<MailingListSignupProfile, {
-        preset: 'emailNameCompany';
-    }>;
-}>;
 type ResolvedMailingListProviderIntent = Readonly<{
     provider: 'native';
     target: Extract<ResolvedMailingListTarget, {
@@ -150,7 +128,9 @@ type ResolvedMailingListProviderIntent = Readonly<{
     }>;
     confirmation: BrevoConfirmation;
 }>;
-export type ResolvedMailingListSignupIntent = ResolvedMailingListSignupIntentBase & ResolvedMailingListFormProfile & ResolvedMailingListProviderIntent;
+export type ResolvedMailingListSignupIntent = ResolvedMailingListSignupIntentBase & Readonly<{
+    profile: MailingListSignupProfile;
+}> & ResolvedMailingListProviderIntent;
 export type MailingListProviderAcknowledgement = Readonly<{
     tag: 'subscribed';
 }> | Readonly<{
@@ -199,7 +179,7 @@ export type MailingListPublicSignupResponse = Readonly<{
     reason: 'profile_rejected';
 }> | Readonly<{
     tag: 'unavailable';
-    reason: 'configuration_unavailable' | 'stale_configuration' | 'authentication_failed' | 'target_unavailable' | 'subscriber_suppressed' | 'rate_limited' | 'temporarily_unavailable';
+    reason: 'configuration_unavailable' | 'stale_configuration' | 'authentication_failed' | 'target_unavailable' | 'rate_limited' | 'temporarily_unavailable';
 }> | Readonly<{
     tag: 'uncertain';
     reason: 'deadline_exceeded' | 'network_interrupted';