@riverbankcms/sdk 0.4.1 → 0.4.2

package/dist/server/{loadPage-naVvoua8.d.ts → loadPage-BTkKpizX.d.ts}

@@ -1,10 +1,10 @@
-import { R as RiverbankClient, S as SiteResponse } from './types-CAnC529E.js';
+import { R as RiverbankClient, S as SiteResponse } from './types-oCM-fw4O.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
-import React__default, { ComponentType } from 'react';
+import React__default from 'react';
 import { P as PageOutline, S as SdkCustomBlock } from './schema-Bpy9N5ZI.js';
 import { z } from 'zod';
-import { T as Theme } from './types-5XdVD2J1.js';
+import { T as Theme } from './types-BiRZnxDx.js';
 import { R as ResolvedBlockData, D as DataLoaderOverrides } from './types-DuQCNVV0.js';
 
 declare const colorTokens: readonly ["background/base", "background/elevated", "surface/base", "surface/subtle", "surface/inverted", "content/primary", "content/secondary", "accent/primary", "accent/secondary", "border/base"];
@@ -64,22 +64,6 @@ type ResolverContext = {
     fragmentRegistry?: Record<string, any>;
 };
 
-type SystemBlockComponentProps<TContent = Record<string, unknown>> = {
-    content: TContent;
-    theme?: ThemeTokens;
-    themeConfig?: Theme;
-    registry?: ResolverContext["registry"];
-    transforms?: TransformRegistry;
-    viewModelOverrides?: Record<string, unknown>;
-    data?: Record<string, unknown>;
-    pathBase?: string;
-    blockId?: string | null;
-    blockKind?: string;
-    blockBindings?: Record<string, unknown>;
-    fragmentRegistry?: ResolverContext["fragmentRegistry"];
-};
-type SystemBlockComponent<TContent = Record<string, unknown>> = ComponentType<SystemBlockComponentProps<TContent>>;
-
 /**
  * Occurrence context for event pages.
  * Passed through to blocks that need occurrence information (e.g., event-registration).
@@ -101,15 +85,64 @@ type PageRendererDataContext = {
     occurrenceContext?: OccurrenceContextData | null;
     contentEntry?: Record<string, unknown> | null;
 };
+/**
+ * Props passed to block override components.
+ *
+ * These props are RSC-safe (no functions) so overrides can be Client Components.
+ * Unlike internal SDK block components, overrides don't receive `registry` or
+ * `fragmentRegistry` which contain function references that can't cross the
+ * RSC serialization boundary.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ *
+ * import type { BlockOverrideProps, HeroContent } from '@riverbankcms/sdk/rendering';
+ *
+ * export function CustomHero({ content, theme, data }: BlockOverrideProps<HeroContent>) {
+ *   const [expanded, setExpanded] = useState(false);
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+type BlockOverrideProps<TContent = Record<string, unknown>> = {
+    /** Block content data */
+    content: TContent;
+    /** Theme tokens for styling */
+    theme?: ThemeTokens;
+    /** Full theme configuration */
+    themeConfig?: Theme;
+    /** Pre-fetched data from data loaders */
+    data?: Record<string, unknown>;
+    /** Block instance ID (null for unsaved blocks) */
+    blockId: string | null;
+    /** Block kind identifier (e.g., "block.hero" or "custom.my-block") */
+    blockKind: string;
+};
 /**
  * Block override component type.
- * Override components receive the same props as default block components.
  *
- * Uses `any` for content type to allow typed components (e.g., SystemBlockComponentProps<HeroContent>)
- * to be used as overrides without type errors. The actual content type is validated at runtime
- * based on the block kind.
+ * Override components can be either Server Components or Client Components.
+ * They receive only serializable props (no functions) to support RSC boundaries.
+ *
+ * @example Server Component override
+ * ```tsx
+ * export function CustomHero({ content, theme, data }: BlockOverrideProps<HeroContent>) {
+ *   return <div className="custom-hero">...</div>;
+ * }
+ * ```
+ *
+ * @example Client Component override
+ * ```tsx
+ * 'use client';
+ *
+ * export function CustomHero({ content, theme, data }: BlockOverrideProps<HeroContent>) {
+ *   const [state, setState] = useState(null);
+ *   return <div className="custom-hero">...</div>;
+ * }
+ * ```
  */
-type BlockOverrideComponent = SystemBlockComponent<any>;
+type BlockOverrideComponent = React$1.ComponentType<BlockOverrideProps<any>>;
 /**
  * Map of block kinds to custom override components.
  * Keys can be either:
@@ -119,8 +152,8 @@ type BlockOverrideComponent = SystemBlockComponent<any>;
  * @example
  * ```tsx
  * const overrides: BlockOverrides = {
- *   'hero': CustomHero,        // CustomHero: SystemBlockComponentProps<HeroContent>
- *   'bodyText': CustomBodyText, // CustomBodyText: SystemBlockComponentProps<BodyTextContent>
+ *   'hero': CustomHero,        // CustomHero uses BlockOverrideProps<HeroContent>
+ *   'bodyText': CustomBodyText, // CustomBodyText uses BlockOverrideProps<BodyTextContent>
  * };
  * ```
  */
@@ -374,4 +407,4 @@ type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholder
  */
 declare function loadPage(params: LoadPageParams): Promise<LoadPageResult>;
 
-export { type BlockOverrides as B, type LoadPageParams as L, type PageProps as P, type RuntimeSdkConfig as R, type SystemBlockComponentProps as S, type ThemeTokens as T, type LoadPageResult as a, Page as b, PageRenderer as c, type RouteMap as d, type BlockOverrideComponent as e, loadPage as l };
+export { type BlockOverrides as B, type LoadPageParams as L, type PageProps as P, type RuntimeSdkConfig as R, type ThemeTokens as T, type LoadPageResult as a, Page as b, PageRenderer as c, type RouteMap as d, type BlockOverrideComponent as e, type BlockOverrideProps as f, type ResolverContext as g, type TransformRegistry as h, loadPage as l };

package/dist/server/metadata.d.mts

@@ -1,10 +1,10 @@
-import { a as LoadPageResult } from './loadPage-mavT3Jae.mjs';
-import { S as SiteResponse } from './types-BC9eB2KH.mjs';
+import { a as LoadPageResult } from './loadPage-B8RmlYgV.mjs';
+import { S as SiteResponse } from './types-DkKEctWn.mjs';
 import 'react/jsx-runtime';
 import 'react';
 import './schema-Bpy9N5ZI.mjs';
 import 'zod';
-import './types-BA-J9K8r.mjs';
+import './types-CdrJqlKx.mjs';
 import '@riverbankcms/ai';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';

package/dist/server/metadata.d.ts

@@ -1,10 +1,10 @@
-import { a as LoadPageResult } from './loadPage-naVvoua8.js';
-import { S as SiteResponse } from './types-CAnC529E.js';
+import { a as LoadPageResult } from './loadPage-BTkKpizX.js';
+import { S as SiteResponse } from './types-oCM-fw4O.js';
 import 'react/jsx-runtime';
 import 'react';
 import './schema-Bpy9N5ZI.js';
 import 'zod';
-import './types-5XdVD2J1.js';
+import './types-BiRZnxDx.js';
 import '@riverbankcms/ai';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';

package/dist/server/navigation.d.mts

@@ -1,5 +1,5 @@
-import { N as NavigationMenuWithItems } from './types-BA-J9K8r.mjs';
-export { L as LinkPayload, a as NavigationItemRecord } from './types-BA-J9K8r.mjs';
+import { N as NavigationMenuWithItems } from './types-CdrJqlKx.mjs';
+export { L as LinkPayload, a as NavigationItemRecord } from './types-CdrJqlKx.mjs';
 import '@riverbankcms/ai';
 import './schema-Bpy9N5ZI.mjs';
 import 'zod';

package/dist/server/navigation.d.ts

@@ -1,5 +1,5 @@
-import { N as NavigationMenuWithItems } from './types-5XdVD2J1.js';
-export { L as LinkPayload, a as NavigationItemRecord } from './types-5XdVD2J1.js';
+import { N as NavigationMenuWithItems } from './types-BiRZnxDx.js';
+export { L as LinkPayload, a as NavigationItemRecord } from './types-BiRZnxDx.js';
 import '@riverbankcms/ai';
 import './schema-Bpy9N5ZI.js';
 import 'zod';

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

@@ -1,10 +1,10 @@
-export { b as Page, P as PageProps } from '../loadPage-mavT3Jae.mjs';
-export { H as HeaderData, L as Layout, a as LayoutProps } from '../Layout-B_zUr9ci.mjs';
+export { b as Page, P as PageProps } from '../loadPage-B8RmlYgV.mjs';
+export { H as HeaderData, L as Layout, a as LayoutProps } from '../Layout-ByUnm35V.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { T as Theme } from '../types-BA-J9K8r.mjs';
+import { T as Theme } from '../types-CdrJqlKx.mjs';
 import '../schema-Bpy9N5ZI.mjs';
-import { R as RiverbankClient } from '../types-BC9eB2KH.mjs';
+import { R as RiverbankClient } from '../types-DkKEctWn.mjs';
 import { B as BlockKind } from '../blockKinds-B6MWzNWp.mjs';
 import 'zod';
 import '../types-CbagRQ_7.mjs';

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

@@ -1,10 +1,10 @@
-export { b as Page, P as PageProps } from '../loadPage-naVvoua8.js';
-export { H as HeaderData, L as Layout, a as LayoutProps } from '../Layout-CHG77dhK.js';
+export { b as Page, P as PageProps } from '../loadPage-BTkKpizX.js';
+export { H as HeaderData, L as Layout, a as LayoutProps } from '../Layout-kRv5sU81.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { T as Theme } from '../types-5XdVD2J1.js';
+import { T as Theme } from '../types-BiRZnxDx.js';
 import '../schema-Bpy9N5ZI.js';
-import { R as RiverbankClient } from '../types-CAnC529E.js';
+import { R as RiverbankClient } from '../types-oCM-fw4O.js';
 import { B as BlockKind } from '../blockKinds-B6MWzNWp.js';
 import 'zod';
 import '../types-DuQCNVV0.js';

package/dist/server/rendering/server.js

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkBUCJWG6Gjs = require('../chunk-BUCJWG6G.js');
+var _chunkNW5KHH4Ajs = require('../chunk-NW5KHH4A.js');
 
 
 
-var _chunkP6CDRJN3js = require('../chunk-P6CDRJN3.js');
-require('../chunk-IT5ICP43.js');
+var _chunkBLKVTULPjs = require('../chunk-BLKVTULP.js');
+require('../chunk-TKMA6D6U.js');
 require('../chunk-HOY77YBF.js');
 require('../chunk-EGTDJ4PL.js');
 require('../chunk-DGUM43GV.js');
@@ -13,5 +13,5 @@ require('../chunk-DGUM43GV.js');
 
 
 
-exports.Block = _chunkBUCJWG6Gjs.Block; exports.Layout = _chunkP6CDRJN3js.Layout; exports.Page = _chunkP6CDRJN3js.Page;
+exports.Block = _chunkNW5KHH4Ajs.Block; exports.Layout = _chunkBLKVTULPjs.Layout; exports.Page = _chunkBLKVTULPjs.Page;
 //# sourceMappingURL=server.js.map

package/dist/server/rendering/server.mjs

@@ -1,11 +1,11 @@
 import {
   Block
-} from "../chunk-XK2YIISA.mjs";
+} from "../chunk-SPXMMX3C.mjs";
 import {
   Layout,
   Page
-} from "../chunk-SFQ7VF3G.mjs";
-import "../chunk-NKXS4TBK.mjs";
+} from "../chunk-7BOIO2S7.mjs";
+import "../chunk-TNRADRPH.mjs";
 import "../chunk-7DS4Q3GA.mjs";
 import "../chunk-USQF2XTU.mjs";
 import "../chunk-BJTO5JO5.mjs";

package/dist/server/rendering.d.mts

@@ -1,12 +1,12 @@
-export { e as BlockOverrideComponent, B as BlockOverrides, L as LoadPageParams, a as LoadPageResult, b as Page, P as PageProps, c as PageRenderer, d as RouteMap, S as SystemBlockComponentProps, T as ThemeTokens, l as loadPage } from './loadPage-mavT3Jae.mjs';
-export { H as HeaderData, L as Layout, a as LayoutProps } from './Layout-B_zUr9ci.mjs';
+export { e as BlockOverrideComponent, f as BlockOverrideProps, B as BlockOverrides, L as LoadPageParams, a as LoadPageResult, b as Page, P as PageProps, c as PageRenderer, d as RouteMap, T as ThemeTokens, l as loadPage } from './loadPage-B8RmlYgV.mjs';
+export { H as HeaderData, L as Layout, a as LayoutProps } from './Layout-ByUnm35V.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-C_FipaAC.mjs';
-export { C as CustomLinkValue, E as ExternalLinkValue, I as InternalLinkValue, d as LinkValue, c as SiteFooterContent, S as SiteHeaderContent, T as Theme } from './types-BA-J9K8r.mjs';
+export { C as ContentEntryData, L as LoadContentParams, b as LoadContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-CWuE8FCx.mjs';
+export { C as CustomLinkValue, E as ExternalLinkValue, I as InternalLinkValue, d as LinkValue, c as SiteFooterContent, S as SiteHeaderContent, T as Theme } from './types-CdrJqlKx.mjs';
 export { P as PageOutline } from './schema-Bpy9N5ZI.mjs';
-import { G as GradientConfig, M as Media } from './components-Bo3LPpVb.mjs';
-export { e as BackgroundInput, B as BodyTextContent, H as HeroContent, a as HeroMedia, f as ResolvedBackground, R as RichText, c as RichTextPrimitiveProps, S as SectionBackground, g as SectionBackgroundProps, T as TipTapNode, b as buildThemeRuntime, d as resolveBackground, r as resolveImageUrl } from './components-Bo3LPpVb.mjs';
-import './types-BC9eB2KH.mjs';
+import { G as GradientConfig, M as Media } from './components-CY8jDQjv.mjs';
+export { f as BackgroundInput, B as BodyTextContent, H as HeroContent, a as HeroMedia, g as ResolvedBackground, R as RichText, c as RichTextPrimitiveProps, e as SectionBackground, h as SectionBackgroundProps, S as SystemBlockComponentProps, T as TipTapNode, b as buildThemeRuntime, d as resolveBackground, r as resolveImageUrl } from './components-CY8jDQjv.mjs';
+import './types-DkKEctWn.mjs';
 import 'react/jsx-runtime';
 import 'react';
 import 'zod';

package/dist/server/rendering.d.ts

@@ -1,12 +1,12 @@
-export { e as BlockOverrideComponent, B as BlockOverrides, L as LoadPageParams, a as LoadPageResult, b as Page, P as PageProps, c as PageRenderer, d as RouteMap, S as SystemBlockComponentProps, T as ThemeTokens, l as loadPage } from './loadPage-naVvoua8.js';
-export { H as HeaderData, L as Layout, a as LayoutProps } from './Layout-CHG77dhK.js';
+export { e as BlockOverrideComponent, f as BlockOverrideProps, B as BlockOverrides, L as LoadPageParams, a as LoadPageResult, b as Page, P as PageProps, c as PageRenderer, d as RouteMap, T as ThemeTokens, l as loadPage } from './loadPage-BTkKpizX.js';
+export { H as HeaderData, L as Layout, a as LayoutProps } from './Layout-kRv5sU81.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-C2SwqmXy.js';
-export { C as CustomLinkValue, E as ExternalLinkValue, I as InternalLinkValue, d as LinkValue, c as SiteFooterContent, S as SiteHeaderContent, T as Theme } from './types-5XdVD2J1.js';
+export { C as ContentEntryData, L as LoadContentParams, b as LoadContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-DynBuR5f.js';
+export { C as CustomLinkValue, E as ExternalLinkValue, I as InternalLinkValue, d as LinkValue, c as SiteFooterContent, S as SiteHeaderContent, T as Theme } from './types-BiRZnxDx.js';
 export { P as PageOutline } from './schema-Bpy9N5ZI.js';
-import { G as GradientConfig, M as Media } from './components-ClFs4PUa.js';
-export { e as BackgroundInput, B as BodyTextContent, H as HeroContent, a as HeroMedia, f as ResolvedBackground, R as RichText, c as RichTextPrimitiveProps, S as SectionBackground, g as SectionBackgroundProps, T as TipTapNode, b as buildThemeRuntime, d as resolveBackground, r as resolveImageUrl } from './components-ClFs4PUa.js';
-import './types-CAnC529E.js';
+import { G as GradientConfig, M as Media } from './components-D1Z2mSDr.js';
+export { f as BackgroundInput, B as BodyTextContent, H as HeroContent, a as HeroMedia, g as ResolvedBackground, R as RichText, c as RichTextPrimitiveProps, e as SectionBackground, h as SectionBackgroundProps, S as SystemBlockComponentProps, T as TipTapNode, b as buildThemeRuntime, d as resolveBackground, r as resolveImageUrl } from './components-D1Z2mSDr.js';
+import './types-oCM-fw4O.js';
 import 'react/jsx-runtime';
 import 'react';
 import 'zod';

package/dist/server/rendering.js

@@ -8,11 +8,11 @@ var _chunkTO7FD6TQjs = require('./chunk-TO7FD6TQ.js');
 var _chunkSWPHIUVEjs = require('./chunk-SWPHIUVE.js');
 
 
-var _chunkBUCJWG6Gjs = require('./chunk-BUCJWG6G.js');
+var _chunkNW5KHH4Ajs = require('./chunk-NW5KHH4A.js');
 
 
 
-var _chunkP6CDRJN3js = require('./chunk-P6CDRJN3.js');
+var _chunkBLKVTULPjs = require('./chunk-BLKVTULP.js');
 
 
 
@@ -20,7 +20,7 @@ var _chunkP6CDRJN3js = require('./chunk-P6CDRJN3.js');
 
 
 
-var _chunkIT5ICP43js = require('./chunk-IT5ICP43.js');
+var _chunkTKMA6D6Ujs = require('./chunk-TKMA6D6U.js');
 require('./chunk-Y7347JMZ.js');
 require('./chunk-HOY77YBF.js');
 require('./chunk-EGTDJ4PL.js');
@@ -39,5 +39,5 @@ require('./chunk-DGUM43GV.js');
 
 
 
-exports.Block = _chunkBUCJWG6Gjs.Block; exports.Layout = _chunkP6CDRJN3js.Layout; exports.Page = _chunkP6CDRJN3js.Page; exports.PageRenderer = _chunkIT5ICP43js.PageRenderer; exports.RichText = _chunkIT5ICP43js.RichText; exports.SectionBackground = _chunkIT5ICP43js.SectionBackground; exports.buildThemeRuntime = _chunkIT5ICP43js.buildThemeRuntime; exports.isEntryContent = _chunkTO7FD6TQjs.isEntryContent; exports.isPageContent = _chunkTO7FD6TQjs.isPageContent; exports.loadContent = _chunkTO7FD6TQjs.loadContent; exports.loadPage = _chunkSWPHIUVEjs.loadPage; exports.resolveBackground = _chunkIT5ICP43js.resolveBackground; exports.resolveImageUrl = _chunkIT5ICP43js.resolveImageUrl;
+exports.Block = _chunkNW5KHH4Ajs.Block; exports.Layout = _chunkBLKVTULPjs.Layout; exports.Page = _chunkBLKVTULPjs.Page; exports.PageRenderer = _chunkTKMA6D6Ujs.PageRenderer; exports.RichText = _chunkTKMA6D6Ujs.RichText; exports.SectionBackground = _chunkTKMA6D6Ujs.SectionBackground; exports.buildThemeRuntime = _chunkTKMA6D6Ujs.buildThemeRuntime; exports.isEntryContent = _chunkTO7FD6TQjs.isEntryContent; exports.isPageContent = _chunkTO7FD6TQjs.isPageContent; exports.loadContent = _chunkTO7FD6TQjs.loadContent; exports.loadPage = _chunkSWPHIUVEjs.loadPage; exports.resolveBackground = _chunkTKMA6D6Ujs.resolveBackground; exports.resolveImageUrl = _chunkTKMA6D6Ujs.resolveImageUrl;
 //# sourceMappingURL=rendering.js.map

package/dist/server/rendering.mjs

@@ -8,11 +8,11 @@ import {
 } from "./chunk-ZEAJW6T3.mjs";
 import {
   Block
-} from "./chunk-XK2YIISA.mjs";
+} from "./chunk-SPXMMX3C.mjs";
 import {
   Layout,
   Page
-} from "./chunk-SFQ7VF3G.mjs";
+} from "./chunk-7BOIO2S7.mjs";
 import {
   PageRenderer,
   RichText,
@@ -20,7 +20,7 @@ import {
   buildThemeRuntime,
   resolveBackground,
   resolveImageUrl
-} from "./chunk-NKXS4TBK.mjs";
+} from "./chunk-TNRADRPH.mjs";
 import "./chunk-A2FZMRDW.mjs";
 import "./chunk-7DS4Q3GA.mjs";
 import "./chunk-USQF2XTU.mjs";

package/dist/server/routing.d.mts

@@ -1,8 +1,9 @@
-import { R as RiverbankClient } from './types-BC9eB2KH.mjs';
-import { a as LoadPageResult } from './loadPage-mavT3Jae.mjs';
-import './types-BA-J9K8r.mjs';
-import '@riverbankcms/ai';
+import { R as RiverbankClient } from './types-DkKEctWn.mjs';
+import { a as LoadPageResult } from './loadPage-B8RmlYgV.mjs';
+import { R as RiverbankSiteConfig } from './types-txWsSxN7.mjs';
 import './schema-Bpy9N5ZI.mjs';
+import './types-CdrJqlKx.mjs';
+import '@riverbankcms/ai';
 import 'zod';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
@@ -117,4 +118,76 @@ declare function resolveRoutes(params: {
     resolution: RouteResolution;
 }>>;
 
-export { type ResolveRouteParams, type RouteResolution, resolveRoute, resolveRoutes };
+/**
+ * Content route matching utilities.
+ *
+ * Derive route matching from SDK config to determine whether a URL path
+ * is a CMS page or a content entry, without duplicating route patterns.
+ */
+
+/**
+ * Extract the first path segment from each routable content type's routePattern.
+ *
+ * Useful for simple prefix-based routing decisions. For more precise matching
+ * that handles nested patterns, use `isContentEntryPath` instead.
+ *
+ * @param config - The SDK config object from defineConfig()
+ * @returns Array of first path segments from content type routePatterns
+ *
+ * @example
+ * ```typescript
+ * import { getContentEntryPrefixes } from '@riverbankcms/sdk/routing';
+ * import config from '../riverbank.config';
+ *
+ * // Config with routePatterns: '/blog/{slug}', '/work/projects/{slug}'
+ * const prefixes = getContentEntryPrefixes(config);
+ * // Returns ['blog', 'work']
+ * ```
+ */
+declare function getContentEntryPrefixes(config: RiverbankSiteConfig): string[];
+/**
+ * Result of checking if a path matches a content entry route.
+ */
+type ContentEntryMatch = {
+    /** Whether the path matches a content entry route pattern */
+    isEntry: boolean;
+    /** The content type key if matched (e.g., 'blog-post') */
+    contentType?: string;
+    /** The slug extracted from the path if matched */
+    slug?: string;
+};
+/**
+ * Check if a URL path matches any content entry route pattern.
+ *
+ * Supports nested patterns like '/work/projects/{slug}'. Returns the matched
+ * content type key and extracted slug, useful for routing decisions.
+ *
+ * **Note:** Content types are checked in array order. If multiple patterns
+ * could match a path, the first matching content type wins. Order more specific
+ * patterns before generic ones in your config.
+ *
+ * @param config - The SDK config object from defineConfig()
+ * @param path - URL path as string ('/blog/my-post') or segments ['blog', 'my-post']
+ * @returns Match result with content type and slug if matched
+ *
+ * @example
+ * ```typescript
+ * import { isContentEntryPath } from '@riverbankcms/sdk/routing';
+ * import config from '../riverbank.config';
+ *
+ * // Simple pattern: '/blog/{slug}'
+ * isContentEntryPath(config, '/blog/my-post');
+ * // Returns { isEntry: true, contentType: 'blog-post', slug: 'my-post' }
+ *
+ * // Nested pattern: '/work/projects/{slug}'
+ * isContentEntryPath(config, '/work/projects/website-redesign');
+ * // Returns { isEntry: true, contentType: 'project', slug: 'website-redesign' }
+ *
+ * // Non-matching path
+ * isContentEntryPath(config, '/about');
+ * // Returns { isEntry: false }
+ * ```
+ */
+declare function isContentEntryPath(config: RiverbankSiteConfig, path: string | string[]): ContentEntryMatch;
+
+export { type ContentEntryMatch, type ResolveRouteParams, type RouteResolution, getContentEntryPrefixes, isContentEntryPath, resolveRoute, resolveRoutes };

package/dist/server/routing.d.ts

@@ -1,8 +1,9 @@
-import { R as RiverbankClient } from './types-CAnC529E.js';
-import { a as LoadPageResult } from './loadPage-naVvoua8.js';
-import './types-5XdVD2J1.js';
-import '@riverbankcms/ai';
+import { R as RiverbankClient } from './types-oCM-fw4O.js';
+import { a as LoadPageResult } from './loadPage-BTkKpizX.js';
+import { R as RiverbankSiteConfig } from './types-CL916r6x.js';
 import './schema-Bpy9N5ZI.js';
+import './types-BiRZnxDx.js';
+import '@riverbankcms/ai';
 import 'zod';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
@@ -117,4 +118,76 @@ declare function resolveRoutes(params: {
     resolution: RouteResolution;
 }>>;
 
-export { type ResolveRouteParams, type RouteResolution, resolveRoute, resolveRoutes };
+/**
+ * Content route matching utilities.
+ *
+ * Derive route matching from SDK config to determine whether a URL path
+ * is a CMS page or a content entry, without duplicating route patterns.
+ */
+
+/**
+ * Extract the first path segment from each routable content type's routePattern.
+ *
+ * Useful for simple prefix-based routing decisions. For more precise matching
+ * that handles nested patterns, use `isContentEntryPath` instead.
+ *
+ * @param config - The SDK config object from defineConfig()
+ * @returns Array of first path segments from content type routePatterns
+ *
+ * @example
+ * ```typescript
+ * import { getContentEntryPrefixes } from '@riverbankcms/sdk/routing';
+ * import config from '../riverbank.config';
+ *
+ * // Config with routePatterns: '/blog/{slug}', '/work/projects/{slug}'
+ * const prefixes = getContentEntryPrefixes(config);
+ * // Returns ['blog', 'work']
+ * ```
+ */
+declare function getContentEntryPrefixes(config: RiverbankSiteConfig): string[];
+/**
+ * Result of checking if a path matches a content entry route.
+ */
+type ContentEntryMatch = {
+    /** Whether the path matches a content entry route pattern */
+    isEntry: boolean;
+    /** The content type key if matched (e.g., 'blog-post') */
+    contentType?: string;
+    /** The slug extracted from the path if matched */
+    slug?: string;
+};
+/**
+ * Check if a URL path matches any content entry route pattern.
+ *
+ * Supports nested patterns like '/work/projects/{slug}'. Returns the matched
+ * content type key and extracted slug, useful for routing decisions.
+ *
+ * **Note:** Content types are checked in array order. If multiple patterns
+ * could match a path, the first matching content type wins. Order more specific
+ * patterns before generic ones in your config.
+ *
+ * @param config - The SDK config object from defineConfig()
+ * @param path - URL path as string ('/blog/my-post') or segments ['blog', 'my-post']
+ * @returns Match result with content type and slug if matched
+ *
+ * @example
+ * ```typescript
+ * import { isContentEntryPath } from '@riverbankcms/sdk/routing';
+ * import config from '../riverbank.config';
+ *
+ * // Simple pattern: '/blog/{slug}'
+ * isContentEntryPath(config, '/blog/my-post');
+ * // Returns { isEntry: true, contentType: 'blog-post', slug: 'my-post' }
+ *
+ * // Nested pattern: '/work/projects/{slug}'
+ * isContentEntryPath(config, '/work/projects/website-redesign');
+ * // Returns { isEntry: true, contentType: 'project', slug: 'website-redesign' }
+ *
+ * // Non-matching path
+ * isContentEntryPath(config, '/about');
+ * // Returns { isEntry: false }
+ * ```
+ */
+declare function isContentEntryPath(config: RiverbankSiteConfig, path: string | string[]): ContentEntryMatch;
+
+export { type ContentEntryMatch, type ResolveRouteParams, type RouteResolution, getContentEntryPrefixes, isContentEntryPath, resolveRoute, resolveRoutes };

package/dist/server/routing.js

@@ -1,4 +1,4 @@
-"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; } }require('./chunk-DGUM43GV.js');
+"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; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }require('./chunk-DGUM43GV.js');
 
 // src/routing/resolveRoute.ts
 async function resolveRoute(params) {
@@ -53,7 +53,61 @@ async function resolveRoutes(params) {
   return resolutions;
 }
 
+// src/routing/contentRoutes.ts
+function getContentEntryPrefixes(config) {
+  const contentTypes = _nullishCoalesce(_optionalChain([config, 'access', _ => _.content, 'optionalAccess', _2 => _2.contentTypes]), () => ( []));
+  return contentTypes.filter(
+    (ct) => ct.hasPages && typeof ct.routePattern === "string"
+  ).map((ct) => {
+    const match = ct.routePattern.match(/^\/([^/]+)/);
+    const segment = _optionalChain([match, 'optionalAccess', _3 => _3[1]]);
+    if (_optionalChain([segment, 'optionalAccess', _4 => _4.includes, 'call', _5 => _5("{")])) return void 0;
+    return segment;
+  }).filter((prefix) => typeof prefix === "string");
+}
+function isContentEntryPath(config, path) {
+  const segments = typeof path === "string" ? path.split("/").filter(Boolean) : path;
+  const contentTypes = _nullishCoalesce(_optionalChain([config, 'access', _6 => _6.content, 'optionalAccess', _7 => _7.contentTypes]), () => ( []));
+  for (const ct of contentTypes) {
+    if (!ct.hasPages || !ct.routePattern) continue;
+    const patternSegments = parseRoutePattern(ct.routePattern);
+    const match = matchPattern(segments, patternSegments);
+    if (match.matches) {
+      return {
+        isEntry: true,
+        contentType: ct.key,
+        slug: match.slug
+      };
+    }
+  }
+  return { isEntry: false };
+}
+function parseRoutePattern(pattern) {
+  const segments = pattern.split("/").filter(Boolean);
+  const staticSegments = [];
+  for (const segment of segments) {
+    if (segment.includes("{")) break;
+    staticSegments.push(segment);
+  }
+  return staticSegments;
+}
+function matchPattern(pathSegments, patternSegments) {
+  if (pathSegments.length < patternSegments.length + 1) {
+    return { matches: false };
+  }
+  for (let i = 0; i < patternSegments.length; i++) {
+    if (pathSegments[i] !== patternSegments[i]) {
+      return { matches: false };
+    }
+  }
+  const slugSegments = pathSegments.slice(patternSegments.length);
+  const slug = slugSegments.join("/");
+  return { matches: true, slug };
+}
+
+
+
 
 
-exports.resolveRoute = resolveRoute; exports.resolveRoutes = resolveRoutes;
+exports.getContentEntryPrefixes = getContentEntryPrefixes; exports.isContentEntryPath = isContentEntryPath; exports.resolveRoute = resolveRoute; exports.resolveRoutes = resolveRoutes;
 //# sourceMappingURL=routing.js.map