@riverbankcms/sdk 0.1.0

package/dist/server/rendering/server.d.mts

@@ -0,0 +1,83 @@
+export { P as Page, b as PageProps } from '../loadPage-CCf15nt8.mjs';
+export { HeaderData, Layout, LayoutProps } from '../components.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { Theme } from '@riverbankcms/blocks';
+import { R as RiverbankClient } from '../types-C6gmRHLe.mjs';
+import '@riverbankcms/blocks/system/data';
+import '../types-Bbo01M7P.mjs';
+import '@riverbankcms/site-renderer';
+import '@riverbankcms/api';
+
+/**
+ * Override component for custom block rendering.
+ * Receives the same props as default block components.
+ */
+type BlockOverrideComponent = React.ComponentType<{
+    content: Record<string, unknown>;
+    theme?: Record<string, unknown>;
+    themeConfig?: Theme;
+    data?: Record<string, unknown>;
+    blockId?: string | null;
+    blockKind?: string;
+}>;
+type BlockProps = {
+    blockKind: string;
+    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}
+ * />
+ * ```
+ */
+declare function Block({ blockKind, blockId, content, theme, siteId, pageId, previewStage, client, usePlaceholders: _usePlaceholders, override: OverrideComponent, }: BlockProps): Promise<react_jsx_runtime.JSX.Element>;
+
+export { Block, type BlockProps };

package/dist/server/rendering/server.d.ts

@@ -0,0 +1,83 @@
+export { P as Page, b as PageProps } from '../loadPage-BYmVMk0V.js';
+export { HeaderData, Layout, LayoutProps } from '../components.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { Theme } from '@riverbankcms/blocks';
+import { R as RiverbankClient } from '../types-C6gmRHLe.js';
+import '@riverbankcms/blocks/system/data';
+import '../types-Bbo01M7P.js';
+import '@riverbankcms/site-renderer';
+import '@riverbankcms/api';
+
+/**
+ * Override component for custom block rendering.
+ * Receives the same props as default block components.
+ */
+type BlockOverrideComponent = React.ComponentType<{
+    content: Record<string, unknown>;
+    theme?: Record<string, unknown>;
+    themeConfig?: Theme;
+    data?: Record<string, unknown>;
+    blockId?: string | null;
+    blockKind?: string;
+}>;
+type BlockProps = {
+    blockKind: string;
+    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}
+ * />
+ * ```
+ */
+declare function Block({ blockKind, blockId, content, theme, siteId, pageId, previewStage, client, usePlaceholders: _usePlaceholders, override: OverrideComponent, }: BlockProps): Promise<react_jsx_runtime.JSX.Element>;
+
+export { Block, type BlockProps };

package/dist/server/rendering/server.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkJB4LIEFSjs = require('../chunk-JB4LIEFS.js');
+
+
+
+var _chunkYHEZMVTSjs = require('../chunk-YHEZMVTS.js');
+require('../chunk-QQ6U4QX6.js');
+
+
+
+
+exports.Block = _chunkJB4LIEFSjs.Block; exports.Layout = _chunkYHEZMVTSjs.Layout; exports.Page = _chunkYHEZMVTSjs.Page;
+//# sourceMappingURL=server.js.map

package/dist/server/rendering/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/rendering/server.js"],"names":[],"mappings":"AAAA;AACE;AACF,uDAA6B;AAC7B;AACE;AACA;AACF,uDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACF,uHAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/rendering/server.js"}

package/dist/server/rendering/server.mjs

@@ -0,0 +1,14 @@
+import {
+  Block
+} from "../chunk-WKG57P2H.mjs";
+import {
+  Layout,
+  Page
+} from "../chunk-R5YGLRUG.mjs";
+import "../chunk-W3K7LVPS.mjs";
+export {
+  Block,
+  Layout,
+  Page
+};
+//# sourceMappingURL=server.mjs.map

package/dist/server/rendering/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server/rendering.d.mts

@@ -0,0 +1,12 @@
+export { L as LoadPageParams, a as LoadPageResult, P as Page, b as PageProps, l as loadPage } from './loadPage-CCf15nt8.mjs';
+export { HeaderData, Layout, LayoutProps } from './components.mjs';
+export { Block, BlockProps } from './rendering/server.mjs';
+export { C as ContentEntryData, L as LoadContentParams, b as LoadContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-zhlL4YSE.mjs';
+export { AppointmentBookingContent, BackgroundInput, BlockOverrideComponent, BlockOverrides, BlogListingContent, BlogPlaceholderContent, BlogPostContent, BodyTextContent, ColumnsContent, CtaFullContent, CustomLinkValue, EventCalendarContent, EventRegistrationContent, ExternalLinkValue, FaqContent, FormBlockContent, HeroContent, HeroMedia, InternalLinkValue, LinkValue, Media, PageOutline, PageRenderer, ResolvedBackground, RichText, RichTextPrimitiveProps, RouteMap, SectionBackground, SectionBackgroundProps, SiteFooterContent, SiteHeaderContent, SystemBlockComponentProps, TestimonialEntryContent, TestimonialsBlockContent, Theme, ThemeTokens, TipTapNode, buildThemeRuntime, resolveBackground, resolveImageUrl } from '@riverbankcms/blocks';
+import './types-C6gmRHLe.mjs';
+import '@riverbankcms/api';
+import 'react/jsx-runtime';
+import '@riverbankcms/blocks/system/data';
+import './types-Bbo01M7P.mjs';
+import '@riverbankcms/site-renderer';
+import 'react';

package/dist/server/rendering.d.ts

@@ -0,0 +1,12 @@
+export { L as LoadPageParams, a as LoadPageResult, P as Page, b as PageProps, l as loadPage } from './loadPage-BYmVMk0V.js';
+export { HeaderData, Layout, LayoutProps } from './components.js';
+export { Block, BlockProps } from './rendering/server.js';
+export { C as ContentEntryData, L as LoadContentParams, b as LoadContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-CJcbYF3J.js';
+export { AppointmentBookingContent, BackgroundInput, BlockOverrideComponent, BlockOverrides, BlogListingContent, BlogPlaceholderContent, BlogPostContent, BodyTextContent, ColumnsContent, CtaFullContent, CustomLinkValue, EventCalendarContent, EventRegistrationContent, ExternalLinkValue, FaqContent, FormBlockContent, HeroContent, HeroMedia, InternalLinkValue, LinkValue, Media, PageOutline, PageRenderer, ResolvedBackground, RichText, RichTextPrimitiveProps, RouteMap, SectionBackground, SectionBackgroundProps, SiteFooterContent, SiteHeaderContent, SystemBlockComponentProps, TestimonialEntryContent, TestimonialsBlockContent, Theme, ThemeTokens, TipTapNode, buildThemeRuntime, resolveBackground, resolveImageUrl } from '@riverbankcms/blocks';
+import './types-C6gmRHLe.js';
+import '@riverbankcms/api';
+import 'react/jsx-runtime';
+import '@riverbankcms/blocks/system/data';
+import './types-Bbo01M7P.js';
+import '@riverbankcms/site-renderer';
+import 'react';

package/dist/server/rendering.js

@@ -0,0 +1,40 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkF472SMKXjs = require('./chunk-F472SMKX.js');
+
+
+var _chunkADREPXFUjs = require('./chunk-ADREPXFU.js');
+
+
+var _chunkJB4LIEFSjs = require('./chunk-JB4LIEFS.js');
+
+
+
+var _chunkYHEZMVTSjs = require('./chunk-YHEZMVTS.js');
+require('./chunk-YXDDFG3N.js');
+require('./chunk-QQ6U4QX6.js');
+
+// src/rendering/index.ts
+var _blocks = require('@riverbankcms/blocks');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.Block = _chunkJB4LIEFSjs.Block; exports.Layout = _chunkYHEZMVTSjs.Layout; exports.Page = _chunkYHEZMVTSjs.Page; exports.PageRenderer = _blocks.PageRenderer; exports.RichText = _blocks.RichText; exports.SectionBackground = _blocks.SectionBackground; exports.buildThemeRuntime = _blocks.buildThemeRuntime; exports.isEntryContent = _chunkF472SMKXjs.isEntryContent; exports.isPageContent = _chunkF472SMKXjs.isPageContent; exports.loadContent = _chunkF472SMKXjs.loadContent; exports.loadPage = _chunkADREPXFUjs.loadPage; exports.resolveBackground = _blocks.resolveBackground; exports.resolveImageUrl = _blocks.resolveImageUrl;
+//# sourceMappingURL=rendering.js.map

package/dist/server/rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/rendering.js","../../src/rendering/index.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACE;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACA;ACMA,8CAA2E;AAyC3E;AACE;AACA;AAAA;AD3CF;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,qnBAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/rendering.js","sourcesContent":[null,"/**\n * Rendering components and utilities for Riverbank CMS\n *\n * These components allow you to render Builder pages and blocks\n * in your own application with ergonomic data fetching helpers.\n */\n\n// High-level components (recommended)\nexport { Page } from './components/Page';\nexport type { PageProps } from './components/Page';\n\nexport { Layout } from './components/Layout';\nexport type { LayoutProps, HeaderData } from './components/Layout';\n\nexport { Block } from './components/Block';\nexport type { BlockProps } from './components/Block';\n\n// Server-side helpers (also available via @riverbankcms/sdk/server)\nexport { loadPage } from './helpers/loadPage';\nexport type { LoadPageParams, LoadPageResult } from './helpers/loadPage';\nexport { loadContent, isPageContent, isEntryContent } from './helpers/loadContent';\nexport type { LoadContentParams, LoadContentResult, ContentEntryData } from './helpers/loadContent';\n\n// Low-level re-exports from @riverbankcms/blocks (for advanced usage)\nexport { PageRenderer, buildThemeRuntime, RichText, resolveImageUrl } from '@riverbankcms/blocks';\nexport type {\n  PageOutline,\n  RouteMap,\n  Theme,\n  ThemeTokens,\n  BlockOverrides,\n  BlockOverrideComponent,\n  // For creating typed custom block components\n  SystemBlockComponentProps,\n  // Block content types - all system blocks\n  HeroContent,\n  HeroMedia,\n  BodyTextContent,\n  ColumnsContent,\n  CtaFullContent,\n  FaqContent,\n  FormBlockContent,\n  TestimonialsBlockContent,\n  TestimonialEntryContent,\n  BlogPostContent,\n  BlogListingContent,\n  BlogPlaceholderContent,\n  SiteHeaderContent,\n  SiteFooterContent,\n  AppointmentBookingContent,\n  EventCalendarContent,\n  EventRegistrationContent,\n  // Link types for block props\n  LinkValue,\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n  // Media type\n  Media,\n  // Rich text types\n  RichTextPrimitiveProps,\n  TipTapNode,\n} from '@riverbankcms/blocks';\n\n// Helpers for custom block components\nexport {\n  resolveBackground,\n  SectionBackground,\n  type BackgroundInput,\n  type ResolvedBackground,\n  type SectionBackgroundProps,\n} from '@riverbankcms/blocks';\n\n/**\n * @example Server-side rendering (Next.js App Router)\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { loadPage, Page } from '@riverbankcms/sdk/rendering';\n *\n * // Note: baseUrl must include the /api path\n * const client = createRiverbankClient({\n *   apiKey: process.env.RIVERBANK_API_KEY,\n *   baseUrl: process.env.NEXT_PUBLIC_DASHBOARD_URL + '/api',\n * });\n *\n * export default async function PageRoute({ params }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: 'site-id',\n *     path: `/${params.slug || ''}`,\n *   });\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example Client-side rendering\n * ```tsx\n * 'use client';\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { usePage } from '@riverbankcms/sdk/hooks';\n * import { Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({\n *   apiKey: process.env.NEXT_PUBLIC_RIVERBANK_API_KEY,\n *   baseUrl: process.env.NEXT_PUBLIC_DASHBOARD_URL + '/api',\n * });\n *\n * function MyPage({ path }) {\n *   const pageData = usePage({ client, siteId: 'site-id', path });\n *\n *   if (pageData.loading) return <div>Loading...</div>;\n *   if (pageData.error) return <div>Error: {pageData.error.message}</div>;\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n */\n"]}

package/dist/server/rendering.mjs

@@ -0,0 +1,40 @@
+import {
+  isEntryContent,
+  isPageContent,
+  loadContent
+} from "./chunk-PEAXKTDU.mjs";
+import {
+  loadPage
+} from "./chunk-2RW5HAQQ.mjs";
+import {
+  Block
+} from "./chunk-WKG57P2H.mjs";
+import {
+  Layout,
+  Page
+} from "./chunk-R5YGLRUG.mjs";
+import "./chunk-GWBMJPLH.mjs";
+import "./chunk-W3K7LVPS.mjs";
+
+// src/rendering/index.ts
+import { PageRenderer, buildThemeRuntime, RichText, resolveImageUrl } from "@riverbankcms/blocks";
+import {
+  resolveBackground,
+  SectionBackground
+} from "@riverbankcms/blocks";
+export {
+  Block,
+  Layout,
+  Page,
+  PageRenderer,
+  RichText,
+  SectionBackground,
+  buildThemeRuntime,
+  isEntryContent,
+  isPageContent,
+  loadContent,
+  loadPage,
+  resolveBackground,
+  resolveImageUrl
+};
+//# sourceMappingURL=rendering.mjs.map

package/dist/server/rendering.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/rendering/index.ts"],"sourcesContent":["/**\n * Rendering components and utilities for Riverbank CMS\n *\n * These components allow you to render Builder pages and blocks\n * in your own application with ergonomic data fetching helpers.\n */\n\n// High-level components (recommended)\nexport { Page } from './components/Page';\nexport type { PageProps } from './components/Page';\n\nexport { Layout } from './components/Layout';\nexport type { LayoutProps, HeaderData } from './components/Layout';\n\nexport { Block } from './components/Block';\nexport type { BlockProps } from './components/Block';\n\n// Server-side helpers (also available via @riverbankcms/sdk/server)\nexport { loadPage } from './helpers/loadPage';\nexport type { LoadPageParams, LoadPageResult } from './helpers/loadPage';\nexport { loadContent, isPageContent, isEntryContent } from './helpers/loadContent';\nexport type { LoadContentParams, LoadContentResult, ContentEntryData } from './helpers/loadContent';\n\n// Low-level re-exports from @riverbankcms/blocks (for advanced usage)\nexport { PageRenderer, buildThemeRuntime, RichText, resolveImageUrl } from '@riverbankcms/blocks';\nexport type {\n  PageOutline,\n  RouteMap,\n  Theme,\n  ThemeTokens,\n  BlockOverrides,\n  BlockOverrideComponent,\n  // For creating typed custom block components\n  SystemBlockComponentProps,\n  // Block content types - all system blocks\n  HeroContent,\n  HeroMedia,\n  BodyTextContent,\n  ColumnsContent,\n  CtaFullContent,\n  FaqContent,\n  FormBlockContent,\n  TestimonialsBlockContent,\n  TestimonialEntryContent,\n  BlogPostContent,\n  BlogListingContent,\n  BlogPlaceholderContent,\n  SiteHeaderContent,\n  SiteFooterContent,\n  AppointmentBookingContent,\n  EventCalendarContent,\n  EventRegistrationContent,\n  // Link types for block props\n  LinkValue,\n  InternalLinkValue,\n  ExternalLinkValue,\n  CustomLinkValue,\n  // Media type\n  Media,\n  // Rich text types\n  RichTextPrimitiveProps,\n  TipTapNode,\n} from '@riverbankcms/blocks';\n\n// Helpers for custom block components\nexport {\n  resolveBackground,\n  SectionBackground,\n  type BackgroundInput,\n  type ResolvedBackground,\n  type SectionBackgroundProps,\n} from '@riverbankcms/blocks';\n\n/**\n * @example Server-side rendering (Next.js App Router)\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { loadPage, Page } from '@riverbankcms/sdk/rendering';\n *\n * // Note: baseUrl must include the /api path\n * const client = createRiverbankClient({\n *   apiKey: process.env.RIVERBANK_API_KEY,\n *   baseUrl: process.env.NEXT_PUBLIC_DASHBOARD_URL + '/api',\n * });\n *\n * export default async function PageRoute({ params }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: 'site-id',\n *     path: `/${params.slug || ''}`,\n *   });\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example Client-side rendering\n * ```tsx\n * 'use client';\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { usePage } from '@riverbankcms/sdk/hooks';\n * import { Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({\n *   apiKey: process.env.NEXT_PUBLIC_RIVERBANK_API_KEY,\n *   baseUrl: process.env.NEXT_PUBLIC_DASHBOARD_URL + '/api',\n * });\n *\n * function MyPage({ path }) {\n *   const pageData = usePage({ client, siteId: 'site-id', path });\n *\n *   if (pageData.loading) return <div>Loading...</div>;\n *   if (pageData.error) return <div>Error: {pageData.error.message}</div>;\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n */\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwBA,SAAS,cAAc,mBAAmB,UAAU,uBAAuB;AAyC3E;AAAA,EACE;AAAA,EACA;AAAA,OAIK;","names":[]}

package/dist/server/routing.d.mts

@@ -0,0 +1,115 @@
+import { R as RiverbankClient } from './types-C6gmRHLe.mjs';
+import { a as LoadPageResult } from './loadPage-CCf15nt8.mjs';
+import '@riverbankcms/api';
+import 'react/jsx-runtime';
+import '@riverbankcms/blocks';
+import '@riverbankcms/blocks/system/data';
+import './types-Bbo01M7P.mjs';
+
+/**
+ * Route resolution helper for dynamic page routing
+ *
+ * Resolves URL paths to pages, entries, redirects, or 404s.
+ */
+
+type RouteResolution = {
+    type: 'page';
+    pageData: LoadPageResult;
+} | {
+    type: 'redirect';
+    destination: string;
+    permanent: boolean;
+} | {
+    type: 'not-found';
+};
+type ResolveRouteParams = {
+    /**
+     * Builder client instance
+     */
+    client: RiverbankClient;
+    /**
+     * Site ID
+     */
+    siteId: string;
+    /**
+     * URL path to resolve (e.g., '/about', '/blog/post-1')
+     */
+    path: string;
+    /**
+     * If true, fetches draft/unpublished content instead of published content.
+     * @default false
+     */
+    preview?: boolean;
+};
+/**
+ * Resolve a URL path to page data, redirect, or 404
+ *
+ * This helper attempts to fetch the page at the given path and returns
+ * a discriminated union indicating whether the page was found or not.
+ *
+ * **Note:** Redirect support is not yet implemented. The `redirect` type
+ * exists in the return type for future compatibility, but this function
+ * currently only returns `page` or `not-found` types.
+ *
+ * @example
+ * ```tsx
+ * import { resolveRoute } from '@riverbankcms/sdk/routing';
+ * import { notFound, redirect } from 'next/navigation';
+ *
+ * export default async function DynamicPage({ params }) {
+ *   const path = `/${params.slug?.join('/') || ''}`;
+ *   const resolution = await resolveRoute({
+ *     client,
+ *     siteId: 'your-site-id',
+ *     path,
+ *   });
+ *
+ *   if (resolution.type === 'redirect') {
+ *     redirect(resolution.destination);
+ *   }
+ *
+ *   if (resolution.type === 'not-found') {
+ *     notFound();
+ *   }
+ *
+ *   // resolution.type === 'page'
+ *   return <Page {...resolution.pageData} />;
+ * }
+ * ```
+ */
+declare function resolveRoute(params: ResolveRouteParams): Promise<RouteResolution>;
+/**
+ * Batch resolve multiple routes in parallel
+ *
+ * Useful for pre-fetching multiple routes or validating a sitemap.
+ *
+ * @example
+ * ```tsx
+ * const resolutions = await resolveRoutes({
+ *   client,
+ *   siteId: 'your-site-id',
+ *   paths: ['/', '/about', '/blog', '/contact'],
+ * });
+ *
+ * resolutions.forEach(({ path, resolution }) => {
+ *   if (resolution.type === 'page') {
+ *     console.log(`${path} → Page: ${resolution.pageData.page.name}`);
+ *   } else if (resolution.type === 'redirect') {
+ *     console.log(`${path} → Redirect to ${resolution.destination}`);
+ *   } else {
+ *     console.log(`${path} → Not found`);
+ *   }
+ * });
+ * ```
+ */
+declare function resolveRoutes(params: {
+    client: RiverbankClient;
+    siteId: string;
+    paths: string[];
+    preview?: boolean;
+}): Promise<Array<{
+    path: string;
+    resolution: RouteResolution;
+}>>;
+
+export { type ResolveRouteParams, type RouteResolution, resolveRoute, resolveRoutes };

package/dist/server/routing.d.ts

@@ -0,0 +1,115 @@
+import { R as RiverbankClient } from './types-C6gmRHLe.js';
+import { a as LoadPageResult } from './loadPage-BYmVMk0V.js';
+import '@riverbankcms/api';
+import 'react/jsx-runtime';
+import '@riverbankcms/blocks';
+import '@riverbankcms/blocks/system/data';
+import './types-Bbo01M7P.js';
+
+/**
+ * Route resolution helper for dynamic page routing
+ *
+ * Resolves URL paths to pages, entries, redirects, or 404s.
+ */
+
+type RouteResolution = {
+    type: 'page';
+    pageData: LoadPageResult;
+} | {
+    type: 'redirect';
+    destination: string;
+    permanent: boolean;
+} | {
+    type: 'not-found';
+};
+type ResolveRouteParams = {
+    /**
+     * Builder client instance
+     */
+    client: RiverbankClient;
+    /**
+     * Site ID
+     */
+    siteId: string;
+    /**
+     * URL path to resolve (e.g., '/about', '/blog/post-1')
+     */
+    path: string;
+    /**
+     * If true, fetches draft/unpublished content instead of published content.
+     * @default false
+     */
+    preview?: boolean;
+};
+/**
+ * Resolve a URL path to page data, redirect, or 404
+ *
+ * This helper attempts to fetch the page at the given path and returns
+ * a discriminated union indicating whether the page was found or not.
+ *
+ * **Note:** Redirect support is not yet implemented. The `redirect` type
+ * exists in the return type for future compatibility, but this function
+ * currently only returns `page` or `not-found` types.
+ *
+ * @example
+ * ```tsx
+ * import { resolveRoute } from '@riverbankcms/sdk/routing';
+ * import { notFound, redirect } from 'next/navigation';
+ *
+ * export default async function DynamicPage({ params }) {
+ *   const path = `/${params.slug?.join('/') || ''}`;
+ *   const resolution = await resolveRoute({
+ *     client,
+ *     siteId: 'your-site-id',
+ *     path,
+ *   });
+ *
+ *   if (resolution.type === 'redirect') {
+ *     redirect(resolution.destination);
+ *   }
+ *
+ *   if (resolution.type === 'not-found') {
+ *     notFound();
+ *   }
+ *
+ *   // resolution.type === 'page'
+ *   return <Page {...resolution.pageData} />;
+ * }
+ * ```
+ */
+declare function resolveRoute(params: ResolveRouteParams): Promise<RouteResolution>;
+/**
+ * Batch resolve multiple routes in parallel
+ *
+ * Useful for pre-fetching multiple routes or validating a sitemap.
+ *
+ * @example
+ * ```tsx
+ * const resolutions = await resolveRoutes({
+ *   client,
+ *   siteId: 'your-site-id',
+ *   paths: ['/', '/about', '/blog', '/contact'],
+ * });
+ *
+ * resolutions.forEach(({ path, resolution }) => {
+ *   if (resolution.type === 'page') {
+ *     console.log(`${path} → Page: ${resolution.pageData.page.name}`);
+ *   } else if (resolution.type === 'redirect') {
+ *     console.log(`${path} → Redirect to ${resolution.destination}`);
+ *   } else {
+ *     console.log(`${path} → Not found`);
+ *   }
+ * });
+ * ```
+ */
+declare function resolveRoutes(params: {
+    client: RiverbankClient;
+    siteId: string;
+    paths: string[];
+    preview?: boolean;
+}): Promise<Array<{
+    path: string;
+    resolution: RouteResolution;
+}>>;
+
+export { type ResolveRouteParams, type RouteResolution, resolveRoute, resolveRoutes };

package/dist/server/routing.js

@@ -0,0 +1,57 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }// src/routing/resolveRoute.ts
+async function resolveRoute(params) {
+  const { client, siteId, path, preview = false } = params;
+  try {
+    const pageResponse = await client.getPage({
+      siteId,
+      path,
+      preview
+    });
+    if (pageResponse) {
+      const { loadPage } = await Promise.resolve().then(() => _interopRequireWildcard(require("./loadPage-DVH3DW6E.js")));
+      const pageData = await loadPage({
+        client,
+        siteId,
+        path,
+        preview
+      });
+      return {
+        type: "page",
+        pageData
+      };
+    }
+  } catch (error) {
+    const is404 = error instanceof Error && (error.message.includes("404") || error.message.includes("Not Found") || error.message.includes("not found"));
+    if (is404) {
+      console.debug("[resolveRoute] Page not found", { path });
+    } else {
+      console.warn("[resolveRoute] Failed to fetch page", {
+        path,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return {
+    type: "not-found"
+  };
+}
+async function resolveRoutes(params) {
+  const { client, siteId, paths, preview } = params;
+  const resolutions = await Promise.all(
+    paths.map(async (path) => {
+      const resolution = await resolveRoute({
+        client,
+        siteId,
+        path,
+        preview
+      });
+      return { path, resolution };
+    })
+  );
+  return resolutions;
+}
+
+
+
+exports.resolveRoute = resolveRoute; exports.resolveRoutes = resolveRoutes;
+//# sourceMappingURL=routing.js.map

package/dist/server/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/routing.js","../../src/routing/resolveRoute.ts"],"names":[],"mappings":"AAAA;ACkFA,MAAA,SAAsB,YAAA,CACpB,MAAA,EAC0B;AAC1B,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAU,MAAM,EAAA,EAAI,MAAA;AAElD,EAAA,IAAI;AAEF,IAAA,MAAM,aAAA,EAAe,MAAM,MAAA,CAAO,OAAA,CAAQ;AAAA,MACxC,MAAA;AAAA,MACA,IAAA;AAAA,MACA;AAAA,IACF,CAAC,CAAA;AAED,IAAA,GAAA,CAAI,YAAA,EAAc;AAEhB,MAAA,MAAM,EAAE,SAAS,EAAA,EAAI,MAAM,4DAAA,CAAO,wBAA+B,GAAA;AACjE,MAAA,MAAM,SAAA,EAAW,MAAM,QAAA,CAAS;AAAA,QAC9B,MAAA;AAAA,QACA,MAAA;AAAA,QACA,IAAA;AAAA,QACA;AAAA,MACF,CAAC,CAAA;AAED,MAAA,OAAO;AAAA,QACL,IAAA,EAAM,MAAA;AAAA,QACN;AAAA,MACF,CAAA;AAAA,IACF;AAAA,EACF,EAAA,MAAA,CAAS,KAAA,EAAO;AAEd,IAAA,MAAM,MAAA,EAAQ,MAAA,WAAiB,MAAA,GAAA,CAC5B,KAAA,CAAM,OAAA,CAAQ,QAAA,CAAS,KAAK,EAAA,GAC5B,KAAA,CAAM,OAAA,CAAQ,QAAA,CAAS,WAAW,EAAA,GAClC,KAAA,CAAM,OAAA,CAAQ,QAAA,CAAS,WAAW,CAAA,CAAA;AAErC,IAAA,GAAA,CAAI,KAAA,EAAO;AACT,MAAA,OAAA,CAAQ,KAAA,CAAM,+BAAA,EAAiC,EAAE,KAAK,CAAC,CAAA;AAAA,IACzD,EAAA,KAAO;AAEL,MAAA,OAAA,CAAQ,IAAA,CAAK,qCAAA,EAAuC;AAAA,QAClD,IAAA;AAAA,QACA,KAAA,EAAO,MAAA,WAAiB,MAAA,EAAQ,KAAA,CAAM,QAAA,EAAU,MAAA,CAAO,KAAK;AAAA,MAC9D,CAAC,CAAA;AAAA,IACH;AAAA,EACF;AAIA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM;AAAA,EACR,CAAA;AACF;AA0BA,MAAA,SAAsB,aAAA,CAAc,MAAA,EAK8B;AAChE,EAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,QAAQ,EAAA,EAAI,MAAA;AAE3C,EAAA,MAAM,YAAA,EAAc,MAAM,OAAA,CAAQ,GAAA;AAAA,IAChC,KAAA,CAAM,GAAA,CAAI,MAAA,CAAO,IAAA,EAAA,GAAS;AACxB,MAAA,MAAM,WAAA,EAAa,MAAM,YAAA,CAAa;AAAA,QACpC,MAAA;AAAA,QACA,MAAA;AAAA,QACA,IAAA;AAAA,QACA;AAAA,MACF,CAAC,CAAA;AAED,MAAA,OAAO,EAAE,IAAA,EAAM,WAAW,CAAA;AAAA,IAC5B,CAAC;AAAA,EACH,CAAA;AAEA,EAAA,OAAO,WAAA;AACT;ADjIA;AACE;AACA;AACF,2EAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/routing.js","sourcesContent":[null,"/**\n * Route resolution helper for dynamic page routing\n *\n * Resolves URL paths to pages, entries, redirects, or 404s.\n */\n\nimport type { RiverbankClient } from '../client/types';\nimport type { LoadPageResult } from '../rendering/helpers/loadPage';\n\nexport type RouteResolution =\n  | {\n      type: 'page';\n      pageData: LoadPageResult;\n    }\n  | {\n      type: 'redirect';\n      destination: string;\n      permanent: boolean;\n    }\n  | {\n      type: 'not-found';\n    };\n\nexport type ResolveRouteParams = {\n  /**\n   * Builder client instance\n   */\n  client: RiverbankClient;\n\n  /**\n   * Site ID\n   */\n  siteId: string;\n\n  /**\n   * URL path to resolve (e.g., '/about', '/blog/post-1')\n   */\n  path: string;\n\n  /**\n   * If true, fetches draft/unpublished content instead of published content.\n   * @default false\n   */\n  preview?: boolean;\n};\n\n/**\n * Resolve a URL path to page data, redirect, or 404\n *\n * This helper attempts to fetch the page at the given path and returns\n * a discriminated union indicating whether the page was found or not.\n *\n * **Note:** Redirect support is not yet implemented. The `redirect` type\n * exists in the return type for future compatibility, but this function\n * currently only returns `page` or `not-found` types.\n *\n * @example\n * ```tsx\n * import { resolveRoute } from '@riverbankcms/sdk/routing';\n * import { notFound, redirect } from 'next/navigation';\n *\n * export default async function DynamicPage({ params }) {\n *   const path = `/${params.slug?.join('/') || ''}`;\n *   const resolution = await resolveRoute({\n *     client,\n *     siteId: 'your-site-id',\n *     path,\n *   });\n *\n *   if (resolution.type === 'redirect') {\n *     redirect(resolution.destination);\n *   }\n *\n *   if (resolution.type === 'not-found') {\n *     notFound();\n *   }\n *\n *   // resolution.type === 'page'\n *   return <Page {...resolution.pageData} />;\n * }\n * ```\n */\nexport async function resolveRoute(\n  params: ResolveRouteParams\n): Promise<RouteResolution> {\n  const { client, siteId, path, preview = false } = params;\n\n  try {\n    // Attempt to fetch page data\n    const pageResponse = await client.getPage({\n      siteId,\n      path,\n      preview,\n    });\n\n    if (pageResponse) {\n      // Successfully found page - load full page data\n      const { loadPage } = await import('../rendering/helpers/loadPage');\n      const pageData = await loadPage({\n        client,\n        siteId,\n        path,\n        preview,\n      });\n\n      return {\n        type: 'page',\n        pageData,\n      };\n    }\n  } catch (error) {\n    // Distinguish between expected 404s and unexpected errors\n    const is404 = error instanceof Error &&\n      (error.message.includes('404') ||\n       error.message.includes('Not Found') ||\n       error.message.includes('not found'));\n\n    if (is404) {\n      console.debug('[resolveRoute] Page not found', { path });\n    } else {\n      // Unexpected error - log as warning for visibility\n      console.warn('[resolveRoute] Failed to fetch page', {\n        path,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  // No page found - return not-found\n  // Note: Redirect support will be added when client.getRedirect() API is available\n  return {\n    type: 'not-found',\n  };\n}\n\n/**\n * Batch resolve multiple routes in parallel\n *\n * Useful for pre-fetching multiple routes or validating a sitemap.\n *\n * @example\n * ```tsx\n * const resolutions = await resolveRoutes({\n *   client,\n *   siteId: 'your-site-id',\n *   paths: ['/', '/about', '/blog', '/contact'],\n * });\n *\n * resolutions.forEach(({ path, resolution }) => {\n *   if (resolution.type === 'page') {\n *     console.log(`${path} → Page: ${resolution.pageData.page.name}`);\n *   } else if (resolution.type === 'redirect') {\n *     console.log(`${path} → Redirect to ${resolution.destination}`);\n *   } else {\n *     console.log(`${path} → Not found`);\n *   }\n * });\n * ```\n */\nexport async function resolveRoutes(params: {\n  client: RiverbankClient;\n  siteId: string;\n  paths: string[];\n  preview?: boolean;\n}): Promise<Array<{ path: string; resolution: RouteResolution }>> {\n  const { client, siteId, paths, preview } = params;\n\n  const resolutions = await Promise.all(\n    paths.map(async (path) => {\n      const resolution = await resolveRoute({\n        client,\n        siteId,\n        path,\n        preview,\n      });\n\n      return { path, resolution };\n    })\n  );\n\n  return resolutions;\n}\n"]}