@riverbankcms/sdk 0.145.0 → 0.146.0

package/dist/_dts/blocks/src/system/runtime/resolver.d.ts

@@ -4,6 +4,7 @@ import { bindingSchema } from "../node";
 import { type ThemeTokens } from "../theme";
 import type { TransformRegistry, RouteMap, PageIdentifierMap, EntryIdentifierMap } from "../transforms";
 import type { ResolveImageUrlContext } from "./nodes/media";
+import type { NewsletterBlockSubmission } from './nodes/newsletter-form.block-submission';
 export type ViewModel = Record<string, unknown>;
 export type ComponentRegistry = Record<string, React.ElementType>;
 export type PreviewTextFieldConstraints = Readonly<{
@@ -30,7 +31,7 @@ export type ResolverContext = {
     entriesByIdentifier?: EntryIdentifierMap;
     pathBase?: string;
     blockId?: string | null;
-    contentVersionId?: string | null;
+    newsletterBlockSubmission?: NewsletterBlockSubmission;
     blockKind?: string;
     blockContent?: unknown;
     blockBindings?: Record<string, unknown>;

package/dist/_dts/blocks/src/system/runtime/shared/components/CheckboxChoice.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+type CheckboxChoiceProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'className'> & Readonly<{
+    label: React.ReactNode;
+    /**
+     * `row` for options and plain checkbox fields. `tile` for agreements the
+     * customer must accept (booking consent, consent fields): a bordered,
+     * fully clickable panel that tints when ticked.
+     */
+    presentation?: 'row' | 'tile';
+    className?: string;
+}>;
+/**
+ * The customer-facing checkbox every block renders. Styling comes from the
+ * theme's input CSS (`.form-check`, `.form-checkbox`), so it follows each
+ * site's input colours, borders and corners.
+ */
+export declare function CheckboxChoice({ label, presentation, className, ...inputProps }: CheckboxChoiceProps): React.ReactElement;
+export {};

package/dist/_dts/blocks/src/system/runtime/shared/components/index.d.ts

@@ -1,6 +1,7 @@
 /**
  * Shared Components Barrel Export
  */
+export { CheckboxChoice } from './CheckboxChoice';
 export { CheckIcon } from './CheckIcon';
 export { ClockIcon } from './ClockIcon';
 export { CrossIcon } from './CrossIcon';

package/dist/_dts/content-editor/src/index.d.ts

@@ -21,6 +21,7 @@ export { useUISelector } from './ui/useUISelector';
 export { EditorUiStoreProvider, useEditorUiStore, useEditorUiStoreInstance, useOptionalEditorUiStoreInstance, createEditorUiStore, } from './ui/editorUiStore';
 export type { ActivePreviewField, EditorUiStoreInstance, EditorUiState, EditorPreviewInspectorStore, EditorLinkedEntrySnapshot, PreviewDesignRow, PreviewDesignOpenRequest, PreviewEditorOpenIntent, PreviewInspection, PreviewSidebarTab, ViewportMode, ViewportWidth, ViewportState, ZoomLevel, } from './ui/editorUiStore';
 export { PreviewTextEditor } from './primitives/PreviewTextEditor';
+export { PREVIEW_EDITABLE_OUTLINE, PREVIEW_EDITABLE_OUTLINE_OFFSET, } from './primitives/previewEditableOutline';
 export { PreviewInlineTextEditor } from './primitives/PreviewInlineTextEditor';
 export { PreviewRichTextEditor } from './primitives/PreviewRichTextEditor';
 export { recordsEqual as editorValuesEqual } from './ui/stores/utils';

package/dist/_dts/content-editor/src/primitives/previewEditableOutline.d.ts

@@ -0,0 +1,2 @@
+export declare const PREVIEW_EDITABLE_OUTLINE = "1px dashed rgba(156, 163, 175, 0.75)";
+export declare const PREVIEW_EDITABLE_OUTLINE_OFFSET = "2px";

package/dist/_dts/content-editor/src/ui/editorBlockEquality.d.ts

@@ -0,0 +1,3 @@
+import type { NormalizedEditorBlockItem } from './editorSnapshot';
+export declare function normalizedBlockEqual(left: NormalizedEditorBlockItem, right: NormalizedEditorBlockItem): boolean;
+export declare function normalizedBlocksEqual(left: readonly NormalizedEditorBlockItem[], right: readonly NormalizedEditorBlockItem[]): boolean;

package/dist/_dts/content-editor/src/ui/editorSnapshot.d.ts

@@ -1,4 +1,4 @@
-import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
+import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type BlockContentIdentity, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
 import { type LinkedContentEntryId, type LinkedContentTypeKey } from '../linkedEntries/domain';
 export { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockId, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorSiteId, };
 export type EditorCommand = {
@@ -119,9 +119,8 @@ export type DraftBlockInitMetaInput = EditorDraftBlockInitMetaInput;
 export type DraftBlockBaselineUpdateMetaInput = EditorDraftBlockBaselineUpdateMetaInput;
 export type DraftBlockBaselineInput = EditorBlockBaselineInput;
 export type BlockPublishedBaselineInput = EditorBlockPublishedBaselineInput;
-export type EditorBlockItem = Readonly<{
+export type EditorBlockItem = Partial<BlockContentIdentity> & Readonly<{
     id?: string | null;
-    contentVersionId?: string | null;
     kind: string;
     content?: EditorValueRecord | null;
     orderIndex?: number | null;
@@ -131,8 +130,7 @@ export type EditorBlockItem = Readonly<{
     purpose?: string | null;
     optimisticHash?: string | null;
 }>;
-type NormalizedEditorBlockBase = Readonly<{
-    contentVersionId: string | null;
+type NormalizedEditorBlockBase = BlockContentIdentity & Readonly<{
     kind: string;
     content: EditorBlockValues | null;
     orderIndex: number | null;

package/dist/_dts/core/src/block-content-identity.d.ts

@@ -0,0 +1,5 @@
+/** A block version ID is meaningful only with its draft or published stage. */
+export type BlockContentIdentity = Readonly<{
+    draftContentId: string | null;
+    publishedContentId: string | null;
+}>;

package/dist/_dts/core/src/editor-state.d.ts

@@ -1,4 +1,5 @@
 import type { Brand } from './branded';
+import type { BlockContentIdentity } from './block-content-identity';
 export type EditorSiteId = Brand<string, 'EditorSiteId'>;
 export type EditorPageId = Brand<string, 'EditorPageId'>;
 export type EditorEntryId = Brand<string, 'EditorEntryId'>;
@@ -61,14 +62,8 @@ export type EditorBlockPublishedBaselineInput = Readonly<{
     kind?: string;
     publishedContent?: EditorBlockBaselineInput;
 }>;
-export type EditorPersistedBlock = Readonly<{
+export type EditorPersistedBlock = BlockContentIdentity & Readonly<{
     id: EditorBlockId;
-    /**
-     * The content version the block was loaded with. Runtime blocks that
-     * submit to the API (newsletter signup) cite it so the server can verify
-     * the placement, so the editor must carry it rather than strip it.
-     */
-    contentVersionId?: string | null;
     kind: string;
     content: EditorBlockValues | null;
     orderIndex: number | null;

package/dist/_dts/core/src/index.d.ts

@@ -30,6 +30,7 @@ export { tryAsync } from './try-async';
 export * from './narrow-result';
 export * from './non-empty-array';
 export * from './editor-state';
+export * from './block-content-identity';
 export * from './sensitive-collection';
 export * from './assertNever';
 export * from './participants';

package/dist/_dts/core/src/mailing-list-submission.d.ts

@@ -49,7 +49,9 @@ export type MailingListSignupTokenSource = Readonly<{
     blockId: MailingListSdkFooterBlockId;
     contentHash: MailingListSdkContentHash;
 }>;
-export declare function buildMailingListSignupBlockSourceRef(blockId: unknown, contentVersionId: unknown): MailingListSignupSourceRef | null;
+export declare function buildMailingListSignupBlockSourceRef(blockId: unknown, contentVersionId: unknown): Extract<MailingListSignupSourceRef, {
+    tag: 'block_ref';
+}> | null;
 type MailingListSignupProfileBase = Readonly<{
     email: NormalizedSubscriberEmail;
     phone: Readonly<{

package/dist/_dts/core/src/public-event-booking-availability.d.ts

@@ -1,4 +1,4 @@
-export type PublicEventBookingClosedReason = 'occurrence_cancelled' | 'occurrence_completed' | 'series_draft' | 'series_cancelled' | 'series_completed' | 'series_archived' | 'parent_archived' | 'parent_inconsistent' | 'not_public' | 'already_started' | 'enrollment_closed';
+export type PublicEventBookingClosedReason = 'occurrence_cancelled' | 'occurrence_completed' | 'series_draft' | 'series_cancelled' | 'series_completed' | 'series_archived' | 'parent_archived' | 'parent_inconsistent' | 'already_started' | 'enrollment_closed';
 /** Public wire projection; persisted facts remain authoritative. */
 export type PublicEventBookingAvailability = Readonly<{
     kind: 'open';
@@ -6,3 +6,22 @@ export type PublicEventBookingAvailability = Readonly<{
     kind: 'closed';
     reason: PublicEventBookingClosedReason;
 }>;
+/**
+ * Why an event's own page is up while bookings are shut.
+ *
+ * `series_draft` is one reason from the booking decision's point of view, but a
+ * visitor standing on the page is owed two different sentences: an event that
+ * has never opened will open, and one that was open and was taken offline has
+ * closed. The difference is whether the unit has ever been live, which is a
+ * persisted fact the public wire deliberately does not carry as a timestamp.
+ *
+ * This refines `bookingAvailability` rather than replacing it. It is only ever
+ * present alongside a closed `series_draft`, so nothing that already reads the
+ * availability changes its mind because of it, and booking stays refused
+ * wherever it is refused today.
+ */
+export type PublicEventBookingClosedDetail = Readonly<{
+    kind: 'opensSoon';
+}> | Readonly<{
+    kind: 'paused';
+}>;

package/dist/_dts/core/src/public-profile.d.ts

@@ -5,8 +5,10 @@ export type OpeningHoursTime = Brand<string, 'OpeningHoursTime'>;
 export type PublicSocialLinkId = Brand<string, 'PublicSocialLinkId'>;
 export declare const publicProfileWeekdays: readonly ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"];
 export type PublicProfileWeekday = (typeof publicProfileWeekdays)[number];
-export declare const knownSocialPlatforms: readonly ["facebook", "instagram", "linkedin", "tiktok", "x", "youtube"];
+export declare const knownSocialPlatforms: readonly ["facebook", "instagram", "linkedin", "tiktok", "whatsapp", "x", "youtube"];
 export type KnownSocialPlatform = (typeof knownSocialPlatforms)[number];
+/** How each platform is named wherever people see it (settings, composer, footer link labels). */
+export declare const knownSocialPlatformLabels: Readonly<Record<KnownSocialPlatform, string>>;
 export type PublicContactDetails = Readonly<{
     kind: 'phone';
     phone: string;

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -18188,6 +18188,15 @@ export type Database = {
                 };
                 Returns: string;
             };
+            apply_course_booking_settings_v1_atomic: {
+                Args: {
+                    p_event_offering_id: string;
+                    p_settings: Json;
+                    p_site_id: string;
+                    p_user_id: string;
+                };
+                Returns: Json;
+            };
             apply_customer_profile_rectification: {
                 Args: {
                     audit_actor_user_id: string;
@@ -19697,6 +19706,17 @@ export type Database = {
                 };
                 Returns: Json;
             };
+            email_issue_group_evidence: {
+                Args: {
+                    p_group_id: string;
+                    p_limit?: number;
+                };
+                Returns: Json;
+            };
+            email_issue_rows: {
+                Args: never;
+                Returns: Json[];
+            };
             email_reconcile_receipt_audits: {
                 Args: {
                     p_limit?: number;
@@ -20290,7 +20310,9 @@ export type Database = {
                 Returns: boolean;
             };
             newsletter_complete_idle_campaigns: {
-                Args: never;
+                Args: {
+                    p_limit?: number;
+                };
                 Returns: string[];
             };
             newsletter_confirm_atomic: {
@@ -20353,6 +20375,19 @@ export type Database = {
                 };
                 Returns: string;
             };
+            newsletter_schedule_campaign_atomic: {
+                Args: {
+                    p_actor_user_id: string;
+                    p_campaign_id: string;
+                    p_expected_updated_at: string;
+                    p_intended_start_at: string;
+                    p_scheduled_at: string;
+                    p_site_id: string;
+                    p_snapshot: Json;
+                    p_timezone: string;
+                };
+                Returns: boolean;
+            };
             newsletter_signup_atomic: {
                 Args: {
                     p_confirmation_expires_at: string;
@@ -20802,7 +20837,7 @@ export type Database = {
             rename_event_slug_atomic_guarded: {
                 Args: {
                     p_event_offering_id?: string;
-                    p_event_series_id: string;
+                    p_event_series_id?: string;
                     p_expected_old_path: string;
                     p_expected_series_ids: string[];
                     p_page_surface_id?: string;
@@ -21108,6 +21143,18 @@ export type Database = {
                     theme_id: string;
                 }[];
             };
+            save_event_page_words_v1: {
+                Args: {
+                    p_data: Json;
+                    p_expected_draft_updated_at: string;
+                    p_expected_draft_version_id: string;
+                    p_expected_published_version_id: string;
+                    p_page_surface_id: string;
+                    p_site_id: string;
+                    p_user_id: string;
+                };
+                Returns: Json;
+            };
             select_dated_offering_run_cancellation_settlement_v1_atomic: {
                 Args: {
                     p_enrollment_id: string;

package/dist/_dts/editor-blocks/src/BlockEditor.d.ts

@@ -5,6 +5,7 @@ import { type Theme } from '../../blocks/src/index';
 import type { PageDesignEditorReadModel } from '../../theme-core/src/site-styles/index';
 import { type EditorStructuralCommand } from '../../core/src/index';
 import { type CustomBlockRegistryEntry, type SdkConfigForBlockPicker } from './block-editor/sdkBlockMerger';
+import { type BlockCreationCopy } from './block-editor/EmptyState';
 import { type BlockActionPresentation } from './block-editor/actionPresentation';
 import { type ReorderControlMode } from './block-editor/reorderControlMode';
 import { type BlockEditorOwner } from './block-editor/owner';
@@ -70,6 +71,8 @@ export type BlockEditorProps = {
     customBlocks?: readonly CustomBlockRegistryEntry[];
     allowedBlockKinds?: readonly string[] | null;
     emptyUnavailableMessage?: string;
+    /** The empty state's words and the add button's label. */
+    creationCopy?: BlockCreationCopy;
     initialCollapsed?: boolean;
     reorderControlMode?: ReorderControlMode;
     actionPresentation?: BlockActionPresentation;

package/dist/_dts/editor-blocks/src/block-editor/EmptyState.d.ts

@@ -1,3 +1,15 @@
-export declare const EmptyState: ({ onAdd }: {
+/**
+ * The words the editor uses for adding. A host that calls blocks something
+ * else, such as an event page's extra sections, passes its own.
+ */
+export type BlockCreationCopy = Readonly<{
+    emptyTitle: string;
+    emptyDescription: string;
+    addLabel: string;
+}>;
+export declare const DEFAULT_BLOCK_CREATION_COPY: BlockCreationCopy;
+export declare function addBlockLabel(copy?: BlockCreationCopy): string;
+export declare const EmptyState: ({ onAdd, copy, }: {
     onAdd: () => void;
+    copy?: BlockCreationCopy;
 }) => import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/block-editor/types.d.ts

@@ -1,12 +1,6 @@
-import type { EditorBlockId, EditorBlockBaselineInput, EditorDraftBlockBaselineUpdateMetaInput, EditorDraftBlockInitMetaInput, EditorStructuralDraftSnapshot } from '../../../core/src/index';
-export type BlockItem = {
+import type { EditorBlockId, EditorBlockBaselineInput, EditorDraftBlockBaselineUpdateMetaInput, EditorDraftBlockInitMetaInput, EditorStructuralDraftSnapshot, BlockContentIdentity } from '../../../core/src/index';
+export type BlockItem = Partial<BlockContentIdentity> & {
     id?: string | null;
-    /**
-     * The content version the block was loaded with. Runtime blocks that
-     * submit to the API (newsletter signup) cite it so the server can verify
-     * the placement; dropping it turns the form off in preview.
-     */
-    contentVersionId?: string | null;
     kind: string;
     content?: Record<string, unknown> | null;
     orderIndex?: number | null;

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

@@ -1,6 +1,7 @@
 export { BlockEditor } from './BlockEditor';
 export type { BlockEditorProps } from './BlockEditor';
 export type { BlockEditorOwner } from './block-editor/owner';
+export type { BlockCreationCopy } from './block-editor/EmptyState';
 export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, mergeBlockDescriptors, getBlockManifestFromSdkConfig, transformSdkBlockToManifest, transformSdkBlockToDefinition, transformToBlockDescriptor, } from './block-editor/sdkBlockMerger';
 export type { CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryEntry, ResolvedCustomBlockManifest, SdkCustomBlock, SdkConfigForBlockPicker, } from './block-editor/sdkBlockMerger';
 export type { BlockEditorHandle, BlockFocusRequest, BlockFocusTarget, BlockItem, } from './block-editor/types';

package/dist/_dts/preview-next/src/client/blocks/composer/types.d.ts

@@ -1,10 +1,10 @@
 import type { PageOutline } from '../../../../../blocks/src/index';
 import type { EditorPreviewInspectorStore } from '../../../../../content-editor/src/index';
-import type { EditorBlockId } from '../../../../../core/src/index';
+import type { BlockContentIdentity, EditorBlockId } from '../../../../../core/src/index';
 import type { BlockItem } from '../../../../../editor-blocks/src/index';
 import type { CanonicalBlockContent, PreviewProjection, PreviewRenderContent } from '../previewProjection';
 import type { LinkedEntryRenderOverlay } from '../linkedEntryRenderOverlay';
-export type BlockWithContent = {
+export type BlockWithContent = Partial<BlockContentIdentity> & {
     [key: string]: unknown;
     id: string | null;
     kind: string;
@@ -19,9 +19,8 @@ export type DraftSnapshot = {
     baseline: CanonicalBlockContent | null;
     current: CanonicalBlockContent | null;
 };
-export type EnrichedBlock = {
+export type EnrichedBlock = BlockContentIdentity & {
     id: string | null;
-    contentVersionId: string | null;
     kind: string;
     purpose: string;
     orderIndex: number;

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

@@ -3,7 +3,6 @@ import type { ApiClient } from '../../../../api/src/request';
 import { type ContentTypeSchema } from '../../../../content-model/src/index';
 export type PreviewBlock = {
     id: string | null;
-    contentVersionId?: string | null;
     kind: string;
     purpose?: string | null;
     orderIndex?: number | null;
@@ -12,7 +11,7 @@ export type PreviewBlock = {
     publishedContent?: Record<string, unknown> | null;
     bindings?: Record<string, unknown> | null;
     optimisticHash?: string | null;
-};
+} & Partial<import('../../../../core/src/index').BlockContentIdentity>;
 export type PreviewPageMetadata = {
     draftTitle: string;
     draftPath: string;

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

@@ -11,7 +11,6 @@ type CommonRenderInput = Readonly<{
     content: LoadContentResult;
     entrySubrouteContext: ReturnType<typeof toEntrySubrouteContext>;
     portalToken: string | null;
-    preview: boolean;
 }>;
 export type SdkContentRenderInput = CommonRenderInput & (Readonly<{
     kind: 'themed';

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

@@ -28,7 +28,7 @@ export type PageRendererDataContext = {
     bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
     mailingList?: import('../../../core/src/index').MailingListRuntimeContext;
     bookingTimeZone?: string;
-    previewStage?: 'published' | 'preview';
+    previewStage: 'published' | 'preview';
     routes?: RouteMap;
     pagesByIdentifier?: Record<string, string>;
     entriesByIdentifier?: Record<string, Record<string, string>>;
@@ -57,7 +57,7 @@ export type SdkConfigForRenderer = {
 type PageRendererCommonProps<TPage> = {
     page: TPage | null;
     runtimeJoins?: readonly PageRuntimeJoin[];
-    dataContext?: PageRendererDataContext;
+    dataContext: PageRendererDataContext;
     routeMap?: RouteMap;
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
     registry?: ComponentRegistry;

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

@@ -60,7 +60,7 @@ type PageCommonProps = {
      * Additional context data for content entry pages.
      * Used to pass occurrence context and content entry data to blocks.
      */
-    dataContext?: {
+    dataContext: {
         readAuthority?: import('../../../../blocks/src/api').BrowserReadAuthority;
         /** Mailing-list runtime projected for the placements on this page. */
         mailingList?: import('../../../../core/src/index').MailingListRuntimeContext;
@@ -77,7 +77,7 @@ type PageCommonProps = {
         /** Editable route metadata keys for template-page inline editing */
         editableRouteMetadataFieldIds?: ReadonlyArray<string> | null;
         /** Preview stage: 'preview' for draft content, 'published' for live content */
-        previewStage?: 'preview' | 'published';
+        previewStage: 'preview' | 'published';
         /** Canonical request pathname used by blocks when resolving same-site destinations. */
         pathname?: string;
     };

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

@@ -11,7 +11,7 @@ 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';
-import type { DataLoaderOverrides, DataLoaderSearchParams } from '../../data/types';
+import type { DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderSearchParams } from '../../data/types';
 import type { SdkCustomBlock } from '../../config/types';
 import { type RuntimeSdkConfig } from './pageRuntimeSupport';
 /**
@@ -93,6 +93,9 @@ export type PagePreviewMetadata = {
  */
 export type PageContentResult = {
     type: 'page';
+    dataContext: {
+        previewStage: DataLoaderPreviewStage;
+    };
     /** Page UUID (required for preview editing / block mutations) */
     pageId: string;
     /** Route UUID for this page (used by preview mode metadata editing) */
@@ -153,6 +156,7 @@ export type EntryContentResult = {
     bookingTimeZone?: string;
     /** Data context for template blocks (includes entry content for bindings) */
     dataContext: {
+        previewStage: DataLoaderPreviewStage;
         contentEntry: Record<string, unknown>;
     };
     /** Site theme for styling (useful if rendering with SDK components) */
@@ -217,6 +221,7 @@ export type PageSurfaceContentResult = {
     mailingList?: MailingListRuntimeContext;
     bookingTimeZone?: string;
     dataContext: {
+        previewStage: DataLoaderPreviewStage;
         pageSurface: Record<string, unknown>;
         subject: PageSurfaceContentData['subject'];
     };

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

@@ -6,7 +6,7 @@
 import type { RiverbankClient } from '../../client/types';
 import type { PageProps } from '../components/Page';
 import { type ResolveBlockDataDeps } from '../../data/resolveBlockData';
-import type { DataLoaderOverrides, DataLoaderSearchParams } from '../../data/types';
+import type { DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderSearchParams } from '../../data/types';
 import { type RuntimeSdkConfig } from './pageRuntimeSupport';
 /**
  * SDK config from API response (without siteId which is stripped at storage).
@@ -79,7 +79,10 @@ export type LoadPageParams = {
      */
     searchParams?: DataLoaderSearchParams;
 };
-export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'blockOverrides' | 'sdkConfig'> & {
+export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'blockOverrides' | 'sdkConfig' | 'dataContext'> & {
+    dataContext: {
+        previewStage: DataLoaderPreviewStage;
+    };
     /**
      * SDK site configuration, if available.
      * Contains SDK-defined theme palette, section backgrounds, and style options.

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

@@ -2,7 +2,8 @@ import type { MediaAssetIndexItem, PageOutline, RouteMap, Theme } from '../../co
 import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
 import type { SiteResponse } from '../../client/types';
 import type { SdkCustomBlock } from '../../config/types';
-import { type BlockManifest, type FieldDefinition, type PageBlockRenderAdmissionError, type RenderablePageBlock, type RenderablePageOutline } from '../../../../blocks/src/index';
+import { type BlockManifest, type FieldDefinition, type PageBlockRenderAdmissionError, type PublishedBlockPlacement, type RenderablePageBlock, type RenderablePageOutline } from '../../../../blocks/src/index';
+import type { DataLoaderPreviewStage } from '../../data/types';
 export type RuntimeSdkConfig = NonNullable<SiteResponse['sdkConfig']>;
 export type SiteData = SiteResponse['site'];
 export type SiteRenderSupport = Readonly<{
@@ -40,6 +41,8 @@ export declare function buildSiteRenderSupport(site: SiteResponse, mediaAssets:
 export declare function collectMediaAssetSidecar(mediaAssets: readonly MediaAssetIndexItem[] | null | undefined): readonly MediaAssetIndexItem[] | undefined;
 type TransportedPageBlock = PageOutline['blocks'][number] & Readonly<{
     contentVersionId?: string | null;
+    draftContentId: string | null;
+    publishedPlacement: PublishedBlockPlacement | null;
 }>;
 export declare function readInvalidBlockAdmission(value: unknown): Readonly<{
     kind: 'invalid';
@@ -51,6 +54,7 @@ export declare function buildPageOutline(input: Readonly<{
     fallbackPath: string;
     purpose: string;
     blocks: readonly unknown[];
+    previewStage: DataLoaderPreviewStage;
 }>): Omit<PageOutline, 'blocks'> & Readonly<{
     blocks: TransportedPageBlock[];
 }>;
@@ -60,6 +64,7 @@ export declare function buildRenderablePageOutline(input: Readonly<{
     fallbackPath: string;
     purpose: string;
     blocks: readonly unknown[];
+    previewStage: DataLoaderPreviewStage;
     customBlocks?: readonly SdkCustomBlock[];
 }>): RenderablePageOutline;
 export declare function projectRenderablePageOutline(page: RenderablePageOutline): PageOutline;

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

@@ -22,6 +22,8 @@ type EntrySlotBlock = {
     id: string;
     blockId?: string;
     contentVersionId: string;
+    draftContentId?: string | null;
+    publishedContentId?: string | null;
     kind: string;
     purpose: string;
     content: Record<string, unknown> | null;

package/dist/_dts/sdk/src/rendering/hooks/useContent.d.ts

@@ -8,6 +8,7 @@ import type { MediaAssetIndexItem, Theme } from '../../contracts';
 import type { RiverbankClient } from '../../client/types';
 import type { PageProps } from '../components/Page';
 import type { ResolvedBlockData } from '../../data/prefetchBlockData';
+import type { DataLoaderPreviewStage } from '../../data/types';
 import type { ContentEntryData } from '../helpers/loadContent';
 export type UseContentParams = {
     client: RiverbankClient;
@@ -61,6 +62,9 @@ type PageSuccessState = {
     theme: Theme | null;
     siteId: string;
     resolvedData: ResolvedBlockData;
+    dataContext: {
+        previewStage: DataLoaderPreviewStage;
+    };
     supabaseUrl?: string;
     mediaAssets?: readonly MediaAssetIndexItem[];
 };
@@ -117,7 +121,7 @@ export declare function isEntryContentResult(result: UseContentResult): result i
  *
  *   if (isPageContentResult(content)) {
  *     if (!content.theme) return <div>This site needs a theme before it can be displayed.</div>;
- *     return <Page page={content.page} theme={content.theme} siteId={content.siteId} resolvedData={content.resolvedData} />;
+ *     return <Page page={content.page} theme={content.theme} siteId={content.siteId} resolvedData={content.resolvedData} dataContext={content.dataContext} />;
  *   }
  *
  *   // Render entry with custom UI

package/dist/_dts/sdk/src/rendering/hooks/usePage.d.ts

@@ -5,6 +5,7 @@
  */
 import type { RiverbankClient } from '../../client/types';
 import type { PageProps } from '../components/Page';
+import type { DataLoaderPreviewStage } from '../../data/types';
 import type { RuntimeSdkConfig } from '../helpers/loadPage';
 export type UsePageParams = {
     client: RiverbankClient;
@@ -40,7 +41,10 @@ export type UsePageResult = {
     loading: false;
     error: null;
     sdkConfig: RuntimeSdkConfig | null;
-} & Omit<PageProps, 'registry' | 'wrapBlock' | 'sdkConfig'>);
+    dataContext: {
+        previewStage: DataLoaderPreviewStage;
+    };
+} & Omit<PageProps, 'registry' | 'wrapBlock' | 'sdkConfig' | 'dataContext'>);
 /**
  * Client-side React hook to fetch all data needed for <Page> component.
  *

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.145.0";
+export declare const SDK_VERSION = "0.146.0";

package/dist/_dts/surfaces/src/index.d.ts

@@ -35,6 +35,15 @@ export type SurfaceHostContext = Readonly<{
  */
 export declare const SURFACE_ROOT_HOSTS: Readonly<Record<SurfaceId, Readonly<Record<SurfaceTier, string>>>>;
 export declare const SURFACE_SITE_ROOT_HOSTS: Readonly<Record<SurfaceId, Readonly<Record<SurfaceTier, string>>>>;
+/**
+ * Site slugs a surface host already occupies. A site's managed address is
+ * `{slug}.{site root host}`, so any surface host (dashboard root, site root or
+ * site-root alias) that sits beneath a site root host claims the label in the
+ * slug position: `preview.riverbanksites.com` claims `preview`, and
+ * `macadamia.localhost` claims `macadamia`. A site given one of these slugs
+ * would be unreachable at its managed address.
+ */
+export declare const SURFACE_OWNED_SITE_SLUGS: readonly string[];
 export declare function resolveSurfaceFontHref(surfaceId: SurfaceId): string | null;
 export declare function resolveSurfaceSiteHostContext(value: string | URL | null | undefined): SurfaceHostContext | null;
 export declare function resolveSurfaceHostContext(value: string | URL | null | undefined): SurfaceHostContext | null;