@riverbankcms/sdk 0.138.0 → 0.140.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/MailingListGlobalSettingsSummary.d.ts

@@ -0,0 +1,10 @@
+import type { MailingListAuthoringContext } from '../../../../api/src/index';
+import type { ReactElement } from 'react';
+/**
+ * The read-only "what every signup on this site shares" card. Editors only
+ * choose targeting; fields, confirmation and copy are set once by an
+ * administrator, so this tells them what they are working inside of.
+ */
+export declare function MailingListGlobalSettingsSummary({ context }: Readonly<{
+    context: MailingListAuthoringContext;
+}>): ReactElement | null;

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

@@ -0,0 +1,12 @@
+import type { FieldWidgetProps, GroupFieldConfig } from '../../../../block-form/src/index';
+import { type MailingListPlacementTargeting, type MailingListRuntimeContext } from '../../../../core/src/index';
+export { MailingListGlobalSettingsSummary } from './MailingListGlobalSettingsSummary';
+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,14 @@
+import { type ReactNode } from 'react';
+import type { MailingListAuthoringContext } from '../../../../api/src/index';
+import type { SiteId } from '../../../../core/src/index';
+export type MailingListAuthoringContextLoader = (siteId: SiteId) => Promise<MailingListAuthoringContext>;
+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,7 @@
+import type { MailingListAuthoringContext } from '../../../../api/src/index';
+import type { ApiClient } from '../../../../api/src/request';
+import type { SiteId } from '../../../../core/src/index';
+export declare function loadMailingListAuthoringContext(input: Readonly<{
+    apiClient: ApiClient;
+    siteId: SiteId;
+}>): Promise<MailingListAuthoringContext>;

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

@@ -0,0 +1,19 @@
+import { type MailingListPlacementTargeting, type MailingListRuntimeContext } from '../../../../core/src/index';
+type ConfiguredContext = Extract<MailingListRuntimeContext, {
+    tag: 'configured';
+}>;
+type CustomTargeting = Exclude<MailingListPlacementTargeting, {
+    mode: 'default';
+}>;
+/** The name of the site's default topic/list/audience, or null when it no longer exists. */
+export declare function defaultItemName(context: ConfiguredContext): string | null;
+/** What the editor is choosing between, in the provider's own words. */
+export declare function choiceNoun(context: ConfiguredContext, form?: 'singular' | 'plural'): string;
+export declare function providerDisplayName(context: ConfiguredContext): string;
+export declare function providerDefaultIsAvailable(context: ConfiguredContext): boolean;
+export declare function createInitialCustom(context: ConfiguredContext): CustomTargeting;
+export declare function changeSelectionMode(context: ConfiguredContext, targeting: CustomTargeting, mode: 'fixed' | 'visitor_choice'): CustomTargeting;
+export declare function canOfferVisitorChoice(context: ConfiguredContext, targeting: CustomTargeting): boolean;
+export declare function toggle(values: readonly string[], id: string): string[];
+export declare function toggleRequired(values: readonly string[], id: string): string[];
+export {};

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,31 @@ export type SitePrivacyPolicyDocument = {
     sections: SitePrivacyPolicySection[];
 };
 export type SiteLegalJurisdiction = 'UK' | 'US' | 'EU' | 'CA' | 'AU' | 'OTHER';
+export type SiteLegalIdentitySource = 'public' | 'custom';
 export type SiteLegalProfilePayload = {
     legalEntityName: string | null;
     privacyContactEmail: string | null;
     jurisdiction: SiteLegalJurisdiction;
+    legalEntityNameSource: SiteLegalIdentitySource;
+    privacyContactEmailSource: SiteLegalIdentitySource;
+    privacyPolicyPublished: boolean;
+};
+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;
@@ -269,10 +286,9 @@ export type SiteRouteRecord = {
     publishedAt?: string | null;
 };
 export type SiteBookingOfferingPresetSummary = ApiSiteBookingOfferingPresetSummary;
-/** Keep the SDK's selection metadata aligned with the runtime response. */
-type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | Extract<keyof ApiSiteBySlugResponse, `selection${string}`>>;
+type SiteSelectionResponse = Pick<ApiSiteBySlugResponse, 'theme' | 'themeId' | 'bookingAttribution' | Extract<keyof ApiSiteBySlugResponse, `selection${string}`>>;
 export type SiteResponse = SiteSelectionResponse & {
-    site: {
+    site: ApiSiteBySlugResponse['site'] & {
         id: string;
         title: string;
         slug: string;
@@ -295,9 +311,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;
@@ -335,6 +353,7 @@ export type SdkRuntimePage = {
     canonicalUrl?: string | null;
     blocks: Array<{
         id: string;
+        contentVersionId: string | null;
         kind: string;
         purpose?: string;
         content: Record<string, unknown>;
@@ -353,37 +372,34 @@ export type SdkTemplate = {
         bindings: Record<string, unknown> | null;
     }>;
 };
+type SdkSlotBlockIdentity = {
+    id: string;
+    blockId?: string;
+    contentVersionId: string;
+    kind: string;
+    purpose: string;
+    orderIndex?: number | null;
+    admission?: SdkBlockContentAdmission;
+};
 export type SdkEntrySlotContent = {
     entrySlotId: string;
     slotKey: string;
-    blocks: Array<{
-        id: string;
-        blockId?: string;
-        kind: string;
-        purpose: string;
-        orderIndex?: number | null;
+    blocks: Array<SdkSlotBlockIdentity & {
         content: Record<string, unknown> | null;
-        admission?: SdkBlockContentAdmission;
     }>;
 };
 export type SdkSurfaceSlotContent = {
     surfaceSlotId: string;
     pageSurfaceId: string;
     slotKey: string;
-    blocks: Array<{
-        id: string;
-        blockId?: string;
+    blocks: Array<SdkSlotBlockIdentity & {
         surfaceSlotId: string;
         identifier?: string | null;
-        kind: string;
-        purpose: string;
-        orderIndex?: number | null;
         content: Record<string, unknown>;
         draftContent?: unknown;
         publishedContent?: unknown;
         draftContentId?: string | null;
         publishedContentId?: string | null;
-        admission?: SdkBlockContentAdmission;
     }>;
 };
 export type SdkRuntimePageSurfaceSubject = ApiSdkRuntimePageSurfaceSubject;
@@ -534,16 +550,11 @@ export type PublicFormResponse = {
 export type PublicFormsResponse = {
     forms: FormRecord[];
 };
-export type PublicBookingService = {
-    id: string;
-    siteId: string;
-    title: string;
-    description: string | null;
-    durationMinutes: number;
-    consent?: BookingConsent;
-};
+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

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import type { BlockLoaderFailures } from '../../../blocks/src/system/data/index';
 import type { RenderablePageOutline as BlocksRenderablePageOutline } from '../../../blocks/src/index';
 import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, PageRuntimeBoundary, ResolveImageUrlContextInput, RouteMap, Theme, ThemeTokens } from '../contracts';
 import type { SdkCustomBlock } from '../config/types';
@@ -20,8 +21,12 @@ 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>>;
+    loaderFailures?: BlockLoaderFailures;
     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;