@riverbankcms/sdk 0.138.0 → 0.139.0

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

@@ -5,6 +5,8 @@ export * from '../domain';
 export * from './listingLayout';
 export { EventCard } from './EventCard';
 export { EventCompactRow } from './EventCompactRow';
+export { EventQuickDates } from './EventQuickDates';
 export { EmptyState } from './EmptyState';
 export { DateTimeTile } from './DateTimeTile';
+export { CalendarDayHeaders } from './CalendarDayHeaders';
 export { OfferingTitle } from './OfferingTitle';

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

@@ -44,6 +44,7 @@ type BuildTimetableModelInput = {
     viewDate: CalendarDate;
     today: CalendarDate;
     startOfWeek: WeekStart;
+    calendarTimeZone: string;
 };
 export declare function buildTimetableModel(input: BuildTimetableModelInput): TimetableModel;
 export {};

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

@@ -0,0 +1,6 @@
+/**
+ * The first client render must retain the server's data-dependent shell.
+ * State becomes ready after hydration so subsequent loading transitions can
+ * use the live calendar state without changing the server markup mid-hydrate.
+ */
+export declare function useHydrationReady(): boolean;

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

@@ -15,6 +15,7 @@ export type NewsletterFormSubmissionState = Readonly<{
     error: NewsletterFormError;
 }> | Readonly<{
     tag: 'success';
+    outcome: 'subscribed' | 'confirmation_required';
 }>;
 export type NewsletterFormSubmissionAction = Readonly<{
     type: 'submitted';
@@ -23,6 +24,7 @@ export type NewsletterFormSubmissionAction = Readonly<{
     error: NewsletterFormError;
 }> | Readonly<{
     type: 'succeeded';
+    outcome: 'subscribed' | 'confirmation_required';
 }>;
 export declare const initialNewsletterFormSubmissionState: NewsletterFormSubmissionState;
 export declare function newsletterFormSubmissionReducer(state: NewsletterFormSubmissionState, action: NewsletterFormSubmissionAction): NewsletterFormSubmissionState;
@@ -30,5 +32,6 @@ export declare function newsletterFieldError(fieldId: string, message: string):
 export declare function newsletterFormError(message: string): NewsletterFormError;
 export declare function isNewsletterFormSubmitting(state: NewsletterFormSubmissionState): boolean;
 export declare function isNewsletterFormSuccess(state: NewsletterFormSubmissionState): boolean;
+export declare function getNewsletterSuccessOutcome(state: NewsletterFormSubmissionState): 'subscribed' | 'confirmation_required' | null;
 export declare function getNewsletterSubmissionFieldError(state: NewsletterFormSubmissionState, fieldId: string): string | null;
 export declare function getNewsletterSubmissionFormError(state: NewsletterFormSubmissionState): string | null;

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

@@ -1,38 +1,41 @@
+import { type MailingListSignupSourceRef } from '../../../../../core/src/index';
 import { type InteractiveIslandProps } from '../../../contracts/islands';
-import { type NewsletterSignupPublicDestinationRef } from '../../blocks/newsletter-signup-destination';
-import { type NewsletterButtonVariant, type NewsletterFieldDef, type NewsletterFormProps, type NewsletterPreset } from './newsletter-form.types';
+import { type NewsletterButtonVariant, type NewsletterFieldDef, type NewsletterFormProps } from './newsletter-form.types';
 export type NewsletterFormSourceProps = NewsletterFormProps;
 export type NewsletterFormDisplay = Readonly<{
     kind: 'newsletter-form';
+    availability: 'ready' | 'unavailable';
     className: string | null;
     buttonLabel: string;
     buttonVariant: NewsletterButtonVariant;
-    successMessage: string | null;
     privacyNote: string | null;
     fields: readonly NewsletterFieldDef[];
+    choices: readonly Readonly<{
+        id: string;
+        label: string;
+    }>[];
 }>;
 export type NewsletterFormHydration = Readonly<{
     target: NewsletterFormHydrationTarget;
-    preset: NewsletterPreset;
-    includePhone: boolean;
-    tags?: string | null;
+    setupRevision: number | null;
+    choiceProvider: 'native' | 'brevo' | 'mailchimp' | null;
+    choicePresentation: 'hidden' | 'automatic' | 'visitor_choice';
     spamProtectionEnabled?: boolean;
 }>;
 export type NewsletterFormHydrationTarget = Readonly<{
     tag: 'block-source';
-    destinationRef: NewsletterSignupBlockDestinationRef | null;
+    sourceRef: MailingListSignupBlockSourceRef | null;
 }> | Readonly<{
     tag: 'signed-footer-source';
-    destinationRef: NewsletterSignupSignedDestinationRef;
+    sourceRef: MailingListSignupSignedSourceRef;
 }> | Readonly<{
-    tag: 'legacy-direct-list';
-    listId: string | null;
+    tag: 'preview';
 }>;
-type NewsletterSignupBlockDestinationRef = Extract<NewsletterSignupPublicDestinationRef, {
+type MailingListSignupBlockSourceRef = Extract<MailingListSignupSourceRef, {
     tag: 'block_ref';
 }>;
-type NewsletterSignupSignedDestinationRef = Extract<NewsletterSignupPublicDestinationRef, {
-    tag: 'signed_destination_ref';
+type MailingListSignupSignedSourceRef = Extract<MailingListSignupSourceRef, {
+    tag: 'signed_source_ref';
 }>;
 type NewsletterIslandMeta = Readonly<{
     siteId?: string;
@@ -45,18 +48,22 @@ export declare const newsletterFormBlockRuntime: Readonly<{
     buildRender: (source: NewsletterFormProps) => Readonly<{
         display: Readonly<{
             kind: "newsletter-form";
+            availability: "ready" | "unavailable";
             className: string | null;
             buttonLabel: string;
             buttonVariant: NewsletterButtonVariant;
-            successMessage: string | null;
             privacyNote: string | null;
             fields: readonly NewsletterFieldDef[];
+            choices: readonly Readonly<{
+                id: string;
+                label: string;
+            }>[];
         }>;
         hydration: Readonly<{
             target: NewsletterFormHydrationTarget;
-            preset: NewsletterPreset;
-            includePhone: boolean;
-            tags?: string | null;
+            setupRevision: number | null;
+            choiceProvider: "native" | "brevo" | "mailchimp" | null;
+            choicePresentation: "hidden" | "automatic" | "visitor_choice";
             spamProtectionEnabled?: boolean;
         }>;
     }>;
@@ -69,36 +76,44 @@ export declare const newsletterFormBlockRuntime: Readonly<{
             encode: (value: Readonly<{
                 display: Readonly<{
                     kind: "newsletter-form";
+                    availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
                     buttonVariant: NewsletterButtonVariant;
-                    successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly NewsletterFieldDef[];
+                    choices: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
                 }>;
                 hydration: Readonly<{
                     target: NewsletterFormHydrationTarget;
-                    preset: NewsletterPreset;
-                    includePhone: boolean;
-                    tags?: string | null;
+                    setupRevision: number | null;
+                    choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                    choicePresentation: "hidden" | "automatic" | "visitor_choice";
                     spamProtectionEnabled?: boolean;
                 }>;
             }>) => unknown;
             decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                 display: Readonly<{
                     kind: "newsletter-form";
+                    availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
                     buttonVariant: NewsletterButtonVariant;
-                    successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly NewsletterFieldDef[];
+                    choices: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
                 }>;
                 hydration: Readonly<{
                     target: NewsletterFormHydrationTarget;
-                    preset: NewsletterPreset;
-                    includePhone: boolean;
-                    tags?: string | null;
+                    setupRevision: number | null;
+                    choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                    choicePresentation: "hidden" | "automatic" | "visitor_choice";
                     spamProtectionEnabled?: boolean;
                 }>;
             }>>;
@@ -117,18 +132,22 @@ export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
         } & Readonly<{
             display: Readonly<{
                 kind: "newsletter-form";
+                availability: "ready" | "unavailable";
                 className: string | null;
                 buttonLabel: string;
                 buttonVariant: NewsletterButtonVariant;
-                successMessage: string | null;
                 privacyNote: string | null;
                 fields: readonly NewsletterFieldDef[];
+                choices: readonly Readonly<{
+                    id: string;
+                    label: string;
+                }>[];
             }>;
             hydration: Readonly<{
                 target: NewsletterFormHydrationTarget;
-                preset: NewsletterPreset;
-                includePhone: boolean;
-                tags?: string | null;
+                setupRevision: number | null;
+                choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                choicePresentation: "hidden" | "automatic" | "visitor_choice";
                 spamProtectionEnabled?: boolean;
             }>;
         }>>;
@@ -143,18 +162,22 @@ export declare const newsletterFormInteractiveIslandPropsCodec: Readonly<{
         } & Readonly<{
             display: Readonly<{
                 kind: "newsletter-form";
+                availability: "ready" | "unavailable";
                 className: string | null;
                 buttonLabel: string;
                 buttonVariant: NewsletterButtonVariant;
-                successMessage: string | null;
                 privacyNote: string | null;
                 fields: readonly NewsletterFieldDef[];
+                choices: readonly Readonly<{
+                    id: string;
+                    label: string;
+                }>[];
             }>;
             hydration: Readonly<{
                 target: NewsletterFormHydrationTarget;
-                preset: NewsletterPreset;
-                includePhone: boolean;
-                tags?: string | null;
+                setupRevision: number | null;
+                choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                choicePresentation: "hidden" | "automatic" | "visitor_choice";
                 spamProtectionEnabled?: boolean;
             }>;
         }>>;

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

@@ -1,4 +1,4 @@
-import type { NewsletterSubscribeTarget } from '../api/types';
+import { type MailingListSignupSourceRef } from '../../../../../core/src/index';
 import type { NewsletterFormHydrationTarget } from './newsletter-form.interactive';
 export type NewsletterFormRawSubmissionFields = Readonly<{
     email: FormDataEntryValue | null;
@@ -20,10 +20,10 @@ export type NewsletterFormSubmissionFields = Readonly<{
 }>;
 export type NewsletterSubmitTargetResolution = Readonly<{
     tag: 'ready';
-    target: NewsletterSubscribeTarget;
+    sourceRef: MailingListSignupSourceRef;
 }> | Readonly<{
     tag: 'unavailable';
-    reason: 'missing_block_source' | 'missing_legacy_list';
+    reason: 'missing_block_source';
 }>;
 export declare function mapNewsletterFormFieldsToSubscriberInput(fields: NewsletterFormRawSubmissionFields): NewsletterFormSubmissionFields;
 export declare function resolveNewsletterSubmitTarget(input: NewsletterFormHydrationTarget): NewsletterSubmitTargetResolution;

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

@@ -3,9 +3,9 @@
  *
  * Shared types for the newsletter form server and client components.
  */
-import type { NewsletterSignupDestinationProvider, NewsletterSignupFieldPreset, NewsletterSignupPublicDestinationRef } from '../../blocks/newsletter-signup-destination';
+import type { MailingListGlobalForm, MailingListPlacementTargeting, MailingListRuntimeContext, MailingListSignupSourceRef } from '../../../../../core/src/index';
 import type { BlockButtonRole } from '../../constants/buttonRoles';
-export type NewsletterPreset = NewsletterSignupFieldPreset;
+export type NewsletterPreset = MailingListGlobalForm['fields']['preset'];
 export type NewsletterFieldDef = {
     id: string;
     type: 'email' | 'text';
@@ -13,27 +13,18 @@ export type NewsletterFieldDef = {
     required: boolean;
     placeholder?: string;
 };
-export type NewsletterDestinationProvider = 'riverbank' | 'mailchimp';
 export type NewsletterButtonVariant = BlockButtonRole;
 type NewsletterFormCommonProps = {
     /** Site ID for API calls */
     siteId?: string;
     /** API base URL for client-side fetching */
     apiBaseUrl?: string;
-    /** Field preset configuration */
-    preset?: NewsletterPreset;
-    /** Adds an optional phone field to the selected preset */
-    includePhone?: boolean;
-    /** Submit button label */
-    buttonLabel?: string | null;
+    /** Site-owned fields/copy and safe provider choice labels. */
+    mailingList?: MailingListRuntimeContext;
+    /** The only placement-owned mailing-list behaviour. */
+    targeting?: MailingListPlacementTargeting;
     /** Site-style button role for the submit action */
     buttonVariant?: NewsletterButtonVariant | null;
-    /** Message shown after successful subscription */
-    successMessage?: string | null;
-    /** Optional privacy note below the form */
-    privacyNote?: string | null;
-    /** Optional tags (comma/semicolon separated) applied on subscribe */
-    tags?: string | null;
     /** Enable spam protection (ALTCHA) */
     spamProtectionEnabled?: boolean;
     /** Additional CSS class */
@@ -42,31 +33,22 @@ type NewsletterFormCommonProps = {
 type BlockNewsletterFormSource = Readonly<{
     source: 'block';
     blockId?: string | null;
-    destinationProvider?: NewsletterSignupDestinationProvider | null;
-    /** Authoring state only; public submission authority is always blockId. */
-    listId?: string | null;
 }>;
 type SignedFooterNewsletterFormSource = Readonly<{
     source: 'signed-footer';
-    destinationRef: Extract<NewsletterSignupPublicDestinationRef, {
-        tag: 'signed_destination_ref';
+    sourceRef: Extract<MailingListSignupSourceRef, {
+        tag: 'signed_source_ref';
     }>;
     blockId?: never;
-    destinationProvider?: never;
-    listId?: never;
 }>;
-type LegacyDirectListNewsletterFormSource = Readonly<{
-    source: 'legacy-direct-list';
-    listId: string | null;
+type PreviewNewsletterFormSource = Readonly<{
+    source: 'preview';
     blockId?: never;
-    destinationRef?: never;
-    destinationProvider?: never;
+    sourceRef?: never;
 }>;
-export type NewsletterFormProps = NewsletterFormCommonProps & (BlockNewsletterFormSource | SignedFooterNewsletterFormSource | LegacyDirectListNewsletterFormSource);
+export type NewsletterFormProps = NewsletterFormCommonProps & (BlockNewsletterFormSource | SignedFooterNewsletterFormSource | PreviewNewsletterFormSource);
 /**
  * Get form fields based on preset configuration.
  */
-export declare function getPresetFields(preset: NewsletterPreset, options?: {
-    includePhone?: boolean;
-}): NewsletterFieldDef[];
+export declare function getGlobalFormFields(form: MailingListGlobalForm): NewsletterFieldDef[];
 export {};

package/dist/_dts/blocks/src/system/runtime/nodes/offerings-preview-catalogue.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { ButtonVariant, PublicEvent } from '../../blocks/events/shared/types';
+import { type BookingOfferingPresetSummary } from '../../blocks/offerings-preview/model';
+export type OfferingsCatalogueProps = Readonly<{
+    children?: React.ReactNode;
+    bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
+    catalogueEvents?: readonly PublicEvent[] | null;
+    quickDateEvents?: readonly PublicEvent[] | null;
+    pathname?: string;
+    buttonVariant?: ButtonVariant | null;
+    emptyMessage?: string | null;
+    failedMessage?: string | null;
+}>;
+export declare function OfferingsCatalogue(props: OfferingsCatalogueProps): React.ReactNode;

package/dist/_dts/blocks/src/system/runtime/nodes/offerings-preview-content.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { ButtonVariant } from '../../blocks/events/shared/types';
+import { type OfferingsPreviewGroupPresentation, type OfferingsPreviewGroupRenderState, type OfferingsPreviewItem, type OfferingsPreviewRouteCandidate } from '../../blocks/offerings-preview/model';
+export type OfferingsPreviewGroupFrame = Readonly<{
+    containerClassName: string;
+    containerStyle?: React.CSSProperties;
+    contentClassName: string;
+}>;
+type OfferingsPreviewContentProps = Readonly<{
+    now: Date;
+    states: readonly OfferingsPreviewGroupRenderState[];
+    buttonVariant: ButtonVariant;
+    buttonText: string;
+    routeCandidates: readonly OfferingsPreviewRouteCandidate[];
+    groupFrame: OfferingsPreviewGroupFrame;
+    renderGroupItems: (presentation: OfferingsPreviewGroupPresentation, items: readonly OfferingsPreviewItem[], options: Readonly<{
+        buttonVariant: ButtonVariant;
+        buttonText: string;
+        now: Date;
+    }>) => React.ReactNode;
+}>;
+export declare function OfferingsPreviewContent(props: OfferingsPreviewContentProps): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/nodes/offerings-preview.d.ts

@@ -1,9 +1,11 @@
 import React from 'react';
+import { type OfferingsCatalogueProps } from './offerings-preview-catalogue';
 import type { ButtonVariant, PublicEvent } from '../../blocks/events/shared/types';
 import type { CardStylesContent } from '../../fields/boxStyles';
 import { type BookingOfferingPresetSummary, type OfferingsPreviewEventDataKey, type OfferingsPreviewGroupOrder, type OfferingsPreviewGroupOverride, type OfferingsPreviewRouteCandidate } from '../../blocks/offerings-preview/model';
-type OfferingsPreviewProps = Readonly<{
+type OfferingsPreviewProps = OfferingsCatalogueProps & Readonly<{
     now?: Date;
+    displayMode?: 'preview' | 'catalogue';
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[] | null;
     groupOrder?: OfferingsPreviewGroupOrder | null;
     groupOverrides?: readonly OfferingsPreviewGroupOverride[] | null;
@@ -19,5 +21,5 @@ type OfferingsPreviewProps = Readonly<{
     }> | null;
     wholeSeriesRunEvents?: readonly PublicEvent[] | null;
 }> & Partial<Record<OfferingsPreviewEventDataKey, readonly PublicEvent[] | null>>;
-export declare function OfferingsPreviewNode(props: OfferingsPreviewProps): React.JSX.Element | null;
+export declare function OfferingsPreviewNode(props: OfferingsPreviewProps): React.JSX.Element;
 export default OfferingsPreviewNode;

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

@@ -6,6 +6,7 @@ export declare const fallbackTransform: TransformDefinition<{
 }>;
 export declare const dateFormatShort: TransformDefinition;
 export declare const arrayLengthTransform: TransformDefinition;
+export declare const booleanNotTransform: TransformDefinition;
 export declare const jsonArrayTransform: TransformDefinition;
 export declare const csvTransform: TransformDefinition;
 declare const marqueeLoopOptionsSchema: z.ZodObject<{
@@ -26,5 +27,9 @@ declare const mapTokenOptionsSchema: z.ZodObject<{
  * fallback is given, so the style property is simply omitted.
  */
 export declare const mapTokenTransform: TransformDefinition<z.infer<typeof mapTokenOptionsSchema>>;
+/** Compare a finite content value without storing derived loader flags. */
+export declare const equalsTransform: TransformDefinition<{
+    value: string;
+}>;
 export declare const formattingTransforms: TransformDefinition[];
 export {};

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

@@ -56,3 +56,4 @@ export * from './stripeMinimumCharge';
 export * from './stripeCheckoutReturnUrl';
 export * from './stateTransitions';
 export * from './event-registration-errors';
+export { STRIPE_COMMISSION_FREE_REASONS, type StripeCommissionFreeReason } from './stripeCommissionMetadata';

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

@@ -1,16 +1,11 @@
+import { type StripeBookingCommissionOrderItemMetadata } from './stripeCommissionMetadata';
+export { parseStripeBookingCommissionMetadata, type StripeBookingCommissionOrderItemMetadata } from './stripeCommissionMetadata';
 import { type BrandedIdParseError, type CheckoutLineId, type RetiredCourseId, type CustomerId, type DatedOfferingCapacityHoldAuditRef, type DatedOfferingCapacityHoldId, type EventSeriesId, type EventInstanceId, type OccurrenceId, type PassId, type PricingOptionId, type Result } from '../../../core/src/index';
 import type { OrderItemKind } from './orderTypes';
 export type CheckoutLineMetadata = Readonly<{
     checkoutLineId?: CheckoutLineId;
     displayName?: string;
 }>;
-export type StripeBookingCommissionOrderItemMetadata = Readonly<{
-    stripeBookingCommission?: Readonly<{
-        kind: 'application_fee_amount';
-        amountCents: number;
-        percent: number;
-    }>;
-}>;
 export type SlidingScaleOrderItemPricingSnapshot = Readonly<{
     kind: 'sliding_scale';
     version: 1;
@@ -87,7 +82,7 @@ export type EventTicketOrderItemMetadata = CheckoutLineMetadata & StripeBookingC
     attendeeEmail: string;
     attendeeName: string;
 }>;
-export type ProductOrderItemMetadata = CheckoutLineMetadata & Readonly<{
+export type ProductOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & Readonly<{
     productType?: 'physical' | 'digital';
     requiresShipping?: boolean;
 }>;
@@ -101,7 +96,7 @@ export type PassBundleFulfillmentMetadata = Readonly<{
 }>;
 export type CreditProductUseCase = 'event_pass' | 'appointment_package';
 export declare function normalizeOrderCreditProductUseCase(value: unknown): Result<CreditProductUseCase, string>;
-export type PassOrderItemMetadata = CheckoutLineMetadata & Readonly<{
+export type PassOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & Readonly<{
     passId: PassId;
     productUseCase?: CreditProductUseCase;
     creditsTotal: number;
@@ -131,7 +126,7 @@ export type MembershipBundleFulfillmentMetadata = Readonly<{
     attendeeName: string;
     membershipName: string;
 }>;
-export type MembershipOrderItemMetadata = CheckoutLineMetadata & Readonly<{
+export type MembershipOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & Readonly<{
     bundleFulfillment?: MembershipBundleFulfillmentMetadata;
 }>;
 export type OrderItemMetadataByKind = {
@@ -143,7 +138,6 @@ export type OrderItemMetadataByKind = {
     membership: MembershipOrderItemMetadata;
 };
 export type OrderItemMetadata = OrderItemMetadataByKind[OrderItemKind];
-export declare function parseStripeBookingCommissionMetadata(raw: Record<string, unknown>): Result<StripeBookingCommissionOrderItemMetadata, string>;
 export declare function parseBookableOrderItemPricingMetadata(raw: Record<string, unknown>): Result<BookableOrderItemPricingMetadata, string>;
 export declare function parseOrderItemMetadata(kind: 'event_ticket', raw: unknown): Result<EventTicketOrderItemMetadata, string>;
 export declare function parseOrderItemMetadata(kind: 'product', raw: unknown): Result<ProductOrderItemMetadata, string>;
@@ -151,4 +145,3 @@ export declare function parseOrderItemMetadata(kind: 'pass', raw: unknown): Resu
 export declare function parseOrderItemMetadata(kind: 'event_series_registration', raw: unknown): Result<EventSeriesRegistrationOrderItemMetadata, string>;
 export declare function parseOrderItemMetadata(kind: 'appointment', raw: unknown): Result<AppointmentOrderItemMetadata, string>;
 export declare function parseOrderItemMetadata(kind: 'membership', raw: unknown): Result<MembershipOrderItemMetadata, string>;
-export {};

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

@@ -0,0 +1,34 @@
+import { type Result } from '../../../core/src/index';
+import { z } from 'zod';
+/** Reasons are payment evidence, not an independent pricing policy. */
+export declare const STRIPE_COMMISSION_FREE_REASONS: readonly ["managed_billing", "no_commission_plan", "billing_evidence_invalid", "fee_rounds_to_zero", "non_commissionable_scope", "payment_not_stripe"];
+export type StripeCommissionFreeReason = (typeof STRIPE_COMMISSION_FREE_REASONS)[number];
+declare const commissionEvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    currency: z.ZodOptional<z.ZodString>;
+    sourcePlanId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"commission_free">;
+    reason: z.ZodEnum<{
+        managed_billing: "managed_billing";
+        no_commission_plan: "no_commission_plan";
+        billing_evidence_invalid: "billing_evidence_invalid";
+        fee_rounds_to_zero: "fee_rounds_to_zero";
+        non_commissionable_scope: "non_commissionable_scope";
+        payment_not_stripe: "payment_not_stripe";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    currency: z.ZodOptional<z.ZodString>;
+    sourcePlanId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"application_fee_amount">;
+    amountCents: z.ZodNumber;
+    percent: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    currency: z.ZodOptional<z.ZodString>;
+    sourcePlanId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"application_fee_percent">;
+    percent: z.ZodNumber;
+}, z.core.$strip>], "kind">;
+export type StripeBookingCommissionOrderItemMetadata = Readonly<{
+    stripeBookingCommission?: z.infer<typeof commissionEvidenceSchema>;
+}>;
+export declare function parseStripeBookingCommissionMetadata(raw: Record<string, unknown>): Result<StripeBookingCommissionOrderItemMetadata, string>;
+export {};

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

@@ -1,26 +1,15 @@
-import { type FooterEngagementSection, type Result } from '../../core/src/index';
+import { type FooterEngagementSection, type MailingListPlacementTargeting, type Result } from '../../core/src/index';
 type FooterEngagementDraftBase = Readonly<{
     treatment: FooterEngagementSection['treatment'];
     heading: string;
     intro: string;
 }>;
-type FooterMailingCopyDraft = Readonly<{
-    buttonLabel: string;
-    successMessage: string;
-    privacyNote: string;
-}>;
 export type FooterEngagementDraft = (FooterEngagementDraftBase & Readonly<{
     kind: 'standard-contact';
     formId: string;
-}>) | (FooterEngagementDraftBase & FooterMailingCopyDraft & Readonly<{
+}>) | (FooterEngagementDraftBase & Readonly<{
     kind: 'mailing-list';
-    destination: Readonly<{
-        provider: 'riverbank';
-        listId: string;
-    }> | Readonly<{
-        provider: 'mailchimp';
-        audienceId: string;
-    }>;
+    targeting: MailingListPlacementTargeting;
 }>);
 export type FooterEngagementDraftEvent = Readonly<{
     type: 'select-kind';
@@ -38,20 +27,13 @@ export type FooterEngagementDraftEvent = Readonly<{
     type: 'set-form';
     formId: string;
 }> | Readonly<{
-    type: 'select-mailing-provider';
-    provider: 'riverbank' | 'mailchimp';
-}> | Readonly<{
-    type: 'set-mailing-destination';
-    id: string;
-}> | Readonly<{
-    type: 'set-mailing-copy';
-    field: keyof FooterMailingCopyDraft;
-    value: string;
+    type: 'set-mailing-targeting';
+    targeting: MailingListPlacementTargeting;
 }>;
 export declare function reduceFooterEngagementDraft(draft: FooterEngagementDraft, event: FooterEngagementDraftEvent): FooterEngagementDraft;
 export declare function createFooterEngagementDraft(section: FooterEngagementSection | null): FooterEngagementDraft;
 type DraftParseError = Readonly<{
     message: string;
 }>;
-export declare function parseFooterEngagementDraft(draft: FooterEngagementDraft, currentId: string, mailchimpConnectionId: string): Result<FooterEngagementSection, DraftParseError>;
+export declare function parseFooterEngagementDraft(draft: FooterEngagementDraft, currentId: string): Result<FooterEngagementSection, DraftParseError>;
 export {};

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

@@ -32,8 +32,7 @@ export declare function useFooterComposerState({ apiClient, canEdit, initialTarg
     compositionSnapshot: FooterCompositionSnapshot | null;
     engagementOptions: Readonly<{
         forms: readonly import("../../api/src/footerSettings").FooterFormSummary[];
-        newsletterLists: readonly import("../../api/src/index").NewsletterListRecord[];
-        mailchimp: import("../../api/src/index").ListMailchimpAudiencesResponse;
+        mailingList: import("../../core/src/index").MailingListRuntimeContext;
     }> | null;
     load: () => Promise<void>;
     loadError: string | null;

package/dist/_dts/core/src/footer-engagement.d.ts

@@ -1,5 +1,5 @@
 import { type FormId } from './branded';
-import { type NewsletterSignupAuthoringDestination } from './newsletter-signup-destination';
+import type { MailingListPlacementTargeting } from './mailing-list-targeting';
 import { type Result } from './result';
 import type { FooterCompositionError, FooterModuleId } from './footer-composition-types';
 export type FooterEngagementTreatment = 'integrated' | 'separate-row';
@@ -9,12 +9,8 @@ export type FooterEngagementSource = Readonly<{
     intro: string | null;
 }> | Readonly<{
     kind: 'mailing-list';
-    destination: NewsletterSignupAuthoringDestination;
+    targeting: MailingListPlacementTargeting;
     intro: string | null;
-    buttonLabel: string;
-    successMessage: string;
-    privacyNote: string | null;
-    fieldPreset: 'emailOnly';
 }>;
 export type FooterEngagementSection = Readonly<{
     id: FooterModuleId;

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

@@ -41,7 +41,13 @@ export * from './footer-navigation-layout';
 export * from './footer-arrangement';
 export * from './footer-composition-types';
 export * from './footer-engagement';
-export * from './newsletter-signup-destination';
+export * from './mailing-list-identifiers';
+export * from './mailing-list-setup';
+export * from './mailing-list-setup-parser';
+export * from './mailing-list-targeting';
+export * from './mailing-list-runtime';
+export * from './mailing-list-targeting-parser';
+export * from './mailing-list-submission';
 export * from './number-input';
 export * from './field-errors';
 export * from './form-submission-preview';
@@ -63,5 +69,7 @@ export { disabledSelection, enabledSelection, plannerNoChange, plannerPatch, pla
 export type { DisabledSelection, EnabledSelection, OptionalSelection, PlannerNoChange, PlannerPatch, PlannerUpdate, PlanningClock, PlanningDateInput, PlanningTimeOptions, } from './planner';
 export { isValidBookingTimeZone, parseBookingTimeZone, type BookingTimeZone, type BookingTimeZoneParseError, } from './booking-time-zone';
 export { CANCELLED_SESSION_STATUS, firstLiveRunSessionStartMs, isWholeSeriesRegistrationOpen, orderedLiveRunSessions, resolveWholeSeriesBookingPhase, resolveWholeSeriesRunLifecycle, type WholeSeriesBookingPhase, type WholeSeriesRunLifecycle, type WholeSeriesScheduleSession, } from './whole-series-run-schedule';
+export * from './public-read-cache-contract';
 export * from './booking-verticals';
 export * from './event-series-behaviour';
+export * from './navigation-locations';