@riverbankcms/sdk 0.138.0 → 0.139.0

package/dist/_dts/editor-blocks/src/widgets/index.d.ts

@@ -4,6 +4,7 @@ export * from './entry-picker/index';
 export * from './icon-picker/index';
 export * from './inline-text/index';
 export * from './link/index';
+export * from './mailing-list-targeting/index';
 export * from './offerings-preview/index';
 export * from './reference/index';
 export * from './rich-text/index';

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/MailingListTargetingField.d.ts

@@ -0,0 +1,11 @@
+import type { FieldWidgetProps, GroupFieldConfig } from '../../../../block-form/src/index';
+import { type MailingListPlacementTargeting, type MailingListRuntimeContext } from '../../../../core/src/index';
+export declare function MailingListTargetingField({ path, backend, config }: FieldWidgetProps<MailingListPlacementTargeting, GroupFieldConfig>): import("react").JSX.Element;
+export declare function MailingListTargetingControl({ context, targeting, onChange, name }: Readonly<{
+    context: Extract<MailingListRuntimeContext, {
+        tag: 'configured';
+    }>;
+    targeting: MailingListPlacementTargeting;
+    onChange: (value: MailingListPlacementTargeting) => void;
+    name: string;
+}>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/context.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+import type { MailingListRuntimeContext, SiteId } from '../../../../core/src/index';
+export type MailingListAuthoringContextLoader = (siteId: SiteId) => Promise<MailingListRuntimeContext>;
+type Value = Readonly<{
+    siteId: SiteId;
+    load: MailingListAuthoringContextLoader;
+    manageHref?: string;
+}>;
+export declare function MailingListTargetingProvider({ children, load, manageHref, siteId, }: Value & Readonly<{
+    children: ReactNode;
+}>): import("react").JSX.Element;
+export declare function useMailingListTargetingContext(): Value;
+export {};

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/index.d.ts

@@ -0,0 +1,3 @@
+export * from './context';
+export * from './loaders';
+export * from './MailingListTargetingField';

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/loaders.d.ts

@@ -0,0 +1,6 @@
+import type { ApiClient } from '../../../../api/src/request';
+import type { MailingListRuntimeContext, SiteId } from '../../../../core/src/index';
+export declare function loadMailingListAuthoringContext(input: Readonly<{
+    apiClient: ApiClient;
+    siteId: SiteId;
+}>): Promise<MailingListRuntimeContext>;

package/dist/_dts/preview-next/src/client/widgets/widgetOverrides.d.ts

@@ -30,6 +30,7 @@ export declare const previewWidgetOverrides: {
     readonly buttonVariant: FieldWidgetComponent;
     readonly offeringGroupOrder: FieldWidgetComponent;
     readonly siteOptionPicker: FieldWidgetComponent;
+    readonly mailingListTargeting: FieldWidgetComponent;
 };
 export type { FieldWidgetComponent };
 export { __testUtils, createPreviewEntryPickerAdapter, createPreviewLinkAdapters, createPreviewReferenceAdapters, createPreviewSiteOptionAdapters, };

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

@@ -0,0 +1,12 @@
+import type { ApiClient, ApiResult } from '../../../api/src/public/index';
+import type { PublicReadEndpoint } from '../../../blocks/src/system/data/index';
+import type { RiverbankClient } from './types';
+type PublicAppointmentReadDeps = Readonly<{
+    apiClient: ApiClient;
+    resilientFetchData: <T>(policyEndpoint: PublicReadEndpoint, cacheKey: string, fetcher: (signal: AbortSignal) => Promise<ApiResult<T>>, options: Readonly<{
+        signal?: AbortSignal;
+    }>) => Promise<T>;
+}>;
+export type PublicAppointmentReadOperations = Pick<RiverbankClient, 'getPublicBookingServices' | 'getPublicWeeklySlotAvailability'>;
+export declare function createPublicAppointmentReadOperations(deps: PublicAppointmentReadDeps): PublicAppointmentReadOperations;
+export {};

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

@@ -1,8 +1,9 @@
 import type { ApiClient, ApiResult } from '../../../api/src/public/index';
+import type { PublicReadEndpoint } from '../../../blocks/src/system/data/index';
 import type { RiverbankClient } from './types';
 type PublicEventReadDeps = Readonly<{
     apiClient: ApiClient;
-    resilientFetchData: <T>(cacheKey: string, fetcher: (signal: AbortSignal) => Promise<ApiResult<T>>, options: Readonly<{
+    resilientFetchData: <T>(policyEndpoint: PublicReadEndpoint, cacheKey: string, fetcher: (signal: AbortSignal) => Promise<ApiResult<T>>, options: Readonly<{
         signal?: AbortSignal;
         force?: boolean;
     }>) => Promise<T>;

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

@@ -1,6 +1,13 @@
-import { type SupportedLoaderEndpoint } from '../../../blocks/src/system/data/index';
 export declare function shouldWrite(cacheEnabled: boolean, force: boolean | undefined): boolean;
-export declare function liveLoaderOptions(endpoint: SupportedLoaderEndpoint, signal: AbortSignal | undefined): Readonly<{
-    force: boolean;
-    signal: AbortSignal | undefined;
+/**
+ * Applies the canonical block-loader freshness policy at the SDK fetch seam.
+ *
+ * Callers provide the endpoint identity, but do not opt into live behavior.
+ * This makes a newly-live endpoint bypass memory and fallback caches without a
+ * second method-level wiring change.
+ */
+export declare function applyPublicLoaderCachePolicy<TOptions extends Readonly<{
+    force?: boolean;
+}>>(endpoint: string, options: TOptions): TOptions & Readonly<{
+    force?: boolean;
 }>;

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

@@ -281,9 +281,7 @@ export type NavigationItemConfig = NavigationConfigItemInput;
  * @example
  * ```typescript
  * {
- *   identifier: 'main',
- *   name: 'Main Navigation',
- *   isPrimary: true,
+ *   location: 'main',
  *   items: [
  *     { label: 'Home', link: { kind: 'page', identifier: 'home' } },
  *     { label: 'About', link: { kind: 'page', identifier: 'about' } },
@@ -292,16 +290,8 @@ export type NavigationItemConfig = NavigationConfigItemInput;
  * ```
  */
 export interface NavigationMenuConfig {
-    /** Unique identifier for this menu */
-    identifier: string;
-    /** Menu display name */
-    name: string;
-    /** Is this the primary/main menu? */
-    isPrimary?: boolean;
-    /** Is this the footer menu? */
-    isFooter?: boolean;
-    /** Named footer destination. Prefer this for new configurations. */
-    footerRole?: 'main' | 'legal-policy' | null;
+    /** Fixed site destination. */
+    location: 'main' | 'footer' | 'legal';
     /** Menu items */
     items: NavigationItemConfig[];
 }

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

@@ -93,14 +93,11 @@ export declare const entryConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const navigationItemConfigSchema: z.ZodType<NavigationConfigItemInput>;
 export declare const navigationMenuConfigSchema: z.ZodObject<{
-    identifier: z.ZodString;
-    name: z.ZodString;
-    isPrimary: z.ZodOptional<z.ZodBoolean>;
-    isFooter: z.ZodOptional<z.ZodBoolean>;
-    footerRole: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    location: z.ZodEnum<{
         main: "main";
-        "legal-policy": "legal-policy";
-    }>>>;
+        legal: "legal";
+        footer: "footer";
+    }>;
     items: z.ZodArray<z.ZodType<Readonly<{
         label: string;
         link: import("../../../api/src/index").NavigationAuthoringLinkInput;
@@ -112,7 +109,7 @@ export declare const navigationMenuConfigSchema: z.ZodObject<{
         isCta?: boolean;
         children?: readonly NavigationConfigItemInput[];
     }>, unknown>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export declare const siteSettingsConfigSchema: z.ZodObject<{
     homepagePath: z.ZodOptional<z.ZodString>;
     siteTitle: z.ZodOptional<z.ZodString>;

package/dist/_dts/sdk/src/constants.d.ts

@@ -10,14 +10,14 @@
 export declare const PREBUILD_PAGE_SIZE = 50;
 /**
  * Default ISR revalidation interval in seconds.
- * 5 minutes provides a good balance between freshness and performance.
+ * Public pages can contain availability, whose freshness contract is 60 seconds.
  */
-export declare const ISR_REVALIDATE_SECONDS = 300;
+export declare const ISR_REVALIDATE_SECONDS = 60;
 /**
  * Default cache TTL in seconds.
  * Matches ISR_REVALIDATE_SECONDS for consistency.
  */
-export declare const CACHE_TTL_SECONDS = 300;
+export declare const CACHE_TTL_SECONDS = 60;
 /**
  * Default maximum age for prebuild cache in seconds.
  * 24 hours - older prebuilds are rejected.

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

@@ -1,5 +1,5 @@
 export type { TipTapNode, TipTapMark, RichTextDoc, 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, CardRole, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, IntroContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, OfferingsPreviewContent, 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 { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CartContent, CardRole, CardStylesContent, CheckoutContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, IntroContent, LocationMapContent, LayoutAlign, LayoutWidth, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, OfferingsPreviewContent, 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

@@ -9,6 +9,8 @@ import type { EventRegistrationContent } from './event-registration-content';
 export type { EventRegistrationContent } from './event-registration-content';
 import type { Brand, EventCategoryId, RichTextDoc, VenueId } from '../../../core/src/index';
 import type { SiteFooterContent as BlocksSiteFooterContent } from '../../../blocks/src/system/blocks/site-footer';
+import type { NewsletterSignupContent as BlocksNewsletterSignupContent } from '../../../blocks/src/system/blocks/newsletter-signup';
+import type { ContactNewsletterContent as BlocksContactNewsletterContent } from '../../../blocks/src/system/blocks/contact-newsletter';
 import type { EventDetailsContent as BlocksEventDetailsContent } from '../../../blocks/src/system/blocks/event-details';
 import type { EventCalendarContent as BlocksEventCalendarContent } from '../../../blocks/src/system/blocks/events/event-calendar';
 import type { CalendarTabViews as BlocksCalendarTabViews, CalendarView as BlocksCalendarView, ColumnOption as BlocksColumnOption, DisplayMode as BlocksDisplayMode, EventLayout as BlocksEventLayout, FilterAutoShow as BlocksFilterAutoShow, WeekStart as BlocksWeekStart } from '../../../blocks/src/system/blocks/events/shared/types';
@@ -230,6 +232,8 @@ export type OfferingsPreviewGroupOverride = {
 };
 export type OfferingsPreviewGroupOrder = readonly OfferingsPreviewSourceKey[];
 export type OfferingsPreviewContent = {
+    /** Internal system composition; not exposed as an editor control. */
+    displayMode?: 'preview' | 'catalogue';
     heading?: string | null;
     description?: unknown;
     itemLimit?: '1' | '2' | '3' | '4' | '5' | '6' | null;
@@ -380,20 +384,7 @@ export type MediaTextContent = {
     /** Compiler-owned: the frame a Look asks for around the block's content. */
     _frameStyles?: ContentFrameIntent | null;
 };
-export type NewsletterSignupPreset = 'emailOnly' | 'emailName' | 'emailFirstLast' | 'emailNameCompany';
-export type NewsletterSignupContent = {
-    title?: string | null;
-    subtitle?: RichTextDoc | null;
-    listId?: string | null;
-    preset: NewsletterSignupPreset;
-    includePhone?: boolean | null;
-    buttonLabel?: string | null;
-    buttonVariant?: ButtonVariant | null;
-    successMessage?: string | null;
-    privacyNote?: string | null;
-    tags?: string | null;
-    _sectionStyles?: SectionStylesContent;
-};
+export type NewsletterSignupContent = BlocksNewsletterSignupContent;
 export type RecurringScheduleContent = {
     eyebrow?: string | null;
     heading?: string | null;
@@ -407,23 +398,7 @@ export type RecurringScheduleContent = {
     emptyMessage?: string | null;
     _sectionStyles?: SectionStylesContent;
 };
-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;
-    contactTitle?: string | null;
-    contactIntro?: RichTextDoc | null;
-    formSlug: string;
-    contactSubmitLabel?: string | null;
-    contactSuccessMessage?: string | null;
-    _sectionStyles?: SectionStylesContent;
-};
+export type ContactNewsletterContent = BlocksContactNewsletterContent;
 export type ShopContent = {
     showPasses?: boolean | null;
     showMemberships?: boolean | null;
@@ -581,6 +556,11 @@ export type AppointmentBookingContent = {
     description?: unknown;
     _sectionStyles?: SectionStylesContent;
 };
+export type AppointmentServicesContent = {
+    heading?: string | null;
+    description?: unknown;
+    _sectionStyles?: SectionStylesContent;
+};
 export type WeeklySlotAvailabilityContent = {
     serviceId: string;
     resourceId?: string | null;
@@ -659,6 +639,7 @@ export type SystemBlockContentByFullKind = {
     'block.form': FormBlockContent;
     'block.contact-newsletter': ContactNewsletterContent;
     'block.appointment-booking': AppointmentBookingContent;
+    'block.appointment-services': AppointmentServicesContent;
     'block.weekly-slot-availability': WeeklySlotAvailabilityContent;
     'block.event-registration': EventRegistrationContent;
     'block.event-details': EventDetailsContent;

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

@@ -259,39 +259,36 @@ export type SimpleMenuViewModel = Menu;
 /** @deprecated Use `Logo` instead */
 export type SimpleLogo = Logo;
 /**
- * Get the primary navigation menu object.
- * Returns menu marked as isPrimary, or first menu if none marked.
+ * Get the fixed main navigation menu object.
+ * Returns null when the runtime payload is incomplete.
  *
  * @example
  * ```ts
  * const menu = getPrimaryNavigation(siteData.navigation);
- * console.log(menu?.name); // "main"
+ * console.log(menu?.location); // "main"
  * ```
  */
 export declare function getPrimaryNavigation(navigation: NavigationMenuWithItems[] | null | undefined): NavigationMenuWithItems | null;
 /**
- * Get the footer navigation menu object.
- * Returns menu marked as isFooter, or null if none marked.
+ * Get the fixed footer navigation menu object.
  *
  * @example
  * ```ts
  * const menu = getFooterNavigation(siteData.navigation);
- * console.log(menu?.name); // "Footer menu"
+ * console.log(menu?.location); // "footer"
  * ```
  */
 export declare function getFooterNavigation(navigation: NavigationMenuWithItems[] | null | undefined): NavigationMenuWithItems | null;
 export declare function getFooterNavigationByRole(navigation: NavigationMenuWithItems[] | null | undefined, role: 'main' | 'legal-policy'): NavigationMenuWithItems | null;
 /**
- * Get a navigation menu by name/slug.
- *
- * @example
- * ```ts
- * const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');
- * ```
+ * Select one of the three fixed navigation destinations.
+ * A canonical payload has exactly one menu for each location; returning null
+ * keeps malformed or incomplete payloads visible to the caller rather than
+ * borrowing a different location's links.
  */
-export declare function getNavigationBySlug(navigation: NavigationMenuWithItems[] | null | undefined, slug: string): NavigationMenuWithItems | null;
+export declare function getNavigationByLocation(navigation: NavigationMenuWithItems[] | null | undefined, location: 'main' | 'footer' | 'legal'): NavigationMenuWithItems | null;
 /**
- * Get nav items from the primary menu (marked isPrimary, or first menu).
+ * Get nav items from the fixed main menu.
  * Returns nested structure supporting both links and dropdowns.
  * For canonical links (`kind: 'page' | 'entry'`), pass `routes` + identifier maps in options.
  *
@@ -310,21 +307,6 @@ export declare function getNavigationBySlug(navigation: NavigationMenuWithItems[
  * ```
  */
 export declare function getPrimaryNavItems(navigation: NavigationMenuWithItems[], options?: NavigationRenderOptions): NavItem[];
-/**
- * Get nav items from a specific menu by slug.
- * Returns nested structure supporting both links and dropdowns.
- * For canonical links (`kind: 'page' | 'entry'`), pass `routes` + identifier maps in options.
- *
- * @example
- * ```ts
- * const footerNav = getNavItemsBySlug(siteData.navigation, 'footer', {
- *   routes: siteData.routes,
- *   pagesByIdentifier: siteData.pagesByIdentifier,
- *   entriesByIdentifier: siteData.entriesByIdentifier,
- * });
- * ```
- */
-export declare function getNavItemsBySlug(navigation: NavigationMenuWithItems[], slug: string, options?: NavigationRenderOptions): NavItem[];
 /**
  * Transform a menu into NavItem array.
  * Builds nested structure from flat items, supporting dropdowns with children.

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

@@ -49,14 +49,14 @@ export { createSitemap, type CreateSitemapOptions, type SitemapGenerator, } from
 export { createRobots, type CreateRobotsOptions } from './robots';
 /**
  * ISR revalidation duration in seconds for production mode.
- * 5 minutes provides a good balance between freshness and performance.
+ * Public pages can contain availability, whose freshness contract is 60 seconds.
  */
-export declare const ISR_REVALIDATE_SECONDS = 300;
+export declare const ISR_REVALIDATE_SECONDS = 60;
 export interface ISRConfig {
     /**
      * Revalidation interval in seconds.
      * - 0: Dynamic rendering (no caching) - used in preview mode
-     * - 300: 5 minute ISR - used in production mode
+     * - 60: one minute ISR - used in production mode
      */
     revalidate: number | false;
     /**
@@ -70,7 +70,7 @@ export interface ISRConfig {
  *
  * Do not use the returned value directly in a Next.js route-segment config
  * export. Next statically analyzes those exports and requires a literal such as
- * `export const revalidate = 300`.
+ * `export const revalidate = 60`.
  *
  * @deprecated Next.js route-segment config must be statically analyzable, which
  * was this helper's intended use. Export a literal `revalidate` value and use

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

@@ -138,12 +138,8 @@ export interface EntriesCacheFile {
 export interface NavigationCacheFile {
     /** Navigation menu data */
     menus: Array<{
-        /** Menu identifier (used as lookup key) */
-        identifier: string | null;
-        /** Menu ID (fallback if no identifier) */
         id: string;
-        /** Menu display name */
-        name: string;
+        location: 'main' | 'footer' | 'legal';
         /** Navigation items in this menu */
         items: NavigationItemRecord[];
     }>;

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

@@ -1,6 +1,6 @@
-import type { AddressedLocationValue, BookingConsent, BusinessAddress } from '../../../core/src/index';
+import type { AddressedLocationValue, BusinessAddress } from '../../../core/src/index';
 import type { ResolvedInternalLinkEntityType } from '../../../blocks/src/index';
-import type { APIEndpoints, RoutableContentItem as ApiRoutableContentItem, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject, SiteBySlugResponse as ApiSiteBySlugResponse, SiteBookingOfferingPresetSummary as ApiSiteBookingOfferingPresetSummary, SdkBlockContentAdmission } from '../../../api/src/index';
+import type { APIEndpoints, PublicBookingService as ApiPublicBookingService, RoutableContentItem as ApiRoutableContentItem, SdkRuntimePageSurfaceSubject as ApiSdkRuntimePageSurfaceSubject, SiteBySlugResponse as ApiSiteBySlugResponse, SiteBookingOfferingPresetSummary as ApiSiteBookingOfferingPresetSummary, SdkBlockContentAdmission } from '../../../api/src/index';
 import type { MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent } from '../contracts';
 import type { CompiledBoundaryRuntime } from '../../../theme-core/src/site-styles/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';
@@ -169,11 +169,7 @@ export interface NavigationItemRecord {
 }
 export interface NavigationMenuRecord {
     id: string;
-    identifier: string | null;
-    name: string;
-    isPrimary: boolean;
-    isFooter: boolean;
-    footerRole: 'main' | 'legal-policy' | null;
+    location: 'main' | 'footer' | 'legal';
     createdAt?: string | null;
     updatedAt?: string | null;
 }
@@ -226,10 +222,33 @@ export type SitePrivacyPolicyDocument = {
     sections: SitePrivacyPolicySection[];
 };
 export type SiteLegalJurisdiction = 'UK' | 'US' | 'EU' | 'CA' | 'AU' | 'OTHER';
+/** Mirrors `SiteLegalIdentitySource` in `@riverbankcms/api`. */
+export type SiteLegalIdentitySource = 'public' | 'custom';
 export type SiteLegalProfilePayload = {
     legalEntityName: string | null;
     privacyContactEmail: string | null;
     jurisdiction: SiteLegalJurisdiction;
+    legalEntityNameSource: SiteLegalIdentitySource;
+    privacyContactEmailSource: SiteLegalIdentitySource;
+    privacyPolicyPublished: boolean;
+};
+/** Mirrors `SiteRuntimeBusinessDetails` in `@riverbankcms/api`. */
+export type SiteRuntimeBusinessDetails = {
+    tagline: string | null;
+    contact: {
+        kind: 'phone';
+        phone: string;
+        email: null;
+    } | {
+        kind: 'email';
+        phone: null;
+        email: string;
+    } | {
+        kind: 'phone-and-email';
+        phone: string;
+        email: string;
+    } | null;
+    addressVisibility: 'shown' | 'hidden';
 };
 export type SiteRuntimePrivacyPolicy = {
     path: string;
@@ -295,9 +314,11 @@ export type SiteResponse = SiteSelectionResponse & {
     portalEnabled?: boolean;
     commerceEnabled?: boolean;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    mailingList?: import('../../../core/src/index').MailingListRuntimeContext;
     bookingTimeZone?: string;
     analytics?: SiteAnalyticsSettingsPayload;
     privacyPolicy?: SiteRuntimePrivacyPolicy;
+    businessDetails?: SiteRuntimeBusinessDetails;
     routes: Record<string, SiteRouteRecord>;
     layout: SiteLayoutResolvedPayload;
     customDomain: string | null;
@@ -534,16 +555,12 @@ export type PublicFormResponse = {
 export type PublicFormsResponse = {
     forms: FormRecord[];
 };
-export type PublicBookingService = {
-    id: string;
-    siteId: string;
-    title: string;
-    description: string | null;
-    durationMinutes: number;
-    consent?: BookingConsent;
-};
+/** Visitor-facing appointment service, shared with the API redaction boundary. */
+export type PublicBookingService = ApiPublicBookingService;
 export type PublicBookingServicesResponse = {
-    services: PublicBookingService[];
+    services: Array<Omit<PublicBookingService, 'description'> & {
+        description?: string;
+    }>;
 };
 export type PublicWeeklySlotAvailabilityOption = {
     id: string;

package/dist/_dts/sdk/src/rendering/blocks-page-renderer.d.ts

@@ -20,8 +20,11 @@ export declare const MissingBlockOverrideError: MissingBlockOverrideErrorConstru
 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>>;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    mailingList?: import('../../../core/src/index').MailingListRuntimeContext;
     bookingTimeZone?: string;
     previewStage?: 'published' | 'preview';
     routes?: RouteMap;

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

@@ -1,4 +1,5 @@
 import { type ReactElement, type ReactNode } from 'react';
+import { type BlockApiClient } from '../../../blocks/src/client';
 export type BlockApiAuth = Readonly<{
     type: 'api-key';
     key: string;
@@ -14,26 +15,8 @@ export type BlockApiConfig = Readonly<{
     siteId?: string;
     isPreview?: boolean;
 }>;
-export type NewsletterSubscribeInput = Readonly<{
-    email: string;
-    firstName?: string;
-    lastName?: string;
-    name?: string;
-    company?: string;
-    phone?: string;
-    target: Readonly<{
-        tag: 'published_block_ref';
-        destinationRef: Readonly<{
-            tag: 'block_ref';
-            blockId: string;
-        }>;
-    }>;
-    tags?: string[];
-}>;
-export type NewsletterSubscribeResult = Readonly<{
-    subscribed: boolean;
-    requiresConfirmation?: boolean;
-}>;
+export type NewsletterSubscribeInput = Parameters<BlockApiClient['subscribeNewsletter']>[0];
+export type NewsletterSubscribeResult = Awaited<ReturnType<BlockApiClient['subscribeNewsletter']>>;
 export declare function BlockApiProvider({ config, children, }: Readonly<{
     config: BlockApiConfig;
     children: ReactNode;

package/dist/_dts/sdk/src/rendering/components/pageShared.d.ts

@@ -14,6 +14,7 @@ type PageCommonProps = {
     siteId: string;
     resolvedData?: ResolvedBlockData;
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
+    mailingList?: import('../../../../core/src/index').MailingListRuntimeContext;
     bookingTimeZone?: string;
     routeMap?: RouteMap;
     /** Page identifier to routeId lookup for { kind: 'page' } CTA links */
@@ -73,6 +74,8 @@ type PageCommonProps = {
         editableRouteMetadataFieldIds?: ReadonlyArray<string> | null;
         /** Preview stage: 'preview' for draft content, 'published' for live content */
         previewStage?: 'preview' | 'published';
+        /** Canonical request pathname used by blocks when resolving same-site destinations. */
+        pathname?: string;
     };
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
     registry?: ComponentRegistry;

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

@@ -7,6 +7,7 @@
 import type { MediaAssetIndexItem, RouteMap, Theme } from '../../contracts';
 import type { RiverbankClient, PageResponse, SiteResponse } from '../../client/types';
 import type { SdkRuntimePageSurfaceSubject } from '../../public-api/contracts';
+import type { MailingListRuntimeContext } from '../../../../core/src/index';
 import type { PageProps } from '../components/Page';
 import type { ResolvedBlockData } from '../../data/prefetchBlockData';
 import { type ResolveBlockDataDeps } from '../../data/resolveBlockData';
@@ -111,6 +112,7 @@ export type PageContentResult = {
     resolvedData: ResolvedBlockData;
     /** Selected booking offering presets exposed to SSR blocks. */
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    mailingList?: MailingListRuntimeContext;
     bookingTimeZone?: string;
     /** Site data for metadata generation */
     site: SiteData;
@@ -147,6 +149,7 @@ export type EntryContentResult = {
     resolvedData: ResolvedBlockData;
     /** Selected booking offering presets exposed to SSR blocks. */
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    mailingList?: MailingListRuntimeContext;
     bookingTimeZone?: string;
     /** Data context for template blocks (includes entry content for bindings) */
     dataContext: {
@@ -211,6 +214,7 @@ export type PageSurfaceContentResult = {
     templatePage: PageProps['page'] | null;
     resolvedData: ResolvedBlockData;
     bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
+    mailingList?: MailingListRuntimeContext;
     bookingTimeZone?: string;
     dataContext: {
         pageSurface: Record<string, unknown>;

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

@@ -10,6 +10,7 @@ export type SiteRenderSupport = Readonly<{
     site: SiteData;
     sdkConfig: RuntimeSdkConfig | null;
     bookingOfferingPresets: readonly SiteBookingOfferingPresetSummary[];
+    mailingList?: import('../../../../core/src/index').MailingListRuntimeContext;
     bookingTimeZone: string;
     customBlocks?: SdkCustomBlock[];
     supabaseUrl?: string;

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

@@ -21,7 +21,7 @@ export { loadContent, isPageContent, isEntryContent, isPageSurfaceContent, } fro
 export type { LoadContentParams, LoadContentResult, ContentEntryData, PagePreviewMetadata, SiteData, } from './helpers/loadContent';
 export { buildFooterRenderablePageOutline } from './helpers/footerPageOutline';
 export type { BlockLoaderMap, DataLoaderContext, DataLoaderFn, DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams, DataLoaderValue, } from '../data/types';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, CardRole, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, IntroContent, LayoutAlign, LayoutWidth, Media, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, OfferingsPreviewContent, RichTextDoc, TipTapNode, TipTapMark, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, Theme, ThemeTokens, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, MediaAssetIndexItem, ImageOptions, ResolveImageUrlContext, ResolveImageUrlContextInput, ResolveImageSourceSetOptions, ResolvedImageSourceSet, } from '../contracts';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, ContentFrameIntent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, CardRole, FeatureCardLegacySurfaceRole, FeatureCardSurfaceRole, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, IntroContent, LayoutAlign, LayoutWidth, Media, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, OfferingsPreviewContent, RichTextDoc, TipTapNode, TipTapMark, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, Theme, ThemeTokens, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, MediaAssetIndexItem, ImageOptions, ResolveImageUrlContext, ResolveImageUrlContextInput, ResolveImageSourceSetOptions, ResolvedImageSourceSet, } from '../contracts';
 export { ImagePresets } from '../contracts';
 export { RichText } from './primitives/RichText';
 export { resolveImageUrl, resolveImageUrlWithContext, resolveImageSourceSetWithContext, } from './image';

package/dist/_dts/sdk/src/types/block-kinds.d.ts

@@ -7,7 +7,7 @@
  * `@riverbankcms/blocks` (which is not a public dependency). This list is a
  * stable public contract; keep it in sync with the internal blocks runtime.
  */
-export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.contact-newsletter", "block.appointment-booking", "block.weekly-slot-availability", "block.event-registration", "block.event-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.recurring-schedule", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
+export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.contact-newsletter", "block.appointment-booking", "block.appointment-services", "block.weekly-slot-availability", "block.event-registration", "block.event-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.recurring-schedule", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
 export type SystemBlockKind = (typeof SYSTEM_BLOCK_KINDS)[number];
 export type CustomBlockKind = `custom.${string}`;
 export type BlockKind = SystemBlockKind | CustomBlockKind;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.138.0";
+export declare const SDK_VERSION = "0.139.0";