@riverbankcms/sdk 0.138.0 → 0.140.0

package/dist/_dts/blocks/src/contracts/proof-block-islands.d.ts

@@ -188,7 +188,9 @@ export declare const proofBlockIslandCodecs: {
                 mode: "event-registration";
             } & Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                    eventSource: import("../system/runtime/nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
+                }>;
             }>>;
         }>) => unknown;
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
@@ -203,7 +205,9 @@ export declare const proofBlockIslandCodecs: {
                 mode: "event-registration";
             } & Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                    eventSource: import("../system/runtime/nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
+                }>;
             }>>;
         }>>;
     }>;
@@ -418,18 +422,23 @@ export declare const proofBlockIslandCodecs: {
             } & Readonly<{
                 display: Readonly<{
                     kind: "newsletter-form";
+                    availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
+                    successMessage: string;
                     buttonVariant: import("../system/runtime/nodes/newsletter-form.types").NewsletterButtonVariant;
-                    successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../system/runtime/nodes/newsletter-form.types").NewsletterFieldDef[];
+                    choices: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
                 }>;
                 hydration: Readonly<{
                     target: import("../system/runtime/nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                    preset: import("../system/runtime/nodes/newsletter-form.types").NewsletterPreset;
-                    includePhone: boolean;
-                    tags?: string | null;
+                    setupRevision: number | null;
+                    choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                    choicePresentation: "hidden" | "automatic" | "visitor_choice";
                     spamProtectionEnabled?: boolean;
                 }>;
             }>>;
@@ -444,18 +453,23 @@ export declare const proofBlockIslandCodecs: {
             } & Readonly<{
                 display: Readonly<{
                     kind: "newsletter-form";
+                    availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
+                    successMessage: string;
                     buttonVariant: import("../system/runtime/nodes/newsletter-form.types").NewsletterButtonVariant;
-                    successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../system/runtime/nodes/newsletter-form.types").NewsletterFieldDef[];
+                    choices: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
                 }>;
                 hydration: Readonly<{
                     target: import("../system/runtime/nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                    preset: import("../system/runtime/nodes/newsletter-form.types").NewsletterPreset;
-                    includePhone: boolean;
-                    tags?: string | null;
+                    setupRevision: number | null;
+                    choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                    choicePresentation: "hidden" | "automatic" | "visitor_choice";
                     spamProtectionEnabled?: boolean;
                 }>;
             }>>;
@@ -1110,7 +1124,9 @@ export declare const runtimeIslandCodecs: {
                 mode: "event-registration";
             } & Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                    eventSource: import("../system/runtime/nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
+                }>;
             }>>;
         }>) => unknown;
         decode: (input: unknown) => import("./runtime").DecodeResult<Readonly<Readonly<{
@@ -1125,7 +1141,9 @@ export declare const runtimeIslandCodecs: {
                 mode: "event-registration";
             } & Readonly<{
                 display: EventRegistrationDisplay;
-                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText">>;
+                hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "events" | "buttonText"> & {
+                    eventSource: import("../system/runtime/nodes/event-registration/eventSourceRecovery").EventRegistrationEventSource;
+                }>;
             }>>;
         }>>;
     }>;
@@ -1340,18 +1358,23 @@ export declare const runtimeIslandCodecs: {
             } & Readonly<{
                 display: Readonly<{
                     kind: "newsletter-form";
+                    availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
+                    successMessage: string;
                     buttonVariant: import("../system/runtime/nodes/newsletter-form.types").NewsletterButtonVariant;
-                    successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../system/runtime/nodes/newsletter-form.types").NewsletterFieldDef[];
+                    choices: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
                 }>;
                 hydration: Readonly<{
                     target: import("../system/runtime/nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                    preset: import("../system/runtime/nodes/newsletter-form.types").NewsletterPreset;
-                    includePhone: boolean;
-                    tags?: string | null;
+                    setupRevision: number | null;
+                    choiceProvider: "native" | "brevo" | "mailchimp" | null;
+                    choicePresentation: "hidden" | "automatic" | "visitor_choice";
                     spamProtectionEnabled?: boolean;
                 }>;
             }>>;
@@ -1366,18 +1389,23 @@ export declare const runtimeIslandCodecs: {
             } & Readonly<{
                 display: Readonly<{
                     kind: "newsletter-form";
+                    availability: "ready" | "unavailable";
                     className: string | null;
                     buttonLabel: string;
+                    successMessage: string;
                     buttonVariant: import("../system/runtime/nodes/newsletter-form.types").NewsletterButtonVariant;
-                    successMessage: string | null;
                     privacyNote: string | null;
                     fields: readonly import("../system/runtime/nodes/newsletter-form.types").NewsletterFieldDef[];
+                    choices: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
                 }>;
                 hydration: Readonly<{
                     target: import("../system/runtime/nodes/newsletter-form.interactive").NewsletterFormHydrationTarget;
-                    preset: import("../system/runtime/nodes/newsletter-form.types").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/pageRenderAdmission.d.ts

@@ -11,6 +11,7 @@ export type RenderablePageBlock = Readonly<{
     kind: Block['kind'];
     purpose: Block['purpose'];
     bindings?: Block['bindings'];
+    contentVersionId?: string | null;
     admission: Readonly<{
         kind: 'renderable';
         content: RenderableManifestContent;
@@ -32,6 +33,7 @@ export type PresentationAdmission = Readonly<{
 }>;
 export type PresentationBlock = Block & Readonly<{
     presentationAdmission: PresentationAdmission;
+    contentVersionId?: string | null;
 }>;
 export type PresentationPageOutline = Omit<PageOutline, 'blocks'> & Readonly<{
     blocks: readonly PresentationBlock[];

package/dist/_dts/blocks/src/pageRendererContracts.d.ts

@@ -5,6 +5,7 @@ import type { SdkCustomBlock } from './system/manifest/schema';
 import type { MediaAssetIndexItem, ResolveImageUrlContext, ResolveImageUrlContextInput } from './system/runtime/nodes/media';
 import type { RouteMap } from './system/transforms';
 import type { BookingOfferingPresetSummary } from './system/blocks/offerings-preview/model';
+import type { BlockLoaderFailures } from './system/data/types';
 /**
  * Occurrence context for event pages.
  * Passed through to blocks that need occurrence information (e.g., event-registration).
@@ -71,6 +72,8 @@ export type BlockOverrideProps<TContent = Record<string, unknown>> = {
     imageResolveContext?: ResolveImageUrlContext;
     /** Block instance ID (null for unsaved blocks) */
     blockId: string | null;
+    /** Exact content snapshot rendered for this block. */
+    contentVersionId?: string | null;
     /** Block kind identifier (e.g., "block.hero" or "custom.my-block") */
     blockKind: string;
 };
@@ -131,7 +134,11 @@ export type SdkConfigForRenderer = {
 export type PageRendererDataContext = {
     siteId?: string;
     pageId?: string;
+    /** Canonical request pathname used by blocks when resolving same-site destinations. */
+    pathname?: string;
     resolvedData?: Record<string, Record<string, unknown>>;
+    /** Failed server loader requests, kept separate from successful data. */
+    loaderFailures?: BlockLoaderFailures;
     previewStage?: 'published' | 'preview';
     previewToken?: string | null;
     routes?: RouteMap;
@@ -149,6 +156,8 @@ export type PageRendererDataContext = {
     apiBaseUrl?: string;
     portalToken?: string | null;
     bookingOfferingPresets?: readonly BookingOfferingPresetSummary[];
+    mailingList?: import('../../core/src/index').MailingListRuntimeContext;
     bookingTimeZone?: string;
     eventRegistrationOverlayEnabled?: boolean;
 };
+export declare function buildPageRendererRootRuntime(dataContext: PageRendererDataContext | undefined): Readonly<Record<string, unknown>>;

package/dist/_dts/blocks/src/pageRenderingMode.d.ts

@@ -8,24 +8,31 @@ export declare class MissingBlockOverrideError extends Error {
 export type PageThemeResources = Readonly<{
     kind: 'available';
     tokens: ThemeTokens;
-    config: Theme;
+    config?: Theme;
 }> | Readonly<{
     kind: 'unavailable';
 }>;
-type ThemedResourceInput = Readonly<{
+export type ThemedRenderMode = Readonly<{
     rendering?: never;
     theme: Theme;
     themeTokens?: ThemeTokens;
 }>;
-type OverrideOnlyResourceInput = Readonly<{
+export type TokensOnlyRenderMode = Readonly<{
+    rendering: {
+        kind: 'tokens-only';
+    };
+    theme?: never;
+    themeTokens: ThemeTokens;
+}>;
+export type OverrideOnlyRenderMode = Readonly<{
     rendering: {
         kind: 'overrides-only';
     };
     theme?: never;
     themeTokens?: never;
 }>;
-type ThemeResourceInput = ThemedResourceInput | OverrideOnlyResourceInput;
-export declare function resolvePageThemeResources(props: ThemeResourceInput): PageThemeResources;
+export type PublicRenderMode = ThemedRenderMode | TokensOnlyRenderMode | OverrideOnlyRenderMode;
+export declare function resolvePageThemeResources(props: PublicRenderMode): PageThemeResources;
 export declare function requireBlockOverride(resources: PageThemeResources, override: unknown, blockKind: string): void;
 export declare function overrideThemeProps(resources: PageThemeResources): Readonly<{
     theme?: ThemeTokens;
@@ -34,4 +41,3 @@ export declare function overrideThemeProps(resources: PageThemeResources): Reado
 export declare function requireThemeResources(resources: PageThemeResources, blockKind: string): Extract<PageThemeResources, {
     kind: 'available';
 }>;
-export {};

package/dist/_dts/blocks/src/portal/types.d.ts

@@ -111,10 +111,8 @@ export interface CustomerEventRegistration {
     ticketingEnabled: boolean;
     ticketUrl?: string;
 }
-/**
- * Guest details for event registration
- */
-export interface EventGuest {
+export type { CustomerPortalWaitlistEntry, CustomerPortalWaitlistSubject } from './waitlist-types';
+/** Guest details for event registration. */ export interface EventGuest {
     id: string;
     name: string;
     phone: string | null;

package/dist/_dts/blocks/src/portal/waitlist-types.d.ts

@@ -0,0 +1,35 @@
+export type CustomerPortalWaitlistSubject = {
+    kind: 'occurrence';
+    occurrenceId: string;
+    eventSeriesId: string;
+    startsAt: string;
+    endsAt: string;
+    timeZone: string;
+} | {
+    kind: 'wholeSeries';
+    eventSeriesId: string;
+    scheduleSummary: string | null;
+};
+type CustomerPortalWaitlistEntryBase = {
+    id: string;
+    subject: CustomerPortalWaitlistSubject;
+    eventTitle: string;
+    eventPath: string | null;
+    requestedPlaces: number;
+    joinedAt: string;
+};
+export type CustomerPortalWaitlistEntry = (CustomerPortalWaitlistEntryBase & {
+    status: 'waiting';
+    queuePosition: number | null;
+    canLeave: true;
+}) | (CustomerPortalWaitlistEntryBase & {
+    status: 'placeAvailable';
+    claimExpiresAt: string;
+    claimPath: string | null;
+    canLeave: true;
+}) | (CustomerPortalWaitlistEntryBase & {
+    status: 'offerExpired';
+    claimExpiredAt: string;
+    canLeave: false;
+});
+export {};

package/dist/_dts/blocks/src/system/blocks/appointment-services.d.ts

@@ -0,0 +1,11 @@
+import type { SystemBlockDefinition } from '../registry';
+import { type SectionStylesContent } from '../fields/boxStyles';
+import type { BlockManifest } from '../manifest';
+declare const appointmentServicesManifest: BlockManifest;
+export type AppointmentServicesContent = Readonly<{
+    heading?: string | null;
+    description?: unknown;
+    _sectionStyles?: SectionStylesContent;
+}>;
+export declare const appointmentServicesBlockDefinition: SystemBlockDefinition<AppointmentServicesContent>;
+export { appointmentServicesManifest };

package/dist/_dts/blocks/src/system/blocks/contact-newsletter.d.ts

@@ -1,7 +1,7 @@
 import type { SystemBlockDefinition } from "../registry";
 import type { SectionStylesContent } from "../fields/boxStyles";
 import { type RichTextDoc } from "./form";
-import type { NewsletterSignupPreset } from "./newsletter-signup";
+import type { MailingListPlacementTargeting } from '../../../../core/src/index';
 export declare const contactNewsletterManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
     readonly id: "block.contact-newsletter";
     readonly title: "Contact + Newsletter";
@@ -33,81 +33,58 @@ export declare const contactNewsletterManifest: import("..").DefinedBlockManifes
         readonly type: "richText";
         readonly label: "Newsletter intro";
     }, {
-        readonly id: "listId";
-        readonly type: "reference";
-        readonly label: "Newsletter list";
-        readonly description: "Select the list new subscribers should be added to.";
+        readonly id: "targeting";
+        readonly type: "group";
+        readonly label: "Mailing-list targeting";
+        readonly description: "Choose what kind of emails people signing up here will receive.";
         readonly required: true;
-        readonly referenceKind: "newsletterList";
-        readonly allowManualEntry: false;
+        readonly defaultValue: {
+            readonly mode: "default";
+        };
         readonly ui: {
             readonly intent: "behavior";
+            readonly widget: "mailingListTargeting";
         };
-    }, {
-        readonly id: "preset";
-        readonly type: "select";
-        readonly label: "Newsletter fields";
-        readonly defaultValue: "emailOnly";
-        readonly ui: {
-            readonly intent: "display";
+        readonly schema: {
+            readonly fields: [{
+                readonly id: "mode";
+                readonly type: "select";
+                readonly label: "Mode";
+                readonly required: true;
+                readonly defaultValue: "default";
+                readonly options: [{
+                    readonly value: "default";
+                    readonly label: "Default";
+                }, {
+                    readonly value: "custom";
+                    readonly label: "Custom";
+                }];
+                readonly ui: {
+                    readonly hidden: true;
+                };
+            }];
         };
-        readonly options: [{
-            readonly value: "emailOnly";
-            readonly label: "Email only";
-        }, {
-            readonly value: "emailName";
-            readonly label: "Email + Name";
-        }, {
-            readonly value: "emailFirstLast";
-            readonly label: "Email + First/Last Name";
-        }, {
-            readonly value: "emailNameCompany";
-            readonly label: "Email + Name + Company (B2B)";
-        }];
     }, {
-        readonly id: "includePhone";
-        readonly type: "boolean";
-        readonly label: "Include phone field";
-        readonly defaultValue: false;
-        readonly ui: {
-            readonly intent: "display";
-        };
-    }, {
-        readonly id: "newsletterButtonLabel";
+        readonly id: "contactTitle";
         readonly type: "text";
-        readonly label: "Newsletter button label";
-        readonly defaultValue: "Subscribe";
-        readonly ui: {
-            readonly intent: "display";
-        };
+        readonly label: "Contact title";
+        readonly defaultValue: "Get in touch";
     }, {
-        readonly id: "newsletterSuccessMessage";
+        readonly id: "mailingListSource";
         readonly type: "text";
-        readonly label: "Newsletter success message";
-        readonly defaultValue: "Thanks for subscribing!";
+        readonly label: "Mailing-list source";
         readonly ui: {
+            readonly hidden: true;
             readonly intent: "behavior";
         };
     }, {
-        readonly id: "newsletterPrivacyNote";
+        readonly id: "mailingListSourceToken";
         readonly type: "text";
-        readonly label: "Privacy note";
-        readonly ui: {
-            readonly intent: "display";
-        };
-    }, {
-        readonly id: "newsletterTags";
-        readonly type: "text";
-        readonly label: "Newsletter tags";
-        readonly description: "Optional tags to apply on subscribe, separated by comma or semicolon.";
+        readonly label: "Mailing-list source token";
         readonly ui: {
+            readonly hidden: true;
             readonly intent: "behavior";
         };
-    }, {
-        readonly id: "contactTitle";
-        readonly type: "text";
-        readonly label: "Contact title";
-        readonly defaultValue: "Get in touch";
     }, {
         readonly id: "contactIntro";
         readonly type: "richText";
@@ -157,13 +134,9 @@ export declare const contactNewsletterManifest: import("..").DefinedBlockManifes
 export type ContactNewsletterContent = {
     newsletterTitle?: string | null;
     newsletterSubtitle?: RichTextDoc | null;
-    listId?: string | null;
-    preset?: NewsletterSignupPreset;
-    includePhone?: boolean;
-    newsletterButtonLabel?: string | null;
-    newsletterSuccessMessage?: string | null;
-    newsletterPrivacyNote?: string | null;
-    newsletterTags?: string | null;
+    targeting: MailingListPlacementTargeting;
+    mailingListSource?: 'signed-footer' | null;
+    mailingListSourceToken?: string | null;
     contactTitle?: string | null;
     contactIntro?: RichTextDoc | null;
     formSlug: string;

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

@@ -158,6 +158,8 @@ export type EventRegistrationOptionsResponse = Readonly<{
         kind: 'none';
     }> | Readonly<{
         kind: 'booked';
+    }> | Readonly<{
+        kind: 'pending_payment';
     }> | Readonly<{
         kind: 'waitlisted';
     }>;

package/dist/_dts/blocks/src/system/blocks/events/shared/schemas.d.ts

@@ -1,5 +1,47 @@
 import { z } from 'zod';
 import type { PublicEventPricing, PublicEventPricingOption } from '../../../../../../core/src/index';
+export declare const publicEventLoaderQuerySchemaShape: {
+    readonly limit: z.ZodOptional<z.ZodString>;
+    readonly from: z.ZodOptional<z.ZodString>;
+    readonly to: z.ZodOptional<z.ZodString>;
+    readonly afterStartsAt: z.ZodOptional<z.ZodString>;
+    readonly afterId: z.ZodOptional<z.ZodString>;
+    readonly categoryIds: z.ZodOptional<z.ZodString>;
+    readonly venueId: z.ZodOptional<z.ZodString>;
+    readonly staffMemberId: z.ZodOptional<z.ZodString>;
+    readonly eventSurface: z.ZodOptional<z.ZodString>;
+    readonly eventPresets: z.ZodOptional<z.ZodString>;
+    readonly scheduleScope: z.ZodOptional<z.ZodString>;
+    readonly seriesId: z.ZodOptional<z.ZodString>;
+    readonly seriesIds: z.ZodOptional<z.ZodString>;
+    readonly runSeriesId: z.ZodOptional<z.ZodString>;
+    readonly seriesSlug: z.ZodOptional<z.ZodString>;
+    readonly includeOccurrenceId: z.ZodOptional<z.ZodString>;
+    readonly readIntent: z.ZodOptional<z.ZodString>;
+    readonly detailLevel: z.ZodOptional<z.ZodString>;
+    readonly readProfile: z.ZodOptional<z.ZodString>;
+};
+export declare const publicEventLoaderQuerySchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    afterStartsAt: z.ZodOptional<z.ZodString>;
+    afterId: z.ZodOptional<z.ZodString>;
+    categoryIds: z.ZodOptional<z.ZodString>;
+    venueId: z.ZodOptional<z.ZodString>;
+    staffMemberId: z.ZodOptional<z.ZodString>;
+    eventSurface: z.ZodOptional<z.ZodString>;
+    eventPresets: z.ZodOptional<z.ZodString>;
+    scheduleScope: z.ZodOptional<z.ZodString>;
+    seriesId: z.ZodOptional<z.ZodString>;
+    seriesIds: z.ZodOptional<z.ZodString>;
+    runSeriesId: z.ZodOptional<z.ZodString>;
+    seriesSlug: z.ZodOptional<z.ZodString>;
+    includeOccurrenceId: z.ZodOptional<z.ZodString>;
+    readIntent: z.ZodOptional<z.ZodString>;
+    detailLevel: z.ZodOptional<z.ZodString>;
+    readProfile: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const eventPresetSchema: z.ZodEnum<{
     course: "course";
     event: "event";

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

@@ -10,6 +10,10 @@ import type { PublicTeamMemberSummary } from '../../shared/teamMembers';
 import type { eventCalendarDefaultViewValues, eventCalendarDisplayModeValues, eventCalendarListLayoutValues } from '../../../constants/events';
 import type { EventScheduleScope, EventSurfacePreset, EventSurfaceScope } from './filtering';
 import type { BlockButtonRole } from '../../../constants/buttonRoles';
+import type { z } from 'zod';
+import type { publicEventLoaderQuerySchema } from './schemas';
+/** Raw string query vocabulary shared by public Event loader transports. */
+export type PublicEventLoaderParams = Readonly<z.infer<typeof publicEventLoaderQuerySchema>>;
 /**
  * Geographic coordinates for venue location
  */