@riverbankcms/sdk 0.4.2 → 0.5.0

package/dist/server/routing.mjs

@@ -1,5 +1,34 @@
 import "./chunk-BJTO5JO5.mjs";
 
+// src/routing/checkRedirect.ts
+async function checkRedirectForPath(params) {
+  const { client, siteId, path } = params;
+  try {
+    const response = await client.checkRedirect({
+      siteId,
+      path
+    });
+    if (response.redirectTo) {
+      const isPermanent = response.status === 301 || response.status === 308;
+      return {
+        hasRedirect: true,
+        redirect: {
+          destination: response.redirectTo,
+          permanent: isPermanent
+        }
+      };
+    }
+    return { hasRedirect: false, redirect: null };
+  } catch (error) {
+    console.warn("[checkRedirectForPath] Failed to check redirect", {
+      siteId,
+      path,
+      error: error instanceof Error ? error.message : String(error)
+    });
+    return { hasRedirect: false, redirect: null };
+  }
+}
+
 // src/routing/resolveRoute.ts
 async function resolveRoute(params) {
   const { client, siteId, path, preview = false } = params;
@@ -10,7 +39,7 @@ async function resolveRoute(params) {
       preview
     });
     if (pageResponse) {
-      const { loadPage } = await import("./loadPage-LYVKY3WZ.mjs");
+      const { loadPage } = await import("./loadPage-DNQTTRHL.mjs");
       const pageData = await loadPage({
         client,
         siteId,
@@ -33,6 +62,25 @@ async function resolveRoute(params) {
       });
     }
   }
+  try {
+    const redirectResult = await checkRedirectForPath({
+      client,
+      siteId,
+      path
+    });
+    if (redirectResult.hasRedirect) {
+      return {
+        type: "redirect",
+        destination: redirectResult.redirect.destination,
+        permanent: redirectResult.redirect.permanent
+      };
+    }
+  } catch (redirectError) {
+    console.debug("[resolveRoute] Redirect check failed", {
+      path,
+      error: redirectError instanceof Error ? redirectError.message : String(redirectError)
+    });
+  }
   return {
     type: "not-found"
   };
@@ -104,9 +152,54 @@ function matchPattern(pathSegments, patternSegments) {
   const slug = slugSegments.join("/");
   return { matches: true, slug };
 }
+
+// src/routing/resolveOccurrence.ts
+function isISODateString(str) {
+  return /^\d{4}-\d{2}-\d{2}$/.test(str);
+}
+function isUUID(str) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(str);
+}
+function isValidSegment(segment) {
+  return isISODateString(segment) || isUUID(segment);
+}
+async function resolveOccurrence(params) {
+  const { client, siteId, entryId, segment } = params;
+  if (!isValidSegment(segment)) {
+    console.debug("[resolveOccurrence] Invalid segment format", { segment });
+    return { found: false, occurrence: null };
+  }
+  try {
+    const response = await client.resolveEventOccurrence({
+      siteId,
+      entryId,
+      segment
+    });
+    if (response.occurrence) {
+      return {
+        found: true,
+        occurrence: response.occurrence
+      };
+    }
+    return { found: false, occurrence: null };
+  } catch (error) {
+    console.warn("[resolveOccurrence] Failed to resolve occurrence", {
+      siteId,
+      entryId,
+      segment,
+      error: error instanceof Error ? error.message : String(error)
+    });
+    return { found: false, occurrence: null };
+  }
+}
 export {
+  checkRedirectForPath,
   getContentEntryPrefixes,
   isContentEntryPath,
+  isISODateString,
+  isUUID,
+  isValidSegment,
+  resolveOccurrence,
   resolveRoute,
   resolveRoutes
 };

package/dist/server/routing.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/routing/resolveRoute.ts","../../src/routing/contentRoutes.ts"],"sourcesContent":["/**\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","/**\n * Content route matching utilities.\n *\n * Derive route matching from SDK config to determine whether a URL path\n * is a CMS page or a content entry, without duplicating route patterns.\n */\n\nimport type { RiverbankSiteConfig, ContentTypeConfig } from '../config';\n\n/**\n * Extract the first path segment from each routable content type's routePattern.\n *\n * Useful for simple prefix-based routing decisions. For more precise matching\n * that handles nested patterns, use `isContentEntryPath` instead.\n *\n * @param config - The SDK config object from defineConfig()\n * @returns Array of first path segments from content type routePatterns\n *\n * @example\n * ```typescript\n * import { getContentEntryPrefixes } from '@riverbankcms/sdk/routing';\n * import config from '../riverbank.config';\n *\n * // Config with routePatterns: '/blog/{slug}', '/work/projects/{slug}'\n * const prefixes = getContentEntryPrefixes(config);\n * // Returns ['blog', 'work']\n * ```\n */\nexport function getContentEntryPrefixes(config: RiverbankSiteConfig): string[] {\n  const contentTypes = config.content?.contentTypes ?? [];\n\n  return contentTypes\n    .filter((ct): ct is ContentTypeConfig & { routePattern: string } =>\n      ct.hasPages && typeof ct.routePattern === 'string'\n    )\n    .map(ct => {\n      // '/blog/{slug}' → 'blog'\n      // '/work/projects/{slug}' → 'work'\n      // '/{slug}' → undefined (no static prefix)\n      const match = ct.routePattern.match(/^\\/([^/]+)/);\n      const segment = match?.[1];\n      // Skip dynamic segments (those containing {})\n      if (segment?.includes('{')) return undefined;\n      return segment;\n    })\n    .filter((prefix): prefix is string => typeof prefix === 'string');\n}\n\n/**\n * Result of checking if a path matches a content entry route.\n */\nexport type ContentEntryMatch = {\n  /** Whether the path matches a content entry route pattern */\n  isEntry: boolean;\n  /** The content type key if matched (e.g., 'blog-post') */\n  contentType?: string;\n  /** The slug extracted from the path if matched */\n  slug?: string;\n};\n\n/**\n * Check if a URL path matches any content entry route pattern.\n *\n * Supports nested patterns like '/work/projects/{slug}'. Returns the matched\n * content type key and extracted slug, useful for routing decisions.\n *\n * **Note:** Content types are checked in array order. If multiple patterns\n * could match a path, the first matching content type wins. Order more specific\n * patterns before generic ones in your config.\n *\n * @param config - The SDK config object from defineConfig()\n * @param path - URL path as string ('/blog/my-post') or segments ['blog', 'my-post']\n * @returns Match result with content type and slug if matched\n *\n * @example\n * ```typescript\n * import { isContentEntryPath } from '@riverbankcms/sdk/routing';\n * import config from '../riverbank.config';\n *\n * // Simple pattern: '/blog/{slug}'\n * isContentEntryPath(config, '/blog/my-post');\n * // Returns { isEntry: true, contentType: 'blog-post', slug: 'my-post' }\n *\n * // Nested pattern: '/work/projects/{slug}'\n * isContentEntryPath(config, '/work/projects/website-redesign');\n * // Returns { isEntry: true, contentType: 'project', slug: 'website-redesign' }\n *\n * // Non-matching path\n * isContentEntryPath(config, '/about');\n * // Returns { isEntry: false }\n * ```\n */\nexport function isContentEntryPath(\n  config: RiverbankSiteConfig,\n  path: string | string[]\n): ContentEntryMatch {\n  const segments = typeof path === 'string'\n    ? path.split('/').filter(Boolean)\n    : path;\n\n  const contentTypes = config.content?.contentTypes ?? [];\n\n  for (const ct of contentTypes) {\n    if (!ct.hasPages || !ct.routePattern) continue;\n\n    // Parse pattern: '/blog/{slug}' → ['blog'], '/work/projects/{slug}' → ['work', 'projects']\n    const patternSegments = parseRoutePattern(ct.routePattern);\n\n    // Check if path segments match the pattern\n    const match = matchPattern(segments, patternSegments);\n    if (match.matches) {\n      return {\n        isEntry: true,\n        contentType: ct.key,\n        slug: match.slug,\n      };\n    }\n  }\n\n  return { isEntry: false };\n}\n\n/**\n * Parse a route pattern into static segments before {slug}.\n *\n * @example\n * parseRoutePattern('/blog/{slug}') // ['blog']\n * parseRoutePattern('/work/projects/{slug}') // ['work', 'projects']\n * parseRoutePattern('/{slug}') // []\n */\nfunction parseRoutePattern(pattern: string): string[] {\n  const segments = pattern.split('/').filter(Boolean);\n  const staticSegments: string[] = [];\n\n  for (const segment of segments) {\n    if (segment.includes('{')) break; // Stop at dynamic segment\n    staticSegments.push(segment);\n  }\n\n  return staticSegments;\n}\n\n/**\n * Check if path segments match pattern segments.\n * Path must have at least one more segment than pattern (the slug).\n *\n * @returns Match result with extracted slug if matched\n */\nfunction matchPattern(\n  pathSegments: string[],\n  patternSegments: string[]\n): { matches: boolean; slug?: string } {\n  // Path needs: pattern segments + at least 1 slug segment\n  if (pathSegments.length < patternSegments.length + 1) {\n    return { matches: false };\n  }\n\n  // All pattern segments must match exactly\n  for (let i = 0; i < patternSegments.length; i++) {\n    if (pathSegments[i] !== patternSegments[i]) {\n      return { matches: false };\n    }\n  }\n\n  // Extract slug (everything after the pattern segments)\n  // For '/blog/{slug}' with path '/blog/my-post' → slug = 'my-post'\n  // For nested slugs, join remaining segments (rare but supported)\n  const slugSegments = pathSegments.slice(patternSegments.length);\n  const slug = slugSegments.join('/');\n\n  return { matches: true, slug };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/routing/checkRedirect.ts","../../src/routing/resolveRoute.ts","../../src/routing/contentRoutes.ts","../../src/routing/resolveOccurrence.ts"],"sourcesContent":["/**\n * Redirect checking for 404 handling\n *\n * Check if a path has a configured redirect rule before returning 404.\n */\n\nimport type { RiverbankClient } from '../client/types';\n\n/**\n * Redirect rule data\n */\nexport type RedirectRule = {\n  /**\n   * Destination URL to redirect to\n   */\n  destination: string;\n\n  /**\n   * Whether this is a permanent redirect (301/308) or temporary (302/307)\n   */\n  permanent: boolean;\n};\n\n/**\n * Result of redirect checking\n */\nexport type RedirectResult =\n  | {\n      hasRedirect: true;\n      redirect: RedirectRule;\n    }\n  | {\n      hasRedirect: false;\n      redirect: null;\n    };\n\n/**\n * Parameters for checking redirects\n */\nexport type CheckRedirectParams = {\n  /**\n   * SDK client instance\n   */\n  client: RiverbankClient;\n\n  /**\n   * Site ID\n   */\n  siteId: string;\n\n  /**\n   * URL path to check (e.g., '/old-page')\n   */\n  path: string;\n};\n\n/**\n * Check if a path has a configured redirect rule\n *\n * Use this when a page is not found to check if there's a redirect\n * configured for the path before returning a 404.\n *\n * @example\n * ```tsx\n * import { checkRedirectForPath } from '@riverbankcms/sdk/routing';\n * import { notFound, redirect } from 'next/navigation';\n *\n * export default async function Page({ params }) {\n *   const page = await getPage(params.path);\n *\n *   if (!page) {\n *     // Check for redirect before 404\n *     const result = await checkRedirectForPath({\n *       client,\n *       siteId: 'your-site-id',\n *       path: params.path,\n *     });\n *\n *     if (result.hasRedirect) {\n *       redirect(result.redirect.destination);\n *     }\n *\n *     notFound();\n *   }\n *\n *   return <PageContent page={page} />;\n * }\n * ```\n */\nexport async function checkRedirectForPath(\n  params: CheckRedirectParams\n): Promise<RedirectResult> {\n  const { client, siteId, path } = params;\n\n  try {\n    const response = await client.checkRedirect({\n      siteId,\n      path,\n    });\n\n    // API returns { redirectTo: string | null, status?: number }\n    if (response.redirectTo) {\n      // Status 301 and 308 are permanent, others are temporary\n      const isPermanent = response.status === 301 || response.status === 308;\n\n      return {\n        hasRedirect: true,\n        redirect: {\n          destination: response.redirectTo,\n          permanent: isPermanent,\n        },\n      };\n    }\n\n    return { hasRedirect: false, redirect: null };\n  } catch (error) {\n    console.warn('[checkRedirectForPath] Failed to check redirect', {\n      siteId,\n      path,\n      error: error instanceof Error ? error.message : String(error),\n    });\n\n    return { hasRedirect: false, redirect: null };\n  }\n}\n","/**\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';\nimport { checkRedirectForPath } from './checkRedirect';\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. If the page\n * is not found, it checks for configured redirects before returning 404.\n *\n * Returns a discriminated union indicating:\n * - `page`: Page was found, includes full page data\n * - `redirect`: Path has a redirect rule configured\n * - `not-found`: No page or redirect exists for this path\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 - check for redirect before returning 404\n  try {\n    const redirectResult = await checkRedirectForPath({\n      client,\n      siteId,\n      path,\n    });\n\n    if (redirectResult.hasRedirect) {\n      return {\n        type: 'redirect',\n        destination: redirectResult.redirect.destination,\n        permanent: redirectResult.redirect.permanent,\n      };\n    }\n  } catch (redirectError) {\n    console.debug('[resolveRoute] Redirect check failed', {\n      path,\n      error: redirectError instanceof Error ? redirectError.message : String(redirectError),\n    });\n  }\n\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","/**\n * Content route matching utilities.\n *\n * Derive route matching from SDK config to determine whether a URL path\n * is a CMS page or a content entry, without duplicating route patterns.\n */\n\nimport type { RiverbankSiteConfig, ContentTypeConfig } from '../config';\n\n/**\n * Extract the first path segment from each routable content type's routePattern.\n *\n * Useful for simple prefix-based routing decisions. For more precise matching\n * that handles nested patterns, use `isContentEntryPath` instead.\n *\n * @param config - The SDK config object from defineConfig()\n * @returns Array of first path segments from content type routePatterns\n *\n * @example\n * ```typescript\n * import { getContentEntryPrefixes } from '@riverbankcms/sdk/routing';\n * import config from '../riverbank.config';\n *\n * // Config with routePatterns: '/blog/{slug}', '/work/projects/{slug}'\n * const prefixes = getContentEntryPrefixes(config);\n * // Returns ['blog', 'work']\n * ```\n */\nexport function getContentEntryPrefixes(config: RiverbankSiteConfig): string[] {\n  const contentTypes = config.content?.contentTypes ?? [];\n\n  return contentTypes\n    .filter((ct): ct is ContentTypeConfig & { routePattern: string } =>\n      ct.hasPages && typeof ct.routePattern === 'string'\n    )\n    .map(ct => {\n      // '/blog/{slug}' → 'blog'\n      // '/work/projects/{slug}' → 'work'\n      // '/{slug}' → undefined (no static prefix)\n      const match = ct.routePattern.match(/^\\/([^/]+)/);\n      const segment = match?.[1];\n      // Skip dynamic segments (those containing {})\n      if (segment?.includes('{')) return undefined;\n      return segment;\n    })\n    .filter((prefix): prefix is string => typeof prefix === 'string');\n}\n\n/**\n * Result of checking if a path matches a content entry route.\n */\nexport type ContentEntryMatch = {\n  /** Whether the path matches a content entry route pattern */\n  isEntry: boolean;\n  /** The content type key if matched (e.g., 'blog-post') */\n  contentType?: string;\n  /** The slug extracted from the path if matched */\n  slug?: string;\n};\n\n/**\n * Check if a URL path matches any content entry route pattern.\n *\n * Supports nested patterns like '/work/projects/{slug}'. Returns the matched\n * content type key and extracted slug, useful for routing decisions.\n *\n * **Note:** Content types are checked in array order. If multiple patterns\n * could match a path, the first matching content type wins. Order more specific\n * patterns before generic ones in your config.\n *\n * @param config - The SDK config object from defineConfig()\n * @param path - URL path as string ('/blog/my-post') or segments ['blog', 'my-post']\n * @returns Match result with content type and slug if matched\n *\n * @example\n * ```typescript\n * import { isContentEntryPath } from '@riverbankcms/sdk/routing';\n * import config from '../riverbank.config';\n *\n * // Simple pattern: '/blog/{slug}'\n * isContentEntryPath(config, '/blog/my-post');\n * // Returns { isEntry: true, contentType: 'blog-post', slug: 'my-post' }\n *\n * // Nested pattern: '/work/projects/{slug}'\n * isContentEntryPath(config, '/work/projects/website-redesign');\n * // Returns { isEntry: true, contentType: 'project', slug: 'website-redesign' }\n *\n * // Non-matching path\n * isContentEntryPath(config, '/about');\n * // Returns { isEntry: false }\n * ```\n */\nexport function isContentEntryPath(\n  config: RiverbankSiteConfig,\n  path: string | string[]\n): ContentEntryMatch {\n  const segments = typeof path === 'string'\n    ? path.split('/').filter(Boolean)\n    : path;\n\n  const contentTypes = config.content?.contentTypes ?? [];\n\n  for (const ct of contentTypes) {\n    if (!ct.hasPages || !ct.routePattern) continue;\n\n    // Parse pattern: '/blog/{slug}' → ['blog'], '/work/projects/{slug}' → ['work', 'projects']\n    const patternSegments = parseRoutePattern(ct.routePattern);\n\n    // Check if path segments match the pattern\n    const match = matchPattern(segments, patternSegments);\n    if (match.matches) {\n      return {\n        isEntry: true,\n        contentType: ct.key,\n        slug: match.slug,\n      };\n    }\n  }\n\n  return { isEntry: false };\n}\n\n/**\n * Parse a route pattern into static segments before {slug}.\n *\n * @example\n * parseRoutePattern('/blog/{slug}') // ['blog']\n * parseRoutePattern('/work/projects/{slug}') // ['work', 'projects']\n * parseRoutePattern('/{slug}') // []\n */\nfunction parseRoutePattern(pattern: string): string[] {\n  const segments = pattern.split('/').filter(Boolean);\n  const staticSegments: string[] = [];\n\n  for (const segment of segments) {\n    if (segment.includes('{')) break; // Stop at dynamic segment\n    staticSegments.push(segment);\n  }\n\n  return staticSegments;\n}\n\n/**\n * Check if path segments match pattern segments.\n * Path must have at least one more segment than pattern (the slug).\n *\n * @returns Match result with extracted slug if matched\n */\nfunction matchPattern(\n  pathSegments: string[],\n  patternSegments: string[]\n): { matches: boolean; slug?: string } {\n  // Path needs: pattern segments + at least 1 slug segment\n  if (pathSegments.length < patternSegments.length + 1) {\n    return { matches: false };\n  }\n\n  // All pattern segments must match exactly\n  for (let i = 0; i < patternSegments.length; i++) {\n    if (pathSegments[i] !== patternSegments[i]) {\n      return { matches: false };\n    }\n  }\n\n  // Extract slug (everything after the pattern segments)\n  // For '/blog/{slug}' with path '/blog/my-post' → slug = 'my-post'\n  // For nested slugs, join remaining segments (rare but supported)\n  const slugSegments = pathSegments.slice(patternSegments.length);\n  const slug = slugSegments.join('/');\n\n  return { matches: true, slug };\n}\n","/**\n * Event occurrence resolution for dynamic URLs\n *\n * Resolves URL segments like \"2025-01-15\" or \"abc123-uuid\" to event occurrence data.\n */\n\nimport type { RiverbankClient, ResolveEventOccurrenceResponse } from '../client/types';\n\n/**\n * Data for a resolved event occurrence\n */\nexport type OccurrenceData = NonNullable<ResolveEventOccurrenceResponse['occurrence']>;\n\n/**\n * Result of occurrence resolution\n */\nexport type OccurrenceResolution =\n  | {\n      found: true;\n      occurrence: OccurrenceData;\n    }\n  | {\n      found: false;\n      occurrence: null;\n    };\n\n/**\n * Parameters for resolving an event occurrence\n */\nexport type ResolveOccurrenceParams = {\n  /**\n   * SDK client instance\n   */\n  client: RiverbankClient;\n\n  /**\n   * Site ID\n   */\n  siteId: string;\n\n  /**\n   * Parent content entry ID (the event entry)\n   */\n  entryId: string;\n\n  /**\n   * URL segment to resolve - either a date (YYYY-MM-DD) or UUID\n   */\n  segment: string;\n};\n\n/**\n * Check if a string is a valid ISO date (YYYY-MM-DD)\n */\nfunction isISODateString(str: string): boolean {\n  return /^\\d{4}-\\d{2}-\\d{2}$/.test(str);\n}\n\n/**\n * Check if a string is a valid UUID\n */\nfunction isUUID(str: string): boolean {\n  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(str);\n}\n\n/**\n * Validate URL segment format before making API call\n */\nfunction isValidSegment(segment: string): boolean {\n  return isISODateString(segment) || isUUID(segment);\n}\n\n/**\n * Resolve an event occurrence from a URL segment\n *\n * Supports two segment formats:\n * - Date format: \"2025-01-15\" → finds occurrence starting on that date\n * - UUID format: \"abc123...\" → finds occurrence by ID\n *\n * @example\n * ```tsx\n * import { resolveOccurrence } from '@riverbankcms/sdk/routing';\n *\n * // In a Next.js dynamic route: /events/[slug]/[occurrence]\n * export default async function EventOccurrencePage({ params }) {\n *   const result = await resolveOccurrence({\n *     client,\n *     siteId: 'your-site-id',\n *     entryId: eventEntry.id,\n *     segment: params.occurrence, // e.g., \"2025-01-15\"\n *   });\n *\n *   if (!result.found) {\n *     notFound();\n *   }\n *\n *   return <EventOccurrence occurrence={result.occurrence} />;\n * }\n * ```\n */\nexport async function resolveOccurrence(\n  params: ResolveOccurrenceParams\n): Promise<OccurrenceResolution> {\n  const { client, siteId, entryId, segment } = params;\n\n  // Validate segment format client-side to avoid unnecessary API calls\n  if (!isValidSegment(segment)) {\n    console.debug('[resolveOccurrence] Invalid segment format', { segment });\n    return { found: false, occurrence: null };\n  }\n\n  try {\n    const response = await client.resolveEventOccurrence({\n      siteId,\n      entryId,\n      segment,\n    });\n\n    if (response.occurrence) {\n      return {\n        found: true,\n        occurrence: response.occurrence,\n      };\n    }\n\n    return { found: false, occurrence: null };\n  } catch (error) {\n    console.warn('[resolveOccurrence] Failed to resolve occurrence', {\n      siteId,\n      entryId,\n      segment,\n      error: error instanceof Error ? error.message : String(error),\n    });\n\n    return { found: false, occurrence: null };\n  }\n}\n\nexport { isISODateString, isUUID, isValidSegment };\n"],"mappings":"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","names":[]}

package/dist/server/{schema-Bpy9N5ZI.d.ts → schema-Z6-afHJG.d.mts}

@@ -1867,4 +1867,4 @@ declare const pageOutlineSchema: z$1.ZodObject<{
 }, z$1.core.$strip>;
 type PageOutline = z$1.infer<typeof pageOutlineSchema>;
 
-export type { FieldDefinition as F, PageOutline as P, SdkCustomBlock as S };
+export type { BooleanFieldDefinition as B, ContentTypeSelectFieldDefinition as C, DateFieldDefinition as D, EntryPickerFieldDefinition as E, FieldDefinition as F, GroupFieldDefinition as G, LinkFieldDefinition as L, MediaFieldDefinition as M, NumberFieldDefinition as N, PageOutline as P, RichTextFieldDefinition as R, SdkCustomBlock as S, TextFieldDefinition as T, UrlFieldDefinition as U, TimeFieldDefinition as a, DateTimeFieldDefinition as b, SlugFieldDefinition as c, ReferenceFieldDefinition as d, PresetOrCustomFieldDefinition as e, SelectFieldDefinition as f, ModalFieldDefinition as g, RepeaterFieldDefinition as h, TabGroupFieldDefinition as i };

package/dist/server/{schema-Bpy9N5ZI.d.mts → schema-Z6-afHJG.d.ts}

@@ -1867,4 +1867,4 @@ declare const pageOutlineSchema: z$1.ZodObject<{
 }, z$1.core.$strip>;
 type PageOutline = z$1.infer<typeof pageOutlineSchema>;
 
-export type { FieldDefinition as F, PageOutline as P, SdkCustomBlock as S };
+export type { BooleanFieldDefinition as B, ContentTypeSelectFieldDefinition as C, DateFieldDefinition as D, EntryPickerFieldDefinition as E, FieldDefinition as F, GroupFieldDefinition as G, LinkFieldDefinition as L, MediaFieldDefinition as M, NumberFieldDefinition as N, PageOutline as P, RichTextFieldDefinition as R, SdkCustomBlock as S, TextFieldDefinition as T, UrlFieldDefinition as U, TimeFieldDefinition as a, DateTimeFieldDefinition as b, SlugFieldDefinition as c, ReferenceFieldDefinition as d, PresetOrCustomFieldDefinition as e, SelectFieldDefinition as f, ModalFieldDefinition as g, RepeaterFieldDefinition as h, TabGroupFieldDefinition as i };

package/dist/server/server.d.mts

@@ -1,14 +1,16 @@
-export { c as createRiverbankClient } from './index-DFQwtj3J.mjs';
-export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-DkKEctWn.mjs';
-export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-B8RmlYgV.mjs';
-export { C as ContentEntryData, E as EntryContentResult, L as LoadContentParams, b as LoadContentResult, P as PageContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-CWuE8FCx.mjs';
-import './types-CdrJqlKx.mjs';
-import '@riverbankcms/ai';
-import './schema-Bpy9N5ZI.mjs';
+export { c as createRiverbankClient } from './index-Q7RLMAQ6.mjs';
+export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-0f4PIlgx.mjs';
+export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-DGnIK7s4.mjs';
+export { C as ContentEntryData, E as EntryContentResult, L as LoadContentParams, b as LoadContentResult, P as PageContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-DgpSKWqY.mjs';
+import './schema-Z6-afHJG.mjs';
 import 'zod';
+import './types-DuzJZKJI.mjs';
+import '@riverbankcms/ai';
+import './link-DjxLyC82.mjs';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
 import 'react/jsx-runtime';
 import 'react';
+import './core-DsNWrl3o.mjs';
 import './types-CbagRQ_7.mjs';
 import './blockKinds-B6MWzNWp.mjs';

package/dist/server/server.d.ts

@@ -1,14 +1,16 @@
-export { c as createRiverbankClient } from './index-DCIz9Ptv.js';
-export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-oCM-fw4O.js';
-export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-BTkKpizX.js';
-export { C as ContentEntryData, E as EntryContentResult, L as LoadContentParams, b as LoadContentResult, P as PageContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-DynBuR5f.js';
-import './types-BiRZnxDx.js';
-import '@riverbankcms/ai';
-import './schema-Bpy9N5ZI.js';
+export { c as createRiverbankClient } from './index-CJfMXZQr.js';
+export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-kOQyCFXO.js';
+export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-DW9WB-u9.js';
+export { C as ContentEntryData, E as EntryContentResult, L as LoadContentParams, b as LoadContentResult, P as PageContentResult, a as isEntryContent, i as isPageContent, l as loadContent } from './loadContent-GPvUI1bN.js';
+import './schema-Z6-afHJG.js';
 import 'zod';
+import './types-C28kMfa1.js';
+import '@riverbankcms/ai';
+import './link-DjxLyC82.js';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
 import 'react/jsx-runtime';
 import 'react';
+import './core-DsNWrl3o.js';
 import './types-DuQCNVV0.js';
 import './blockKinds-B6MWzNWp.js';

package/dist/server/server.js

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkR5B6IOFQjs = require('./chunk-R5B6IOFQ.js');
+var _chunk6OSNCH4Fjs = require('./chunk-6OSNCH4F.js');
 
 
 
 
-var _chunkTO7FD6TQjs = require('./chunk-TO7FD6TQ.js');
+var _chunkI2D7KOEAjs = require('./chunk-I2D7KOEA.js');
 
 
-var _chunkSWPHIUVEjs = require('./chunk-SWPHIUVE.js');
+var _chunkP3NNN73Gjs = require('./chunk-P3NNN73G.js');
 require('./chunk-Y7347JMZ.js');
-require('./chunk-HOY77YBF.js');
-require('./chunk-EGTDJ4PL.js');
+require('./chunk-RVDS7VSP.js');
+require('./chunk-YYO3RIFO.js');
 require('./chunk-DGUM43GV.js');
 
 
@@ -19,5 +19,5 @@ require('./chunk-DGUM43GV.js');
 
 
 
-exports.createRiverbankClient = _chunkR5B6IOFQjs.createRiverbankClient; exports.isEntryContent = _chunkTO7FD6TQjs.isEntryContent; exports.isPageContent = _chunkTO7FD6TQjs.isPageContent; exports.loadContent = _chunkTO7FD6TQjs.loadContent; exports.loadPage = _chunkSWPHIUVEjs.loadPage;
+exports.createRiverbankClient = _chunk6OSNCH4Fjs.createRiverbankClient; exports.isEntryContent = _chunkI2D7KOEAjs.isEntryContent; exports.isPageContent = _chunkI2D7KOEAjs.isPageContent; exports.loadContent = _chunkI2D7KOEAjs.loadContent; exports.loadPage = _chunkP3NNN73Gjs.loadPage;
 //# sourceMappingURL=server.js.map

package/dist/server/server.mjs

@@ -1,17 +1,17 @@
 import {
   createRiverbankClient
-} from "./chunk-N3PX76AP.mjs";
+} from "./chunk-4HIRA33Z.mjs";
 import {
   isEntryContent,
   isPageContent,
   loadContent
-} from "./chunk-OP2GHK27.mjs";
+} from "./chunk-Z5ZA6Q4D.mjs";
 import {
   loadPage
-} from "./chunk-ZEAJW6T3.mjs";
+} from "./chunk-C6FIJC7T.mjs";
 import "./chunk-A2FZMRDW.mjs";
-import "./chunk-7DS4Q3GA.mjs";
-import "./chunk-USQF2XTU.mjs";
+import "./chunk-AEFWG657.mjs";
+import "./chunk-BYBJA6SP.mjs";
 import "./chunk-BJTO5JO5.mjs";
 export {
   createRiverbankClient,

package/dist/server/theme-bridge.js

@@ -5,8 +5,8 @@
 
 
 
-var _chunkTKMA6D6Ujs = require('./chunk-TKMA6D6U.js');
-require('./chunk-EGTDJ4PL.js');
+var _chunk7UPVCT3Kjs = require('./chunk-7UPVCT3K.js');
+require('./chunk-YYO3RIFO.js');
 require('./chunk-DGUM43GV.js');
 
 // src/theme-bridge/ThemeBridgeProvider.tsx
@@ -147,7 +147,7 @@ ${cssLines}
 }
 function generateButtonsCss(config, corners, shadows) {
   const buttonConfig = _optionalChain([config, 'access', _7 => _7.components, 'optionalAccess', _8 => _8.buttons]);
-  let variants = _chunkTKMA6D6Ujs.getDefaultButtonVariants.call(void 0, );
+  let variants = _chunk7UPVCT3Kjs.getDefaultButtonVariants.call(void 0, );
   if (typeof buttonConfig === "object" && buttonConfig.variants) {
     const requestedIds = new Set(buttonConfig.variants);
     variants = variants.filter((v) => requestedIds.has(v.id));
@@ -159,11 +159,11 @@ function generateButtonsCss(config, corners, shadows) {
     fontWeight: 500,
     textTransform: "none"
   };
-  return _chunkTKMA6D6Ujs.generateButtonCoreCss.call(void 0, SCOPE_ID, variants, settings);
+  return _chunk7UPVCT3Kjs.generateButtonCoreCss.call(void 0, SCOPE_ID, variants, settings);
 }
 function generateCardsCss(config, corners, shadows) {
   const cardConfig = _optionalChain([config, 'access', _9 => _9.components, 'optionalAccess', _10 => _10.cards]);
-  let variants = _chunkTKMA6D6Ujs.getDefaultCardVariants.call(void 0, );
+  let variants = _chunk7UPVCT3Kjs.getDefaultCardVariants.call(void 0, );
   if (typeof cardConfig === "object" && cardConfig.variants) {
     const requestedIds = new Set(cardConfig.variants);
     variants = variants.filter((v) => requestedIds.has(v.id));
@@ -173,13 +173,13 @@ function generateCardsCss(config, corners, shadows) {
     shadow: shadows,
     borderWidth: "thin"
   };
-  return _chunkTKMA6D6Ujs.generateCardCoreCss.call(void 0, SCOPE_ID, variants, settings);
+  return _chunk7UPVCT3Kjs.generateCardCoreCss.call(void 0, SCOPE_ID, variants, settings);
 }
 function generateInputsCss(config, corners, shadows) {
-  const settings = _chunkTKMA6D6Ujs.getDefaultInputSettings.call(void 0, );
+  const settings = _chunk7UPVCT3Kjs.getDefaultInputSettings.call(void 0, );
   settings.corners = corners;
   settings.shadow = shadows === "none" ? "none" : "low";
-  return _chunkTKMA6D6Ujs.generateInputCoreCss.call(void 0, SCOPE_ID, settings);
+  return _chunk7UPVCT3Kjs.generateInputCoreCss.call(void 0, SCOPE_ID, settings);
 }
 function generateOverrideCss(overrides) {
   const chunks = [];

package/dist/server/theme-bridge.mjs

@@ -5,8 +5,8 @@ import {
   getDefaultButtonVariants,
   getDefaultCardVariants,
   getDefaultInputSettings
-} from "./chunk-TNRADRPH.mjs";
-import "./chunk-USQF2XTU.mjs";
+} from "./chunk-LNOUXALA.mjs";
+import "./chunk-BYBJA6SP.mjs";
 import "./chunk-BJTO5JO5.mjs";
 
 // src/theme-bridge/ThemeBridgeProvider.tsx

package/dist/server/{types-oCM-fw4O.d.ts → types-0f4PIlgx.d.mts}

@@ -1,4 +1,5 @@
-import { A as APIEndpoints } from './types-BiRZnxDx.js';
+import { A as APIEndpoints } from './types-DuzJZKJI.mjs';
+import './schema-Z6-afHJG.mjs';
 
 type SiteResponse = NonNullable<APIEndpoints['getSite']['response']>;
 type PageResponse = NonNullable<APIEndpoints['getContentByPath']['response']>;
@@ -7,6 +8,8 @@ type EntryResponse = NonNullable<APIEndpoints['getPublishedEntryPreview']['respo
 type PublicFormResponse = NonNullable<APIEndpoints['getPublicFormById']['response']>;
 type PublicBookingServicesResponse = NonNullable<APIEndpoints['getPublicBookingServices']['response']>;
 type PublicEventsResponse = NonNullable<APIEndpoints['listPublicEvents']['response']>;
+type ResolveEventOccurrenceResponse = NonNullable<APIEndpoints['resolveEventOccurrence']['response']>;
+type CheckRedirectResponse = NonNullable<APIEndpoints['checkRedirect']['response']>;
 /**
  * Pagination metadata returned when `includeMeta: true`
  */
@@ -189,10 +192,60 @@ interface RiverbankClient {
         to?: string;
         stage?: string;
     }): Promise<PublicEventsResponse>;
+    /**
+     * Resolve an event occurrence by URL segment (date or UUID)
+     *
+     * @param params.siteId - The site ID
+     * @param params.entryId - The parent content entry ID
+     * @param params.segment - URL segment - either a date (YYYY-MM-DD) or UUID
+     *
+     * @example
+     * ```ts
+     * // Resolve occurrence by date
+     * const result = await client.resolveEventOccurrence({
+     *   siteId: 'site-id',
+     *   entryId: 'entry-id',
+     *   segment: '2025-01-15',
+     * });
+     *
+     * // Resolve occurrence by UUID
+     * const result = await client.resolveEventOccurrence({
+     *   siteId: 'site-id',
+     *   entryId: 'entry-id',
+     *   segment: 'abc123-...',
+     * });
+     * ```
+     */
+    resolveEventOccurrence(params: {
+        siteId: string;
+        entryId: string;
+        segment: string;
+    }): Promise<ResolveEventOccurrenceResponse>;
+    /**
+     * Check if a path has a configured redirect rule
+     *
+     * @param params.siteId - The site ID
+     * @param params.path - The URL path to check
+     *
+     * @example
+     * ```ts
+     * const redirect = await client.checkRedirect({
+     *   siteId: 'site-id',
+     *   path: '/old-page',
+     * });
+     * if (redirect.redirect) {
+     *   // Handle redirect to redirect.redirect.destination
+     * }
+     * ```
+     */
+    checkRedirect(params: {
+        siteId: string;
+        path: string;
+    }): Promise<CheckRedirectResponse>;
     /**
      * Force clear the cache
      */
     clearCache(): void;
 }
 
-export type { EntriesResponse as E, PageResponse as P, RiverbankClient as R, SiteResponse as S, RiverbankClientConfig as a, EntryResponse as b, EntriesResponseWithMeta as c, PaginationMeta as d };
+export type { EntriesResponse as E, PageResponse as P, RiverbankClient as R, SiteResponse as S, RiverbankClientConfig as a, EntryResponse as b, EntriesResponseWithMeta as c, PaginationMeta as d, ResolveEventOccurrenceResponse as e };

package/dist/server/{types-txWsSxN7.d.mts → types-BjgZt8xJ.d.mts}

@@ -1,4 +1,4 @@
-import { F as FieldDefinition, S as SdkCustomBlock } from './schema-Bpy9N5ZI.mjs';
+import { F as FieldDefinition, S as SdkCustomBlock } from './schema-Z6-afHJG.mjs';
 import { B as BlockKind } from './blockKinds-B6MWzNWp.mjs';
 
 /**
@@ -482,6 +482,27 @@ interface BlockFieldExtension {
  * ```
  */
 type BlockFieldExtensionsMap = Record<string, BlockFieldExtension>;
+/**
+ * Sync behavior configuration for CLI push operations.
+ *
+ * Controls how the SDK CLI handles content synchronization.
+ */
+interface SyncConfig {
+    /**
+     * How to handle existing entries during push.
+     * - 'skip': Only create new entries, never update existing
+     * - 'update': Create new entries and update existing ones
+     * @default 'skip'
+     */
+    existingEntries?: 'skip' | 'update';
+    /**
+     * Target for content updates.
+     * - 'draft': Updates save as draft (unpublished changes)
+     * - 'publish': Updates are published immediately
+     * @default 'draft'
+     */
+    contentTarget?: 'draft' | 'publish';
+}
 /**
  * Top-level SDK site configuration.
  *
@@ -530,6 +551,20 @@ type BlockFieldExtensionsMap = Record<string, BlockFieldExtension>;
 interface RiverbankSiteConfig {
     /** Site UUID from the dashboard - identifies which site this config belongs to */
     siteId: string;
+    /**
+     * Preview URL for this SDK site.
+     * Used by dashboard preview buttons to open the site's preview/staging environment.
+     * If not provided, preview buttons will be hidden for SDK sites.
+     * @example 'https://staging.mysite.com'
+     */
+    previewUrl?: string;
+    /**
+     * Live/production URL for this SDK site.
+     * Used by "View live site" links in the dashboard.
+     * If not provided, live site links will be hidden for SDK sites.
+     * @example 'https://mysite.com'
+     */
+    liveUrl?: string;
     /** SDK-defined theme with color palette for token resolution */
     theme?: SdkThemeConfig;
     /** Style configuration for curating editor options */
@@ -612,6 +647,32 @@ interface RiverbankSiteConfig {
      * ```
      */
     content?: ContentConfig;
+    /**
+     * Content directory path for CLI operations.
+     *
+     * When using `riverbankcms push` or `riverbankcms pull`, content is
+     * read from or written to this directory. JSON files in this directory
+     * are the source of truth for content.
+     *
+     * @default './content'
+     * @example './src/content'
+     */
+    contentDir?: string;
+    /**
+     * Sync behavior configuration for CLI push operations.
+     *
+     * Controls how the SDK CLI handles content synchronization when
+     * pushing content from local files to the CMS.
+     *
+     * @example
+     * ```typescript
+     * sync: {
+     *   existingEntries: 'update',  // Update existing entries
+     *   contentTarget: 'draft',     // Keep updates as drafts
+     * }
+     * ```
+     */
+    sync?: SyncConfig;
 }
 
-export type { BlockFieldConfig as B, ContentConfig as C, EntryConfig as E, FieldSelectOption as F, NavigationMenuConfig as N, PageConfig as P, RiverbankSiteConfig as R, SiteStyleConfig as S, SectionBackground as a, SectionOptionsConfig as b, ContainerOptionsConfig as c, SectionSpacing as d, ContainerMaxWidth as e, ContainerAlignment as f, SdkThemeConfig as g, SdkThemePalette as h, BlockFieldOptionsMap as i, BlockFieldExtension as j, BlockFieldExtensionsMap as k, ContentTypeConfig as l, BlockConfig as m, NavigationItemConfig as n, NavigationLinkType as o, SiteSettingsConfig as p };
+export type { BlockFieldConfig as B, ContentTypeConfig as C, EntryConfig as E, FieldSelectOption as F, NavigationMenuConfig as N, PageConfig as P, RiverbankSiteConfig as R, SiteStyleConfig as S, ContentConfig as a, SectionBackground as b, SectionOptionsConfig as c, ContainerOptionsConfig as d, SectionSpacing as e, ContainerMaxWidth as f, ContainerAlignment as g, SdkThemeConfig as h, SdkThemePalette as i, BlockFieldOptionsMap as j, BlockFieldExtension as k, BlockFieldExtensionsMap as l, BlockConfig as m, NavigationItemConfig as n, NavigationLinkType as o, SiteSettingsConfig as p, SyncConfig as q };