@riverbankcms/sdk 0.104.1 → 0.107.0

package/dist/_dts/sdk/src/client/types.d.ts

@@ -485,6 +485,8 @@ export interface RiverbankClient {
         eventSurface?: string;
         eventPresets?: string;
         scheduleScope?: string;
+        detailLevel?: 'full' | 'listing';
+        readProfile?: string;
         /** Optional: filter to a specific content entry (event series) */
         entryId?: string;
         /** Optional: filter to a specific seriesId */

package/dist/_dts/sdk/src/config/types.d.ts

@@ -45,7 +45,7 @@ export type BlockCategory = 'marketing' | 'content' | 'blog' | 'media' | 'layout
  *
  * Re-exported from `@riverbankcms/blocks` (single source of truth).
  */
-export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "listPublicRecurringSchedule", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
 export type SdkLoaderEndpoint = (typeof SUPPORTED_LOADER_ENDPOINTS)[number];
 export type LoaderParamBinding = {
     $bind: {

package/dist/_dts/sdk/src/config/validation.d.ts

@@ -144,6 +144,7 @@ export declare const sdkLoaderEndpointSchema: z.ZodEnum<{
     listPublicProducts: "listPublicProducts";
     getPublishedEntryPreview: "getPublishedEntryPreview";
     listPublishedEntries: "listPublishedEntries";
+    listPublicRecurringSchedule: "listPublicRecurringSchedule";
     getPublicEventDetails: "getPublicEventDetails";
     listPublicRouteCandidates: "listPublicRouteCandidates";
 }>;
@@ -233,6 +234,7 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
         listPublicProducts: "listPublicProducts";
         getPublishedEntryPreview: "getPublishedEntryPreview";
         listPublishedEntries: "listPublishedEntries";
+        listPublicRecurringSchedule: "listPublicRecurringSchedule";
         getPublicEventDetails: "getPublicEventDetails";
         listPublicRouteCandidates: "listPublicRouteCandidates";
     }>;
@@ -298,6 +300,7 @@ export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString
         listPublicProducts: "listPublicProducts";
         getPublishedEntryPreview: "getPublishedEntryPreview";
         listPublishedEntries: "listPublishedEntries";
+        listPublicRecurringSchedule: "listPublicRecurringSchedule";
         getPublicEventDetails: "getPublicEventDetails";
         listPublicRouteCandidates: "listPublicRouteCandidates";
     }>;

package/dist/_dts/sdk/src/contracts/index.d.ts

@@ -1,5 +1,5 @@
 export type { TipTapNode, TipTapMark, InlineText, InlineTextAccentTone, InlineTextHighlightTone, InlineTextMark, InlineTextRun, Media, LinkValue, InternalRouteOnlyLinkValue, InternalResolvedLinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, } from './content';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, ProductDetailContent, ProductListContent, RecurringScheduleContent, SectionStylesContent, SemanticIconId, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, BlockIconValue, FeatureCardIconTreatment, } from './system-block-content';
 export type { PageOutline, PageRuntimeBoundary, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, } from './page';
 export type { Theme, ThemeTokens } from './theme';
 export type { CustomCssDeclarationsInput, CustomCssRuleInput, CustomCssNestedRuleInput, CustomCssAtRuleInput, KeyframesAtRuleInput, FontFaceAtRuleInput, MediaAtRuleInput, SupportsAtRuleInput, RawAtRuleInput, } from './custom-css';

package/dist/_dts/sdk/src/contracts/system-block-content.d.ts

@@ -214,7 +214,7 @@ export type EmbedContent = {
 export type EventLayout = 'grid' | 'stack' | 'compact';
 export type ColumnOption = '2' | '3' | '4';
 export type WeekStart = 'sunday' | 'monday';
-export type DisplayMode = 'combined' | 'calendar' | 'list' | 'timetable';
+export type DisplayMode = 'combined' | 'calendar' | 'list' | 'timetable' | 'week-board';
 export type FilterAutoShow = 'auto' | 'always' | 'never';
 export type CalendarTabViews = 'both' | 'month' | 'week';
 export type CalendarView = 'month' | 'week';
@@ -322,7 +322,7 @@ export type EventSpotlightContent = {
 };
 export type OfferingsPreviewSourceKey = 'eventPreset:class' | 'eventPreset:workshop' | 'eventPreset:retreat' | 'eventPreset:performance' | 'course';
 export type OfferingsPreviewCtaMode = 'auto' | 'custom' | 'hidden';
-export type OfferingsPreviewGroupPresentation = 'compact-list' | 'single-card';
+export type OfferingsPreviewGroupPresentation = 'compact-list' | 'single-card' | 'featured-summary';
 export type OfferingsPreviewGroupOverride = {
     sourceKey?: OfferingsPreviewSourceKey | null;
     title?: string | null;
@@ -359,6 +359,7 @@ export type FaqContent = {
     _containerStyles?: ContainerStylesContent;
 };
 export type FeatureCard = {
+    surfaceRole?: 'open' | 'panel' | null;
     media?: Media | null;
     aspectRatio?: StandardAspectRatio | null;
     icon?: BlockIconValue | SemanticIconId | null;
@@ -367,11 +368,14 @@ export type FeatureCard = {
     ctas?: BlockCtaContent[] | null;
 };
 export type FeatureCardsContent = {
-    variant?: 'cards' | null;
+    variant?: 'cards' | 'editorial-diptych' | 'editorial-pathways' | null;
+    eyebrow?: string | null;
     title?: string | null;
     description?: TipTapNode | null;
     columns?: '2' | '3' | '4' | null;
+    cardMarker?: 'icons' | 'numbers' | 'none' | null;
     _iconTreatment?: FeatureCardIconTreatment | null;
+    _generatedIconSizePx?: number | null;
     cards?: FeatureCard[] | null;
 };
 export type HeroCta = {
@@ -461,11 +465,25 @@ export type NewsletterSignupContent = {
     preset: NewsletterSignupPreset;
     includePhone?: boolean | null;
     buttonLabel?: string | null;
+    buttonVariant?: 'primary' | 'secondary' | 'outline' | null;
     successMessage?: string | null;
     privacyNote?: string | null;
     tags?: string | null;
     _sectionStyles?: SectionStylesContent;
 };
+export type RecurringScheduleContent = {
+    eyebrow?: string | null;
+    heading?: string | null;
+    description?: TipTapNode | null;
+    showVenue?: boolean | null;
+    buttonVariant?: 'primary' | 'secondary' | 'outline' | 'link' | null;
+    buttonText?: string | null;
+    seeAllButtonVariant?: 'primary' | 'secondary' | 'outline' | 'link' | null;
+    seeAllUrl?: LinkValue | null;
+    seeAllLabel?: string | null;
+    emptyMessage?: string | null;
+    _sectionStyles?: SectionStylesContent;
+};
 export type ContactNewsletterContent = {
     newsletterTitle?: string | null;
     newsletterSubtitle?: RichTextDoc | null;
@@ -486,11 +504,12 @@ export type ContactNewsletterContent = {
 export type ShopContent = {
     showPasses?: boolean | null;
     showMemberships?: boolean | null;
-    layout?: 'grid' | 'list' | null;
+    layout?: 'grid' | 'list' | 'register' | null;
     columns?: '1' | '2' | '3' | '4' | null;
     showDescriptions?: boolean | null;
     showValidityPeriod?: boolean | null;
     showPricePerCredit?: boolean | null;
+    buttonVariant?: 'primary' | 'secondary' | 'outline' | 'link' | null;
     passesHeading?: string | null;
     membershipsHeading?: string | null;
     buyButtonText?: string | null;
@@ -574,7 +593,7 @@ export type TeamMembersContent = (TeamMembersCommonContent & {
     members?: ManualTeamMemberItem[];
 });
 export type TestimonialsBlockContent = {
-    variant?: 'carousel' | 'grid' | 'split-grid' | 'highlight' | null;
+    variant?: 'carousel' | 'grid' | 'split-grid' | 'featured-editorial' | 'highlight' | null;
     heading?: string | null;
     subheading?: string | null;
     avatarLayout?: 'above-centered' | 'inline-left' | 'hidden' | null;
@@ -727,6 +746,7 @@ export type SystemBlockContentByFullKind = {
     'block.event-spotlight': EventSpotlightContent;
     'block.event-listing': EventListingContent;
     'block.event-calendar': EventCalendarContent;
+    'block.recurring-schedule': RecurringScheduleContent;
     'block.offerings-preview': OfferingsPreviewContent;
     'block.shop': ShopContent;
     'block.product-list': ProductListContent;

package/dist/_dts/sdk/src/data/dataLoaderContext.d.ts

@@ -0,0 +1,17 @@
+import type { BlockOutline } from '../contracts';
+import type { BlockKind } from '../types';
+import type { DataLoaderContext, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams } from './types';
+type IncomingSearchParams = Readonly<Record<string, string | readonly string[] | undefined>>;
+export declare function getDataLoaderOwnerPageId(target: DataLoaderRenderTarget): string;
+export declare function normalizeDataLoaderSearchParams(input: IncomingSearchParams | undefined): DataLoaderSearchParams;
+export declare function resolveDataLoaderBlockContent(block: BlockOutline, previewStage: DataLoaderPreviewStage): Readonly<Record<string, unknown>>;
+export declare function createDataLoaderContext(input: Readonly<{
+    siteId: string;
+    renderTarget: DataLoaderRenderTarget;
+    blockId: string;
+    blockKind: BlockKind;
+    content: Readonly<Record<string, unknown>>;
+    previewStage: DataLoaderPreviewStage;
+    searchParams: DataLoaderSearchParams;
+}>): DataLoaderContext;
+export {};

package/dist/_dts/sdk/src/data/dataLoaderValue.d.ts

@@ -0,0 +1,36 @@
+import type { DataLoaderValue } from './types';
+type UnsupportedDataLoaderValueType = 'undefined' | 'bigint' | 'symbol' | 'function';
+export type DataLoaderValueIssue = Readonly<{
+    kind: 'unsupported-type';
+    valueType: UnsupportedDataLoaderValueType;
+}> | Readonly<{
+    kind: 'non-finite-number';
+}> | Readonly<{
+    kind: 'non-plain-object';
+}> | Readonly<{
+    kind: 'accessor-property';
+}> | Readonly<{
+    kind: 'symbol-key';
+}> | Readonly<{
+    kind: 'invalid-array';
+}> | Readonly<{
+    kind: 'cycle';
+}> | Readonly<{
+    kind: 'inspection-failed';
+}> | Readonly<{
+    kind: 'complexity-limit-exceeded';
+}>;
+export type DataLoaderValueValidation = Readonly<{
+    ok: true;
+    value: DataLoaderValue;
+}> | Readonly<{
+    ok: false;
+    issue: DataLoaderValueIssue;
+}>;
+/**
+ * Validates and snapshots arbitrary loader output without invoking getters,
+ * setters, or conversion hooks. Reflection failures are returned as data,
+ * never thrown, and accepted containers are detached and frozen.
+ */
+export declare function validateDataLoaderValue(input: unknown): DataLoaderValueValidation;
+export {};

package/dist/_dts/sdk/src/data/defineOwnDataProperty.d.ts

@@ -0,0 +1,2 @@
+/** Define a string key as ordinary data without invoking legacy prototype setters. */
+export declare function defineOwnDataProperty<Value>(target: Record<string, Value>, key: string, value: Value): void;

package/dist/_dts/sdk/src/data/executeCodeLoaders.d.ts

@@ -1,44 +1,40 @@
-/**
- * Execute code-based data loaders for SDK custom blocks.
- *
- * Code loaders are user-defined async functions that can fetch data
- * from any API (not just whitelisted CMS endpoints). They run
- * server-side during loadPage().
- */
+/** Execute server-side host data loaders for SDK blocks. */
 import type { PageOutline } from '../contracts';
-import type { PrefetchContext, ResolvedBlockData } from './prefetchBlockData';
-import type { DataLoaderOverrides } from './types';
-/**
- * Execute code-based data loaders for blocks on a page.
- *
- * Iterates through page blocks and executes any registered loader
- * functions for matching block kinds. Runs all loaders in parallel.
- *
- * @param page - Page outline with blocks to process
- * @param context - Prefetch context (siteId, pageId, previewStage)
- * @param overrides - Map of block kinds to loader functions
- * @returns Resolved data keyed by blockId, then loader key
- *
- * @example
- * ```typescript
- * const codeData = await executeCodeLoaders(page, context, {
- *   'custom.featured-products': {
- *     products: async (ctx) => fetchProducts(ctx.content.categoryId),
- *   },
- * });
- * // codeData: { 'block-123': { products: [...] } }
- * ```
- */
-export declare function executeCodeLoaders(page: PageOutline, context: PrefetchContext & {
-    searchParams?: Record<string, string | string[] | undefined>;
-}, overrides: DataLoaderOverrides): Promise<ResolvedBlockData>;
+import { type BlockKind } from '../types';
+import { type DataLoaderValueIssue } from './dataLoaderValue';
+import type { ResolvedBlockData } from './prefetchBlockData';
+import type { DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams } from './types';
+export type CodeLoaderFailureKind = 'execution-failed' | 'invalid-result';
+type CodeLoaderFailureCoordinates = Readonly<{
+    siteId: string;
+    pageId: string;
+    blockId: string;
+    blockKind: BlockKind;
+    loaderKey: string;
+    previewStage: DataLoaderPreviewStage;
+    renderTargetKind: DataLoaderRenderTarget['kind'];
+}>;
+export type CodeLoaderFailure = CodeLoaderFailureCoordinates & (Readonly<{
+    kind: 'execution-failed';
+}> | Readonly<{
+    kind: 'invalid-result';
+    validationIssueKind: DataLoaderValueIssue['kind'];
+}>);
+export type ExecuteCodeLoadersResult = Readonly<{
+    data: ResolvedBlockData;
+    failures: readonly CodeLoaderFailure[];
+}>;
+export type ExecuteCodeLoadersContext = Readonly<{
+    siteId: string;
+    renderTarget: DataLoaderRenderTarget;
+    previewStage: DataLoaderPreviewStage;
+    searchParams: DataLoaderSearchParams;
+}>;
 /**
- * Merge resolved data from config loaders and code loaders.
- *
- * Code loader results take precedence on key conflicts.
- *
- * @param configResults - Data from config-based loaders (CMS endpoints)
- * @param codeResults - Data from code-based loaders (external APIs)
- * @returns Merged data with code results overwriting config on conflicts
+ * Runs all matching host loaders concurrently. The function returns closed
+ * outcomes and never logs; warning ownership belongs to the shared resolver.
  */
+export declare function executeCodeLoaders(page: PageOutline, context: ExecuteCodeLoadersContext, overrides: DataLoaderOverrides): Promise<ExecuteCodeLoadersResult>;
+/** Successful host values take precedence on per-block loader-key collisions. */
 export declare function mergeLoaderResults(configResults: ResolvedBlockData, codeResults: ResolvedBlockData): ResolvedBlockData;
+export {};

package/dist/_dts/sdk/src/data/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Block data loading utilities for SDK
  */
-export { prefetchBlockData, SUPPORTED_LOADER_ENDPOINTS } from './prefetchBlockData';
-export type { PrefetchContext, ResolvedBlockData, SdkPrefetchOptions, SupportedLoaderEndpoint } from './prefetchBlockData';
+export { prefetchBlockData, SUPPORTED_LOADER_ENDPOINTS, } from './prefetchBlockData';
+export type { PrefetchContext, ResolvedBlockData, SdkPrefetchOptions, SupportedLoaderEndpoint, } from './prefetchBlockData';
 export { executeCodeLoaders, mergeLoaderResults } from './executeCodeLoaders';
-export type { DataLoaderContext, DataLoaderFn, BlockLoaderMap, DataLoaderOverrides, } from './types';
+export type { BlockLoaderMap, DataLoaderContext, DataLoaderFn, DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams, DataLoaderValue, } from './types';

package/dist/_dts/sdk/src/data/resolveBlockData.d.ts

@@ -0,0 +1,54 @@
+import type { RiverbankClient } from '../client/types';
+import type { PageOutline } from '../contracts';
+import type { SdkCustomBlock } from '../config/types';
+import { executeCodeLoaders, mergeLoaderResults, type CodeLoaderFailure } from './executeCodeLoaders';
+import { prefetchBlockData, type ResolvedBlockData } from './prefetchBlockData';
+import type { DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams } from './types';
+import type { BlockKind } from '../types';
+export type BlockDataLoadPolicy = Readonly<{
+    kind: 'config-only';
+}> | Readonly<{
+    kind: 'config-and-host';
+    overrides: DataLoaderOverrides;
+    searchParams: DataLoaderSearchParams;
+}>;
+export declare const CONFIG_ONLY_BLOCK_DATA_POLICY: BlockDataLoadPolicy;
+type HostDataLoaderWarningCoordinates = Readonly<{
+    siteId: string;
+    pageId: string;
+    blockId: string;
+    blockKind: BlockKind;
+    loaderKey: string;
+    previewStage: DataLoaderPreviewStage;
+    renderTargetKind: DataLoaderRenderTarget['kind'];
+}>;
+export type HostDataLoaderWarning = HostDataLoaderWarningCoordinates & (Readonly<{
+    failureKind: 'execution-failed';
+}> | Readonly<{
+    failureKind: 'invalid-result';
+    validationIssueKind: Extract<CodeLoaderFailure, {
+        kind: 'invalid-result';
+    }>['validationIssueKind'];
+}>);
+export type ResolveBlockDataDeps = Readonly<{
+    prefetchBlockData: typeof prefetchBlockData;
+    executeCodeLoaders: typeof executeCodeLoaders;
+    mergeLoaderResults: typeof mergeLoaderResults;
+    warn: (warning: HostDataLoaderWarning) => void;
+}>;
+export declare function warnHostDataLoaderFailure(warning: HostDataLoaderWarning): void;
+export declare const DEFAULT_RESOLVE_BLOCK_DATA_DEPS: ResolveBlockDataDeps;
+export declare function hasRegisteredDataLoaders(overrides: DataLoaderOverrides | undefined): overrides is DataLoaderOverrides;
+export declare function createBlockDataLoadPolicy(overrides: DataLoaderOverrides | undefined, searchParams: DataLoaderSearchParams): BlockDataLoadPolicy;
+export type ResolveBlockDataInput = Readonly<{
+    page: PageOutline;
+    siteId: string;
+    renderTarget: DataLoaderRenderTarget;
+    previewStage: DataLoaderPreviewStage;
+    policy: BlockDataLoadPolicy;
+    client: RiverbankClient;
+    customBlocks?: SdkCustomBlock[];
+}>;
+export declare function resolveBlockData(input: ResolveBlockDataInput): Promise<ResolvedBlockData>;
+export declare function resolveBlockDataWithDeps(deps: ResolveBlockDataDeps, input: ResolveBlockDataInput): Promise<ResolvedBlockData>;
+export {};

package/dist/_dts/sdk/src/data/types.d.ts

@@ -1,90 +1,55 @@
 /**
- * Code-based data loader types for SDK custom blocks.
- *
- * These types enable SDK sites to define loader functions that fetch
- * data from external APIs (not just CMS endpoints).
+ * Server-side host data loader contracts for SDK custom blocks.
  */
+import type { SdkRuntimePageSurfaceSubject } from '../public-api/contracts';
 import type { BlockKind } from '../types';
+export type DataLoaderPreviewStage = 'published' | 'preview';
+/** Values that are safe to pass through Riverbank's RSC/rendering boundary. */
+export type DataLoaderValue = string | number | boolean | null | readonly DataLoaderValue[] | {
+    readonly [key: string]: DataLoaderValue;
+};
+/** Immutable URL search parameters exposed to host loaders. */
+export type DataLoaderSearchParams = Readonly<Record<string, string | readonly string[] | undefined>>;
 /**
- * Context provided to code-based data loaders.
+ * The content owner being rendered by a block data loader.
  *
- * Contains block metadata and page context for making informed
- * data fetching decisions.
+ * Template targets carry both the template ID and the underlying content
+ * identity so callers never have to interpret nullable entry/surface fields.
  */
-export interface DataLoaderContext {
-    /** Site ID from page context */
+export type DataLoaderRenderTarget = Readonly<{
+    kind: 'page';
+    pageId: string;
+}> | Readonly<{
+    kind: 'entry-template';
+    templateId: string;
+    entryId: string;
+    entryType: string | null;
+}> | Readonly<{
+    kind: 'page-surface-template';
+    templateId: string;
+    pageSurfaceId: string;
+    routeId: string;
+    subject: SdkRuntimePageSurfaceSubject;
+}>;
+/** Context supplied to each server-side host data loader. */
+export type DataLoaderContext = Readonly<{
     siteId: string;
-    /** Page ID from page context */
+    /** Page ID for pages; template ID for template-backed content. */
     pageId: string;
-    /** Unique block instance ID */
     blockId: string;
-    /** Block kind (e.g., 'custom.featured-products') */
     blockKind: BlockKind;
-    /**
-     * The block's CMS content.
-     * Use this to access field values for parameterizing API calls.
-     */
-    content: Record<string, unknown>;
-    /** Whether fetching preview/draft content */
-    previewStage: 'published' | 'preview';
-    /**
-     * URL search parameters from the page request.
-     * Use for pagination, filtering, or sorting based on URL params.
-     *
-     * Always defined (defaults to empty object if not provided to loadPage).
-     * This allows loaders to safely access properties without null checks.
-     *
-     * @example
-     * ```typescript
-     * const page = parseInt(searchParams?.page as string || '1', 10);
-     * const limit = parseInt(content.postsPerPage as string || '12', 10);
-     * const offset = (page - 1) * limit;
-     * ```
-     */
-    searchParams: Record<string, string | string[] | undefined>;
-}
-/**
- * A code-based data loader function.
- *
- * Receives context about the block and returns fetched data.
- * Runs server-side during `loadPage()`.
- *
- * @example
- * ```typescript
- * const productsLoader: DataLoaderFn = async (ctx) => {
- *   const categoryId = ctx.content.categoryId;
- *   const response = await fetch(`https://api.shop.com/products?category=${categoryId}`);
- *   return response.json();
- * };
- * ```
- */
-export type DataLoaderFn = (context: DataLoaderContext) => Promise<unknown>;
+    /** Stage-resolved block content used by the renderer. */
+    content: Readonly<Record<string, unknown>>;
+    previewStage: DataLoaderPreviewStage;
+    searchParams: DataLoaderSearchParams;
+    renderTarget: DataLoaderRenderTarget;
+}>;
 /**
- * Map of loader key to loader function for a block kind.
- *
- * Keys become the property names in the `data` prop passed to the component.
- */
-export type BlockLoaderMap = Record<string, DataLoaderFn>;
-/**
- * Registry of code-based data loaders.
- *
- * Keys are block kinds (e.g., 'custom.featured-products').
- * Values are maps of loader keys to loader functions.
- *
- * @example
- * ```typescript
- * const dataLoaderOverrides: DataLoaderOverrides = {
- *   'custom.featured-products': {
- *     products: async (ctx) => {
- *       return fetchProducts(ctx.content.categoryId);
- *     },
- *   },
- *   'custom.instagram-feed': {
- *     posts: async (ctx) => {
- *       return fetchInstagramPosts(ctx.content.accessToken);
- *     },
- *   },
- * };
- * ```
+ * A host loader must return JSON-safe data. Parse untrusted network responses
+ * before returning them; runtime validation remains as a JavaScript/`any`
+ * boundary safeguard.
  */
-export type DataLoaderOverrides = Record<string, BlockLoaderMap>;
+export type DataLoaderFn = (context: DataLoaderContext) => Promise<DataLoaderValue>;
+export type BlockLoaderMap = Readonly<Record<string, DataLoaderFn>>;
+/** Registry keyed by full SDK block kind, for example `custom.products`. */
+export type DataLoaderOverrides = Readonly<Partial<Record<BlockKind, BlockLoaderMap>>>;

package/dist/_dts/sdk/src/next/index.d.ts

@@ -40,6 +40,7 @@
 export { createCatchAllPage } from './catch-all';
 export { RiverbankContentLoadError, SdkContentLoadError, classifyContentLoadError, isSdkContentLoadError, toContentLoadFailureLogFields, type CatchAllContentLoadFailureContext, type CatchAllRequestContext, type ClassifiedContentLoadError, type SdkContentLoadFailure, type SdkContentLoadFailureKind, type SdkContentLoadNotFound, } from './content-load-failure';
 export type { CreateCatchAllPageOptions, CreateCatchAllPageResult, CatchAllPageProps, CatchAllContext, ThemeSwitchConfigV1, ThemeResolverContext, } from './types';
+export type { BlockLoaderMap, DataLoaderContext, DataLoaderFn, DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams, DataLoaderValue, } from '../data/types';
 export { createGenerateStaticParams, generateAllStaticParams, normalizeStaticRoutePath, validateStaticParamsEnv, pathToSlugArray, routesToStaticParams, type CreateGenerateStaticParamsOptions, type GenerateAllStaticParamsOptions, type StaticParam, type StaticParamsClient, type StaticParamsEnvResult, type StaticParamsFailureContext, type StaticParamsFailureMode, type StaticParamsRoute, } from './static-params';
 export { createSitemap, type CreateSitemapOptions, type SitemapGenerator, } from './sitemap';
 export { createRobots, type CreateRobotsOptions } from './robots';

package/dist/_dts/sdk/src/next/redirect-destination.d.ts

@@ -1,3 +1,3 @@
-type IncomingSearch = string | URLSearchParams | Readonly<Record<string, string | string[] | undefined>> | null | undefined;
+type IncomingSearch = string | URLSearchParams | Readonly<Record<string, string | readonly string[] | undefined>> | null | undefined;
 export declare function appendSearchToRedirectDestination(destination: string, incomingSearch: IncomingSearch): string;
 export {};

package/dist/_dts/sdk/src/next/resolveTheme.d.ts

@@ -1,6 +1,7 @@
 import type { Theme } from '../contracts';
 import type { RiverbankSiteConfig } from '../config/types';
 import type { ThemeResolverContext, ThemeSwitchConfigV1 } from './types';
+import type { DataLoaderSearchParams } from '../data/types';
 export type ResolveThemeResult = {
     kind: 'resolved';
     theme: Theme;
@@ -24,7 +25,7 @@ export type ThemeOptionsForResolver = {
 export interface ResolveThemeInput {
     config: Pick<RiverbankSiteConfig, 'themeSource' | 'activeTheme'>;
     contentTheme: Theme;
-    searchParams: Record<string, string | string[] | undefined>;
+    searchParams: DataLoaderSearchParams;
     isDevelopment: boolean;
     themeOptions: ThemeOptionsForResolver;
     context: ThemeResolverContext;

package/dist/_dts/sdk/src/next/types.d.ts

@@ -12,6 +12,7 @@ import type { SdkThemeRuntime } from '../rendering/themeRuntime';
 import type { BlockOverrideRegistrations } from '../rendering/overrides';
 import type { Metadata } from '../metadata/generatePageMetadata';
 import type { LoadContentResult } from '../rendering/helpers/loadContent';
+import type { DataLoaderOverrides, DataLoaderSearchParams } from '../data/types';
 import type { CatchAllContentLoadFailureContext, CatchAllRequestContext } from './content-load-failure';
 /**
  * Context passed to escape hatch callbacks.
@@ -30,7 +31,7 @@ export interface CatchAllContext {
      */
     themeRuntime: SdkThemeRuntime;
     /** Search parameters from the URL (for filtering, pagination, etc.) */
-    searchParams: Record<string, string | string[] | undefined>;
+    searchParams: DataLoaderSearchParams;
 }
 export type CreateCatchAllContentContract = 'compat' | 'native';
 export type CreateCatchAllContentContractResolverContext = Readonly<{
@@ -205,6 +206,14 @@ export type CreateCatchAllPageOptions = {
      * promise-returning functions are not lazy override registrations.
      */
     blockOverrides?: BlockOverrideRegistrations;
+    /**
+     * Server-only host data loaders for custom blocks.
+     *
+     * Loader functions run during page rendering after CMS/config loaders. Their
+     * JSON-safe results win on key collisions. They are never invoked by
+     * `generateMetadata()` and must be declared in a server-only module.
+     */
+    dataLoaderOverrides?: DataLoaderOverrides;
     /**
      * Override site URL for metadata generation.
      * Defaults to `config.liveUrl` or `config.previewUrl` based on preview mode.

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -1,8 +1,8 @@
 import type { AddressedLocationValue, BusinessAddress, BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig, PublicEventPricing } from '../../../core/src/index';
-import type { SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject } from '../../../api/src/index';
+import type { PublicEventRecurrence as ApiPublicEventRecurrence, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject } from '../../../api/src/index';
 import type { Media, MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent, Theme } from '../contracts';
 import type { CompiledBoundaryRuntime } from '../../../theme-core/src/site-styles/index';
-import type { PaletteOverrides, RuntimePaletteState } from '../../../theme-core/src/palette/index';
+import type { RuntimePaletteState } from '../../../theme-core/src/palette/index';
 import type { BlockFieldConfig as SdkBlockFieldConfig, BlockFieldOptionsMap as SdkBlockFieldOptionsMap, ContentConfig as SdkContentConfig, ContainerOptionsConfig as SdkContainerOptionsConfig, FieldSelectOption as SdkFieldSelectOption, SdkCustomBlock, SdkThemeConfig, SdkThemePalette, SectionBackground as SdkSectionBackground, SectionOptionsConfig as SdkSectionOptionsConfig, SiteStyleConfig as SdkSiteStyleConfig } from '../config/types';
 export type PublicTeamMemberSummary = {
     id: string;
@@ -318,14 +318,8 @@ export type SiteResponse = {
     */
     selectionButtonPersonalityId?: string | null;
     runtimePaletteState?: RuntimePaletteState | null;
-    /** Temporary legacy compatibility projection for stale runtime clients. */
-    selectionPaletteVariantId?: string | null;
-    selectionPaletteOverrides?: PaletteOverrides | null;
     selectionHeaderLayoutId?: string | null;
     selectionHeaderStyleId?: string | null;
-    selectionTypographyPresetId?: string | null;
-    selectionTypographyBodyFontOverride?: string | null;
-    selectionTypographyHeadingFontOverride?: string | null;
     selectionHeaderLookId?: string | null;
     selectionFooterLookId?: string | null;
     navigation: NavigationMenuWithItems[];
@@ -630,6 +624,7 @@ export type PublicEventDestination = Readonly<{
 }>;
 export type PublicEventsResponse = Array<{
     kind?: 'event' | 'course_session';
+    recurrence?: ApiPublicEventRecurrence;
     destination: PublicEventDestination;
     id: string;
     occurrenceId: string;

package/dist/_dts/sdk/src/rendering/helpers/loadContent.d.ts

@@ -8,8 +8,9 @@ import type { MediaAssetIndexItem, RouteMap, Theme } from '../../contracts';
 import type { RiverbankClient, PageResponse, SiteResponse } from '../../client/types';
 import type { SdkRuntimePageSurfaceSubject } from '../../public-api/contracts';
 import type { PageProps } from '../components/Page';
-import { prefetchBlockData } from '../../data/prefetchBlockData';
 import type { ResolvedBlockData } from '../../data/prefetchBlockData';
+import { type ResolveBlockDataDeps } from '../../data/resolveBlockData';
+import type { DataLoaderOverrides, DataLoaderSearchParams } from '../../data/types';
 import type { SdkCustomBlock } from '../../config/types';
 import { type RuntimeSdkConfig } from './pageRuntimeSupport';
 /**
@@ -34,6 +35,10 @@ export type LoadContentParams = {
      * @default false
      */
     preview?: boolean;
+    /** Server-side host data loaders for custom block data. */
+    dataLoaderOverrides?: DataLoaderOverrides;
+    /** URL search parameters passed only to host data loaders. */
+    searchParams?: DataLoaderSearchParams;
 };
 export type LoadContentFromContentResponseParams = {
     client: RiverbankClient;
@@ -41,6 +46,8 @@ export type LoadContentFromContentResponseParams = {
     site: SiteResponse;
     contentResponse: PageResponse;
     preview?: boolean;
+    dataLoaderOverrides?: DataLoaderOverrides;
+    searchParams?: DataLoaderSearchParams;
 };
 /**
  * Content entry data returned when a path resolves to an entry
@@ -228,9 +235,7 @@ export type PageSurfaceContentResult = {
  * Discriminated union result from loadContent
  */
 export type LoadContentResult = PageContentResult | EntryContentResult | PageSurfaceContentResult;
-export type LoadContentDeps = Readonly<{
-    prefetchBlockData: typeof prefetchBlockData;
-}>;
+export type LoadContentDeps = ResolveBlockDataDeps;
 /**
  * Type guard to check if result is a page
  */