@riverbankcms/sdk 0.104.3 → 0.108.0

package/dist/_dts/sdk/src/client/management/blocks.d.ts

@@ -1,6 +1,19 @@
 /**
  * Block Operations for Management Client
  */
+import { ManagementApiError, type HttpClient } from './http';
 import type { BlockOperations } from './types';
-import type { HttpClient } from './http';
+/**
+ * Discriminated stale-conflict error for `blocks.patch`: the block's draft
+ * changed since the caller's read. `currentHash` is the server's current
+ * draft content hash — retry the patch with it as `baseContentHash`.
+ * Extracted from the typed `SdkPatchPageBlockStaleContentFieldError` wire
+ * contract, so callers never parse prose.
+ */
+export declare class BlockPatchStaleContentError extends ManagementApiError {
+    readonly kind = "stale-content";
+    readonly currentHash: string;
+    constructor(source: ManagementApiError, currentHash: string);
+}
+export declare function isBlockPatchStaleContentError(error: unknown): error is BlockPatchStaleContentError;
 export declare function createBlockOperations(http: HttpClient): BlockOperations;

package/dist/_dts/sdk/src/client/management/index.d.ts

@@ -36,7 +36,8 @@ import { CourseSessionConflictError } from './courses';
  * @returns ManagementClient instance
  */
 export declare function createManagementClient(config: ManagementClientConfig): ManagementClient;
-export type { ManagementClient, ManagementClientConfig, ManagementEntry, ManagementPage, ManagementBlock, ManagementNavigationMenu, ManagementNavigationItem, ManagementSettings, ManagementForm, ManagementFormField, ManagementFormSchema, ManagementFormSettings, ManagementVenue, VenueAddress, VenueLocation, VenueUpsertInput, ManagementEventCategory, EventCategoryUpsertInput, ManagementEventSeries, EventSchedule, EventScheduleUpsertInput, EventStartDurationSchedule, EventStartEndSchedule, EventPricing, EventPaymentTerms, EventPaymentTermsInput, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, PageUpsertInput, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, SiteStyleSelectionApplyCommand, SiteStyleSelectionApplyCommandInput, ThemeUpsertInput, ThemeUpsertResult, ThemeStyleSelectionApplyInput, ThemeStyleSelectionApplyResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, WebhookOperations, SetupRevalidationWebhookInput, SetupRevalidationWebhookResult, ManagementWebhookEndpoint, RevalidationWebhookPlannedEndpoint, FormOperations, ThemeOperations, VenueOperations, EventCategoryOperations, EventOperations, CourseOperations, PullOperations, IdentifiersOperations, BackfillResult, BackfillPageResult, BackfillBlockResult, BackfillEntryResult, MediaOperations, MediaUploadResult, } from './types';
+export type { ManagementClient, ManagementClientConfig, ManagementEntry, ManagementPage, ManagementBlock, ManagementNavigationMenu, ManagementNavigationItem, ManagementSettings, ManagementForm, ManagementFormField, ManagementFormSchema, ManagementFormSettings, ManagementVenue, VenueAddress, VenueLocation, VenueUpsertInput, ManagementEventCategory, EventCategoryUpsertInput, ManagementEventSeries, EventSchedule, EventScheduleUpsertInput, EventStartDurationSchedule, EventStartEndSchedule, EventPricing, EventPaymentTerms, EventPaymentTermsInput, EventContent, EventSeriesUpsertInput, ManagementCourseRun, CourseRunUpsertInput, CourseSession, CourseProgramContent, CourseSessionConflict, EntryUpsertInput, EntryPublishUpsertResult, UpsertedManagementEntry, PageUpsertInput, PagePublishUpsertResult, BlockUpsertInput, NavigationMenuUpsertInput, NavigationItemInput, FormUpsertInput, SiteStyleSelectionApplyCommand, SiteStyleSelectionApplyCommandInput, ThemeUpsertInitializeInput, ThemeUpsertInput, ThemeUpsertResult, ThemeUpsertUpdateInput, ThemeStyleSelectionApplyInput, ThemeStyleSelectionApplyResult, FooterContent, ManagementFooterContent, FooterContentUpsertInput, FooterOperations, PulledFooter, PulledEntries, PulledPages, PulledDrafts, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledVenues, PulledEventCategories, PulledEvents, PulledCourses, PulledSiteInfo, PulledContentType, PulledContentTypes, PulledContent, PaginationOptions, PaginatedResult, EntryOperations, PageOperations, BlockOperations, NavigationOperations, SettingsOperations, SettingsUpdateInput, WebhookOperations, SetupRevalidationWebhookInput, SetupRevalidationWebhookResult, ManagementWebhookEndpoint, RevalidationWebhookPlannedEndpoint, FormOperations, ThemeOperations, VenueOperations, EventCategoryOperations, EventOperations, CourseOperations, PullOperations, IdentifiersOperations, BackfillResult, BackfillPageResult, BackfillBlockResult, BackfillEntryResult, MediaOperations, MediaUploadResult, } from './types';
 export { ManagementApiError, type ManagementApiErrorRequest } from './http';
+export { BlockPatchStaleContentError, isBlockPatchStaleContentError, } from './blocks';
 export { applySiteStyleSelectionBodyFromCommand, buildApplySiteStyleSelectionCommand, } from './theme';
 export { CourseSessionConflictError };

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

@@ -4,13 +4,23 @@
  * Type definitions for the SDK management client used for write operations.
  */
 import type { LinkPayload, NavigationLinkInput } from '../../public-api/contracts';
+import type { APIEndpoints } from '../../../../api/src/index';
 import type { SiteCommandOf } from '../../../../site-commands/src/index';
 import type { SdkEventPricing, SdkEventPricingInput, SdkEventTicketTypeInput } from '../../../../api/src/sdk-event-pricing';
 import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from '../../../../api/src/sdk-event-payment-terms';
 import type { SdkEventUpsertBody } from '../../../../api/src/sdk-event-upsert';
 import type { SdkManagementEventSeries } from '../../../../api/src/sdkContracts';
+import type { SdkPullTruncationMeta } from '../../../../api/src/sdkContracts';
+import type { SdkEntryPublishErrorCode, SdkPagePublishErrorCode, SdkPublicationOutcome } from '../../../../api/src/sdkContracts';
 import type { PaletteSelection } from '../../../../theme-core/src/palette/index';
 import type { Theme } from '../../contracts';
+export type SdkDeletePageResponse = NonNullable<APIEndpoints['sdkDeletePage']['response']>;
+export type SdkGetPageBlockResponse = NonNullable<APIEndpoints['sdkGetPageBlock']['response']>;
+export type SdkPatchPageBlockBody = NonNullable<APIEndpoints['sdkPatchPageBlock']['body']>;
+export type SdkPatchPageBlockResponse = NonNullable<APIEndpoints['sdkPatchPageBlock']['response']>;
+export type SdkPullEntriesAllResponse = NonNullable<APIEndpoints['sdkPullEntriesAll']['response']>;
+export type SdkUpsertEntryResponse = NonNullable<APIEndpoints['sdkUpsertEntry']['response']>;
+export type SdkUpsertPageResponse = NonNullable<APIEndpoints['sdkUpsertPage']['response']>;
 export interface ManagementClientConfig {
     /**
      * Dashboard URL (e.g., http://localhost:4000 or https://dashboard.riverbankcms.com)
@@ -66,6 +76,28 @@ export interface EntryUpsertInput {
     slug?: string;
     manualOrder?: number;
     blocks?: EntrySlotBlocksInput;
+    /**
+     * Publication intent. 'draft' (default) writes a draft only; 'publish' runs
+     * the publish operation after a successful save. Save and publish are not
+     * atomic — a publish that fails after a successful save is reported in-band on
+     * the response, not as an error.
+     */
+    publication?: 'draft' | 'publish';
+}
+/**
+ * The entry shape upsert responses carry — the wire envelope omits
+ * `publishedData` (the caller just wrote the draft; fetch with `get` when the
+ * published side is needed).
+ */
+export type UpsertedManagementEntry = Omit<ManagementEntry, 'publishedData'>;
+/**
+ * Result of an entry upsert with `publication: 'publish'`. The promise resolves
+ * even when the publish stage failed — the save succeeded and the entry exists
+ * as a draft; branch on `publication.published`.
+ */
+export interface EntryPublishUpsertResult {
+    entry: UpsertedManagementEntry;
+    publication: SdkPublicationOutcome<SdkEntryPublishErrorCode>;
 }
 export interface ManagementPage {
     id: string;
@@ -84,6 +116,20 @@ export interface PageUpsertInput {
     path: string;
     seoTitle?: string;
     seoDescription?: string;
+    /**
+     * Publication intent. 'draft' (default) writes a draft only; 'publish' runs
+     * page publish after a successful save. Save and publish are non-atomic; a
+     * publish failure after a successful save is reported in-band, not as an error.
+     */
+    publication?: 'draft' | 'publish';
+}
+/**
+ * Result of a page upsert with `publication: 'publish'`. Resolves even when the
+ * publish stage failed — the save succeeded; branch on `publication.published`.
+ */
+export interface PagePublishUpsertResult {
+    page: ManagementPage;
+    publication: SdkPublicationOutcome<SdkPagePublishErrorCode>;
 }
 export interface ManagementBlock {
     id: string;
@@ -106,6 +152,7 @@ export interface ManagementNavigationMenu {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     items: ManagementNavigationItem[];
     createdAt: string;
     updatedAt: string;
@@ -145,6 +192,7 @@ export interface PulledNavigationMenu {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     items: PulledNavigationItem[];
     createdAt: string;
     updatedAt: string;
@@ -154,6 +202,7 @@ export interface NavigationMenuUpsertInput {
     name: string;
     isPrimary?: boolean;
     isFooter?: boolean;
+    footerRole?: 'main' | 'legal-policy' | null;
     items: NavigationItemInput[];
 }
 export interface NavigationItemInput {
@@ -487,16 +536,18 @@ export interface MediaResolveResponse {
     missingAssetIds: string[];
 }
 /**
- * Input for creating or updating a theme.
- * Include themeId/selectionId for idempotent updates (push after pull).
+ * Explicitly separates an existing-theme update from first-theme provisioning.
+ * Initialization never accepts a separately authoritative Theme payload.
  */
-export interface ThemeUpsertInput {
-    theme: Theme;
-    /** Optional: update existing theme row (for idempotent push) */
-    themeId?: string;
-    /** Optional: update existing selection row (for idempotent push) */
-    selectionId?: string;
-}
+export type ThemeUpsertInput = NonNullable<APIEndpoints['sdkUpsertTheme']['body']>;
+/** Updates an existing theme selection with a caller-supplied theme. */
+export type ThemeUpsertUpdateInput = Extract<ThemeUpsertInput, {
+    kind: 'update';
+}>;
+/** Creates the first theme by compiling this complete style-selection command. */
+export type ThemeUpsertInitializeInput = Extract<ThemeUpsertInput, {
+    kind: 'initialize';
+}>;
 /**
  * Response from theme upsert operation.
  */
@@ -507,10 +558,29 @@ export interface ThemeUpsertResult {
 }
 export type SiteStyleSelectionApplyCommand = SiteCommandOf<'applySiteStyleSelection'>;
 export type SiteStyleSelectionApplyCommandInput = SiteStyleSelectionApplyCommand['input'];
-export interface ThemeStyleSelectionApplyInput extends SiteStyleSelectionApplyCommandInput {
+/**
+ * Public SDK input for style-selection apply, derived from the shared command
+ * IR so SDK, CLI, and AI proposal flows stay aligned. The IR permits the
+ * minimal request ({siteStyleId, baseSelectionVersion}); omitted choices
+ * default from the curated style server-side. Wire IDs are strings at this
+ * boundary; the server schema brands and validates them. The canonical header
+ * pair is atomic at the type level: both omitted (site-style default), both
+ * null (legacy default), or both supplied.
+ */
+export type ThemeStyleSelectionApplyInput = Omit<SiteStyleSelectionApplyCommandInput, 'siteStyleId' | 'headerLayoutId' | 'headerStyleId'> & Readonly<{
+    siteStyleId: string;
     baseSelectionVersion: number;
     selectionId?: string | null;
-}
+}> & (Readonly<{
+    headerLayoutId?: undefined;
+    headerStyleId?: undefined;
+}> | Readonly<{
+    headerLayoutId: null;
+    headerStyleId: null;
+}> | Readonly<{
+    headerLayoutId: string;
+    headerStyleId: string;
+}>);
 export interface ThemeStyleSelectionApplyResult {
     success: boolean;
     themeId: string;
@@ -521,21 +591,17 @@ export interface ThemeStyleSelectionApplyResult {
     theme: Theme;
     siteStyleId: string;
     buttonPersonalityId: string;
-    paletteVariantId: string;
-    paletteOverrides: Record<string, string> | null;
     activePaletteSelection: PaletteSelection;
     activeSitePaletteVersion: number | null;
     headerLookId: string | null;
     headerLayoutId: string;
     headerStyleId: string;
-    typographyPresetId: string | null;
-    typographyBodyFontOverride: string | null;
-    typographyHeadingFontOverride: string | null;
     footerLookId: string;
 }
 /**
  * Footer content for SDK management operations.
- * Matches the structure stored in site_settings.footer_content_json (bottomText only).
+ * A narrow legal-text command. The CMS maps this onto the V1 footer composition's
+ * legal module without exposing or replacing the aggregate.
  */
 export interface FooterContent {
     /** Rich text content in ProseMirror JSON format */
@@ -586,6 +652,7 @@ export interface PulledEntries {
             updatedAt: string;
             publishedAt: string | null;
         }>;
+        truncation?: SdkPullTruncationMeta;
     };
     pagination: {
         page: number;
@@ -625,6 +692,30 @@ export interface PulledNavigation {
         pulledAt: string;
     };
 }
+/**
+ * Cross-type overview of everything with pending (unpublished) changes.
+ * Mirrors `SdkPullDraftsResponse` in `@riverbankcms/api`; kept structurally in
+ * sync by the API↔SDK typetest.
+ */
+export interface PulledDrafts {
+    pages: Array<{
+        identifier: string;
+        hasUnpublishedChanges: boolean;
+        status: 'draft' | 'published';
+    }>;
+    entries: Array<{
+        contentType: string;
+        identifier: string;
+        status: 'draft' | 'published';
+    }>;
+    summary: {
+        pageCount: number;
+        entryCount: number;
+    };
+    meta: {
+        pulledAt: string;
+    };
+}
 export interface PulledSettings {
     settings: ManagementSettings;
     warnings?: string[];
@@ -783,10 +874,8 @@ export interface PulledContent {
     meta: {
         pulledAt: string;
         settingsUpdatedAt?: string | null;
-        /** Whether the response was truncated due to size limits */
-        truncated?: boolean;
-        /** Message explaining what was truncated */
-        truncationMessage?: string;
+        /** Whether the response was truncated due to size limits and what was returned. */
+        truncation: SdkPullTruncationMeta;
         entries?: Record<string, {
             createdAt: string;
             updatedAt: string;
@@ -828,7 +917,19 @@ export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
 export interface EntryOperations {
     list(contentType: string, options?: PaginationOptions): Promise<PaginatedResult<ManagementEntry>>;
     get(contentType: string, identifier: string): Promise<ManagementEntry | null>;
-    upsert(input: EntryUpsertInput): Promise<ManagementEntry>;
+    /**
+     * Correlated overloads: a publish-intent upsert resolves to the entry plus
+     * the publication outcome (which may report a failed publish); a draft upsert
+     * resolves to the entry alone. Statically-unknown intent gets the honest
+     * union.
+     */
+    upsert(input: EntryUpsertInput & {
+        publication: 'publish';
+    }): Promise<EntryPublishUpsertResult>;
+    upsert(input: EntryUpsertInput & {
+        publication?: 'draft';
+    }): Promise<UpsertedManagementEntry>;
+    upsert(input: EntryUpsertInput): Promise<UpsertedManagementEntry | EntryPublishUpsertResult>;
     publish(contentType: string, identifier: string): Promise<void>;
     unpublish(contentType: string, identifier: string): Promise<void>;
     delete(contentType: string, identifier: string): Promise<void>;
@@ -836,14 +937,31 @@ export interface EntryOperations {
 export interface PageOperations {
     list(options?: PaginationOptions): Promise<PaginatedResult<ManagementPage>>;
     get(identifier: string): Promise<ManagementPage | null>;
-    upsert(input: PageUpsertInput): Promise<ManagementPage>;
+    /** Correlated overloads — see {@link EntryOperations.upsert}. */
+    upsert(input: PageUpsertInput & {
+        publication: 'publish';
+    }): Promise<PagePublishUpsertResult>;
+    upsert(input: PageUpsertInput & {
+        publication?: 'draft';
+    }): Promise<ManagementPage>;
+    upsert(input: PageUpsertInput): Promise<ManagementPage | PagePublishUpsertResult>;
     publish(identifier: string): Promise<void>;
     unpublish(identifier: string): Promise<void>;
+    delete(identifier: string): Promise<void>;
 }
+export type ManagementPageBlock = SdkGetPageBlockResponse['block'];
+/**
+ * Input for `blocks.patch` — derived from the API contract.
+ * `baseContentHash` must be the `contentHash` from a prior `blocks.get`;
+ * a stale hash rejects with a 409 whose `fieldErrors[0].message` carries the
+ * current hash (field `baseContentHash`, code `STALE_CONTENT`).
+ */
+export type BlockPatchInput = SdkPatchPageBlockBody;
 export interface BlockOperations {
     list(pageIdentifier: string): Promise<ManagementBlock[]>;
-    get(pageIdentifier: string, blockIdentifier: string): Promise<ManagementBlock | null>;
+    get(pageIdentifier: string, blockIdentifier: string): Promise<ManagementPageBlock | null>;
     upsert(pageIdentifier: string, input: BlockUpsertInput): Promise<ManagementBlock>;
+    patch(pageIdentifier: string, blockIdentifier: string, input: BlockPatchInput): Promise<ManagementPageBlock>;
     reorder(pageIdentifier: string, blockIdentifiers: string[]): Promise<void>;
     delete(pageIdentifier: string, blockIdentifier: string): Promise<void>;
 }
@@ -903,6 +1021,11 @@ export interface CourseOperations {
 export interface PullOperations {
     entries(contentType?: string, options?: PaginationOptions): Promise<PulledEntries>;
     pages(): Promise<PulledPages>;
+    /**
+     * Cross-type overview of pages and entries with pending (unpublished) changes.
+     * Server-side filtered and fully enumerated.
+     */
+    drafts(): Promise<PulledDrafts>;
     navigation(): Promise<PulledNavigation>;
     settings(): Promise<PulledSettings>;
     forms(): Promise<PulledForms>;

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/content-types.d.ts

@@ -300,6 +300,8 @@ export interface NavigationMenuConfig {
     isPrimary?: boolean;
     /** Is this the footer menu? */
     isFooter?: boolean;
+    /** Named footer destination. Prefer this for new configurations. */
+    footerRole?: 'main' | 'legal-policy' | null;
     /** Menu items */
     items: NavigationItemConfig[];
 }

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

@@ -97,6 +97,10 @@ export declare const navigationMenuConfigSchema: z.ZodObject<{
     name: z.ZodString;
     isPrimary: z.ZodOptional<z.ZodBoolean>;
     isFooter: z.ZodOptional<z.ZodBoolean>;
+    footerRole: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        main: "main";
+        "legal-policy": "legal-policy";
+    }>>>;
     items: z.ZodArray<z.ZodType<Readonly<{
         label: string;
         link: import("../../../api/src/index").NavigationAuthoringLinkInput;

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

@@ -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;
@@ -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';