@riverbankcms/sdk 0.60.0 → 0.60.1

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

@@ -1,79 +1,10 @@
 /**
- * Block component for rendering individual CMS blocks
+ * Default Block renderer component for Riverbank CMS.
  *
- * Renders a single block with its content and data.
+ * This surface restores the common SDK behavior where rendering a block also
+ * boots interactive CMS islands automatically. For a bootstrap-free surface,
+ * use `@riverbankcms/sdk/rendering/server`.
  */
-import * as React from 'react';
-import type { Theme, ThemeTokens } from '../../contracts';
-import type { RiverbankClient } from '../../client/types';
-import type { BlockKind } from '../../types';
-/**
- * Override component for custom block rendering.
- * Receives the same props as default block components.
- */
-export type BlockOverrideComponent = React.ComponentType<{
-    content: Record<string, unknown>;
-    theme?: ThemeTokens;
-    themeConfig?: Theme;
-    data?: Record<string, unknown>;
-    blockId?: string | null;
-    blockKind?: BlockKind;
-}>;
-export type BlockProps = {
-    blockKind: BlockKind;
-    blockId?: string | null;
-    content: Record<string, unknown>;
-    theme: Theme;
-    siteId: string;
-    pageId?: string;
-    previewStage?: 'published' | 'preview';
-    client?: RiverbankClient;
-    usePlaceholders?: boolean;
-    /**
-     * Custom component to override default block rendering.
-     * When provided, renders this component instead of the manifest-based default.
-     * This is SSR-safe - no context or hooks required.
-     *
-     * @example
-     * ```tsx
-     * <Block
-     *   blockKind="block.hero"
-     *   content={heroContent}
-     *   theme={theme}
-     *   siteId={siteId}
-     *   override={MyCustomHero}
-     * />
-     * ```
-     */
-    override?: BlockOverrideComponent;
-};
-/**
- * Renders a single CMS block with optional data loading.
- *
- * Use this component when you want to render individual blocks outside of a full page context,
- * or when mixing CMS blocks with custom JSX.
- *
- * @example Basic usage
- * ```tsx
- * <Block
- *   blockKind="block.hero"
- *   content={{ headline: 'Welcome', subheadline: 'To our site' }}
- *   theme={theme}
- *   siteId="site-123"
- * />
- * ```
- *
- * @example With data loading
- * ```tsx
- * <Block
- *   blockKind="block.blog-listing"
- *   blockId="block-456"
- *   content={blockContent}
- *   theme={theme}
- *   siteId="site-123"
- *   pageId="page-789"
- *   client={client}
- * />
- * ```
- */
-export declare function Block({ blockKind, blockId, content, theme, siteId, pageId, previewStage, client, usePlaceholders: _usePlaceholders, override: OverrideComponent, }: BlockProps): Promise<import("react/jsx-runtime").JSX.Element>;
+import { type BlockProps } from './Block.shared';
+export type { BlockOverrideComponent, BlockProps } from './Block.shared';
+export declare function Block(props: BlockProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/sdk/src/rendering/components/Block.server.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Server-only Block renderer for Riverbank CMS.
+ *
+ * This stays server-safe by delegating to the shared `BlockContent` renderer
+ * without pulling the client hydration bootstrap into the server entrypoint.
+ */
+import { type BlockProps } from './Block.shared';
+export type { BlockOverrideComponent, BlockProps } from './Block.shared';
+export declare function Block(props: BlockProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/sdk/src/rendering/components/Block.shared.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Shared Block rendering implementation.
+ *
+ * The default `@riverbankcms/sdk/rendering` surface wraps this with island
+ * hydration; the strict `@riverbankcms/sdk/rendering/server` surface exports it
+ * directly.
+ */
+import * as React from 'react';
+import type { MediaAssetIndexItem, RouteMap, Theme } from '../../contracts';
+import type { RiverbankClient } from '../../client/types';
+import type { BlockKind } from '../../types';
+import type { BlockOverrideComponent } from '../overrides';
+export type { BlockOverrideComponent } from '../overrides';
+export type BlockProps = {
+    blockKind: BlockKind;
+    blockId?: string | null;
+    content: Record<string, unknown>;
+    theme: Theme;
+    siteId?: string;
+    /**
+     * Supabase storage URL for direct image access in SSR output and client
+     * islands.
+     */
+    supabaseUrl?: string;
+    /**
+     * Canonical media sidecar for resolving identifier-only media values.
+     */
+    mediaAssets?: readonly MediaAssetIndexItem[];
+    /**
+     * Base URL for the CMS API. Interactive blocks need this for client-side
+     * form, booking, event, and commerce calls.
+     */
+    apiBaseUrl?: string;
+    /**
+     * Portal token for customer portal Bearer auth.
+     */
+    portalToken?: string | null;
+    /** Route lookup for CMS links inside block content. */
+    routeMap?: RouteMap;
+    /** Page identifier to routeId lookup for { kind: 'page' } links. */
+    pagesByIdentifier?: Record<string, string>;
+    /** ContentType -> identifier -> routeId lookup for { kind: 'entry' } links. */
+    entriesByIdentifier?: Record<string, Record<string, string>>;
+    pageId?: string;
+    previewStage?: 'published' | 'preview';
+    client?: RiverbankClient;
+    usePlaceholders?: boolean;
+    /**
+     * Custom component to override default block rendering. When provided, renders
+     * this component instead of the manifest-based default. Override components
+     * receive the same serializable runtime context as page-level block overrides.
+     *
+     * @example
+     * ```tsx
+     * <Block
+     *   blockKind="block.hero"
+     *   content={heroContent}
+     *   theme={theme}
+     *   siteId={siteId}
+     *   override={MyCustomHero}
+     * />
+     * ```
+     */
+    override?: BlockOverrideComponent;
+};
+export type BlockHydrationBootstrapConfig = {
+    siteId?: string;
+    supabaseUrl?: string;
+    mediaAssets?: readonly MediaAssetIndexItem[];
+};
+export declare function toBlockHydrationBootstrapConfig(props: Pick<BlockProps, 'siteId' | 'supabaseUrl' | 'mediaAssets'>): BlockHydrationBootstrapConfig;
+/**
+ * Renders a single CMS block with optional data loading.
+ *
+ * Use this component when you want to render individual blocks outside of a full page context,
+ * or when mixing CMS blocks with custom JSX.
+ */
+export declare function BlockContent(props: BlockProps): Promise<React.ReactElement<unknown, string | React.JSXElementConstructor<any>>>;

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

@@ -54,11 +54,11 @@ export type LayoutProps = {
  * Layout component that wraps content with site header and footer.
  *
  * This is a server/RSC-safe component. The default `@riverbankcms/sdk/rendering`
- * `Page` surface mounts CMS island hydration automatically, while the strict
- * `@riverbankcms/sdk/rendering/server` surface stays bootstrap-free. If a custom
- * host bypasses the default `Page` surface and still renders hydratable CMS
- * islands, mount `BlocksIslandsHydrator` from `@riverbankcms/sdk/rendering/client`
- * explicitly.
+ * `Page` and `Block` surfaces mount CMS island hydration automatically, while
+ * the strict `@riverbankcms/sdk/rendering/server` surface stays bootstrap-free.
+ * If a custom host renders hydratable CMS islands through the strict server
+ * surface, mount `BlocksIslandsHydrator` from
+ * `@riverbankcms/sdk/rendering/client` explicitly.
  *
  * @example With pre-fetched site data (recommended)
  * ```tsx

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

@@ -6,5 +6,5 @@ export { Page } from './components/Page.server';
 export type { PageProps } from './components/Page.server';
 export { Layout } from './components/Layout';
 export type { LayoutProps, HeaderData, FooterData } from './components/Layout';
-export { Block } from './components/Block';
-export type { BlockProps } from './components/Block';
+export { Block } from './components/Block.server';
+export type { BlockProps } from './components/Block.server';

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