@riverbankcms/sdk 0.4.1 → 0.4.3

package/dist/server/routing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/routing.js","../../src/routing/resolveRoute.ts"],"names":[],"mappings":"AAAA,0XAA4B;AAC5B;AACA;ACgFA,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;AD/HA;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"]}
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/routing.js","../../src/routing/resolveRoute.ts","../../src/routing/contentRoutes.ts"],"names":[],"mappings":"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","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","/**\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"]}

package/dist/server/routing.mjs

@@ -10,7 +10,7 @@ async function resolveRoute(params) {
       preview
     });
     if (pageResponse) {
-      const { loadPage } = await import("./loadPage-LYVKY3WZ.mjs");
+      const { loadPage } = await import("./loadPage-GEGN4UAL.mjs");
       const pageData = await loadPage({
         client,
         siteId,
@@ -52,7 +52,61 @@ async function resolveRoutes(params) {
   );
   return resolutions;
 }
+
+// src/routing/contentRoutes.ts
+function getContentEntryPrefixes(config) {
+  const contentTypes = config.content?.contentTypes ?? [];
+  return contentTypes.filter(
+    (ct) => ct.hasPages && typeof ct.routePattern === "string"
+  ).map((ct) => {
+    const match = ct.routePattern.match(/^\/([^/]+)/);
+    const segment = match?.[1];
+    if (segment?.includes("{")) 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 = config.content?.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 };
+}
 export {
+  getContentEntryPrefixes,
+  isContentEntryPath,
   resolveRoute,
   resolveRoutes
 };

package/dist/server/routing.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/routing/resolveRoute.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"],"mappings":";;;AAkFA,eAAsB,aACpB,QAC0B;AAC1B,QAAM,EAAE,QAAQ,QAAQ,MAAM,UAAU,MAAM,IAAI;AAElD,MAAI;AAEF,UAAM,eAAe,MAAM,OAAO,QAAQ;AAAA,MACxC;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,cAAc;AAEhB,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,yBAA+B;AACjE,YAAM,WAAW,MAAM,SAAS;AAAA,QAC9B;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,aAAO;AAAA,QACL,MAAM;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AAEd,UAAM,QAAQ,iBAAiB,UAC5B,MAAM,QAAQ,SAAS,KAAK,KAC5B,MAAM,QAAQ,SAAS,WAAW,KAClC,MAAM,QAAQ,SAAS,WAAW;AAErC,QAAI,OAAO;AACT,cAAQ,MAAM,iCAAiC,EAAE,KAAK,CAAC;AAAA,IACzD,OAAO;AAEL,cAAQ,KAAK,uCAAuC;AAAA,QAClD;AAAA,QACA,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D,CAAC;AAAA,IACH;AAAA,EACF;AAIA,SAAO;AAAA,IACL,MAAM;AAAA,EACR;AACF;AA0BA,eAAsB,cAAc,QAK8B;AAChE,QAAM,EAAE,QAAQ,QAAQ,OAAO,QAAQ,IAAI;AAE3C,QAAM,cAAc,MAAM,QAAQ;AAAA,IAChC,MAAM,IAAI,OAAO,SAAS;AACxB,YAAM,aAAa,MAAM,aAAa;AAAA,QACpC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,aAAO,EAAE,MAAM,WAAW;AAAA,IAC5B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}
+{"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":[]}

package/dist/server/server.d.mts

@@ -1,8 +1,8 @@
-export { c as createRiverbankClient } from './index-Dj7VKH34.mjs';
-export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-BC9eB2KH.mjs';
-export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-mavT3Jae.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-C_FipaAC.mjs';
-import './types-BA-J9K8r.mjs';
+export { c as createRiverbankClient } from './index-C6o9LPvq.mjs';
+export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-CdhKJrB0.mjs';
+export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-p3AWwwrd.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-CdXfuCuE.mjs';
+import './types-BLf-hE50.mjs';
 import '@riverbankcms/ai';
 import './schema-Bpy9N5ZI.mjs';
 import 'zod';

package/dist/server/server.d.ts

@@ -1,8 +1,8 @@
-export { c as createRiverbankClient } from './index-DbSfrRA0.js';
-export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-CAnC529E.js';
-export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-naVvoua8.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-C2SwqmXy.js';
-import './types-5XdVD2J1.js';
+export { c as createRiverbankClient } from './index-CAwBj3-A.js';
+export { E as EntriesResponse, b as EntryResponse, P as PageResponse, R as RiverbankClient, a as RiverbankClientConfig, S as SiteResponse } from './types-Dj8B3QRb.js';
+export { L as LoadPageParams, a as LoadPageResult, R as RuntimeSdkConfig, l as loadPage } from './loadPage-BA0HiT-6.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-CsvQRoxb.js';
+import './types-BWQ-TohG.js';
 import '@riverbankcms/ai';
 import './schema-Bpy9N5ZI.js';
 import 'zod';

package/dist/server/server.js

@@ -8,7 +8,7 @@ var _chunkR5B6IOFQjs = require('./chunk-R5B6IOFQ.js');
 var _chunkTO7FD6TQjs = require('./chunk-TO7FD6TQ.js');
 
 
-var _chunkSWPHIUVEjs = require('./chunk-SWPHIUVE.js');
+var _chunkG35R7N7Bjs = require('./chunk-G35R7N7B.js');
 require('./chunk-Y7347JMZ.js');
 require('./chunk-HOY77YBF.js');
 require('./chunk-EGTDJ4PL.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 = _chunkR5B6IOFQjs.createRiverbankClient; exports.isEntryContent = _chunkTO7FD6TQjs.isEntryContent; exports.isPageContent = _chunkTO7FD6TQjs.isPageContent; exports.loadContent = _chunkTO7FD6TQjs.loadContent; exports.loadPage = _chunkG35R7N7Bjs.loadPage;
 //# sourceMappingURL=server.js.map

package/dist/server/server.mjs

@@ -8,7 +8,7 @@ import {
 } from "./chunk-OP2GHK27.mjs";
 import {
   loadPage
-} from "./chunk-ZEAJW6T3.mjs";
+} from "./chunk-ES6QDZUX.mjs";
 import "./chunk-A2FZMRDW.mjs";
 import "./chunk-7DS4Q3GA.mjs";
 import "./chunk-USQF2XTU.mjs";

package/dist/server/theme-bridge.js

@@ -5,7 +5,7 @@
 
 
 
-var _chunkIT5ICP43js = require('./chunk-IT5ICP43.js');
+var _chunkVHDDXCK6js = require('./chunk-VHDDXCK6.js');
 require('./chunk-EGTDJ4PL.js');
 require('./chunk-DGUM43GV.js');
 
@@ -147,7 +147,7 @@ ${cssLines}
 }
 function generateButtonsCss(config, corners, shadows) {
   const buttonConfig = _optionalChain([config, 'access', _7 => _7.components, 'optionalAccess', _8 => _8.buttons]);
-  let variants = _chunkIT5ICP43js.getDefaultButtonVariants.call(void 0, );
+  let variants = _chunkVHDDXCK6js.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 _chunkIT5ICP43js.generateButtonCoreCss.call(void 0, SCOPE_ID, variants, settings);
+  return _chunkVHDDXCK6js.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 = _chunkIT5ICP43js.getDefaultCardVariants.call(void 0, );
+  let variants = _chunkVHDDXCK6js.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 _chunkIT5ICP43js.generateCardCoreCss.call(void 0, SCOPE_ID, variants, settings);
+  return _chunkVHDDXCK6js.generateCardCoreCss.call(void 0, SCOPE_ID, variants, settings);
 }
 function generateInputsCss(config, corners, shadows) {
-  const settings = _chunkIT5ICP43js.getDefaultInputSettings.call(void 0, );
+  const settings = _chunkVHDDXCK6js.getDefaultInputSettings.call(void 0, );
   settings.corners = corners;
   settings.shadow = shadows === "none" ? "none" : "low";
-  return _chunkIT5ICP43js.generateInputCoreCss.call(void 0, SCOPE_ID, settings);
+  return _chunkVHDDXCK6js.generateInputCoreCss.call(void 0, SCOPE_ID, settings);
 }
 function generateOverrideCss(overrides) {
   const chunks = [];

package/dist/server/theme-bridge.mjs

@@ -5,7 +5,7 @@ import {
   getDefaultButtonVariants,
   getDefaultCardVariants,
   getDefaultInputSettings
-} from "./chunk-NKXS4TBK.mjs";
+} from "./chunk-U2NI3TS3.mjs";
 import "./chunk-USQF2XTU.mjs";
 import "./chunk-BJTO5JO5.mjs";
 

package/dist/server/{types-BA-J9K8r.d.mts → types-BLf-hE50.d.mts}

@@ -2293,6 +2293,8 @@ type SiteBySlugResponse = {
     layout: SiteLayoutResolvedPayload;
     customDomain: string | null;
     sdkConfig?: RiverbankSiteConfig | null;
+    /** Supabase storage URL for direct image access (SDK sites use this instead of env var) */
+    supabaseUrl?: string;
 };
 type BlockWithContentResponse = {
     id: string;
@@ -2320,15 +2322,20 @@ type DevToolsSeedResponse = {
         blocksCreated: number;
     };
 };
+type SiteInvitee = {
+    email: string;
+    role: 'editor' | 'administrator';
+};
 type CreateManualSiteRequest = {
     title: string;
+    deploymentMode?: 'managed' | 'headless_full';
     description?: string | null;
-    themeKey: string;
-    contentTypes: Array<'page' | 'post' | 'event' | 'testimonial'>;
-    scaffoldHome: boolean;
-    scaffoldContact: boolean;
-    scaffoldBlog: boolean;
-    invitees?: string[];
+    themeKey?: string;
+    contentTypes?: Array<'page' | 'post' | 'event' | 'testimonial'>;
+    scaffoldHome?: boolean;
+    scaffoldContact?: boolean;
+    scaffoldBlog?: boolean;
+    invitees?: SiteInvitee[];
 };
 type CreateManualSiteResponse = {
     siteId: string;
@@ -2346,6 +2353,10 @@ type CreateManualSiteResponse = {
         }>;
         contentTypes: Array<'page' | 'post' | 'event' | 'testimonial'>;
     };
+    invitations?: {
+        sent: number;
+        failed: number;
+    };
 };
 type APIEndpoints = {
     aiContentUpdateChat: APIEndpoint<{
@@ -3921,6 +3932,7 @@ type ContentTypeSummary = {
     hasPages: boolean;
     routePattern: string | null;
     isBuiltin: boolean;
+    isSingleton: boolean;
     createdAt: string;
     updatedAt: string;
 };
@@ -3934,6 +3946,7 @@ type CreateContentTypeRequest = {
     description?: string | null;
     schema: Record<string, unknown>;
     titleField?: string | null;
+    isSingleton?: boolean;
 };
 type UpdateContentTypeRequest = {
     name?: string;

package/dist/server/{types-5XdVD2J1.d.ts → types-BWQ-TohG.d.ts}

@@ -2293,6 +2293,8 @@ type SiteBySlugResponse = {
     layout: SiteLayoutResolvedPayload;
     customDomain: string | null;
     sdkConfig?: RiverbankSiteConfig | null;
+    /** Supabase storage URL for direct image access (SDK sites use this instead of env var) */
+    supabaseUrl?: string;
 };
 type BlockWithContentResponse = {
     id: string;
@@ -2320,15 +2322,20 @@ type DevToolsSeedResponse = {
         blocksCreated: number;
     };
 };
+type SiteInvitee = {
+    email: string;
+    role: 'editor' | 'administrator';
+};
 type CreateManualSiteRequest = {
     title: string;
+    deploymentMode?: 'managed' | 'headless_full';
     description?: string | null;
-    themeKey: string;
-    contentTypes: Array<'page' | 'post' | 'event' | 'testimonial'>;
-    scaffoldHome: boolean;
-    scaffoldContact: boolean;
-    scaffoldBlog: boolean;
-    invitees?: string[];
+    themeKey?: string;
+    contentTypes?: Array<'page' | 'post' | 'event' | 'testimonial'>;
+    scaffoldHome?: boolean;
+    scaffoldContact?: boolean;
+    scaffoldBlog?: boolean;
+    invitees?: SiteInvitee[];
 };
 type CreateManualSiteResponse = {
     siteId: string;
@@ -2346,6 +2353,10 @@ type CreateManualSiteResponse = {
         }>;
         contentTypes: Array<'page' | 'post' | 'event' | 'testimonial'>;
     };
+    invitations?: {
+        sent: number;
+        failed: number;
+    };
 };
 type APIEndpoints = {
     aiContentUpdateChat: APIEndpoint<{
@@ -3921,6 +3932,7 @@ type ContentTypeSummary = {
     hasPages: boolean;
     routePattern: string | null;
     isBuiltin: boolean;
+    isSingleton: boolean;
     createdAt: string;
     updatedAt: string;
 };
@@ -3934,6 +3946,7 @@ type CreateContentTypeRequest = {
     description?: string | null;
     schema: Record<string, unknown>;
     titleField?: string | null;
+    isSingleton?: boolean;
 };
 type UpdateContentTypeRequest = {
     name?: string;

package/dist/server/{types-CMqVHYLG.d.ts → types-CL916r6x.d.ts}

@@ -16,6 +16,7 @@ import { B as BlockKind } from './blockKinds-B6MWzNWp.js';
  *
  * @example
  * ```typescript
+ * // Regular content type with multiple entries
  * {
  *   key: 'testimonial',
  *   name: 'Testimonial',
@@ -25,6 +26,17 @@ import { B as BlockKind } from './blockKinds-B6MWzNWp.js';
  *     { id: 'author', type: 'text', label: 'Author', required: true },
  *   ],
  * }
+ *
+ * // Singleton content type (only one entry allowed)
+ * {
+ *   key: 'site-settings',
+ *   name: 'Site Settings',
+ *   isSingleton: true,
+ *   hasPages: false,
+ *   fields: [
+ *     { id: 'contactEmail', type: 'text', label: 'Contact Email' },
+ *   ],
+ * }
  * ```
  */
 interface ContentTypeConfig {
@@ -36,12 +48,22 @@ interface ContentTypeConfig {
     description?: string;
     /** Whether entries of this type have routable pages */
     hasPages: boolean;
-    /** Route pattern with {slug} placeholder. Required if hasPages=true. */
+    /**
+     * Route pattern for routable content types. Required if hasPages=true.
+     * - For regular types: must include {slug} placeholder (e.g., '/blog/{slug}')
+     * - For singletons: can be a fixed path without {slug} (e.g., '/')
+     */
     routePattern?: string;
     /** Field definitions for this content type */
     fields: FieldDefinition[];
     /** Field ID to use as the entry title source */
     titleField?: string;
+    /**
+     * When true, only one entry can exist for this content type.
+     * The entry is auto-created when the content type is created.
+     * Use for homepage content, site-wide settings, etc.
+     */
+    isSingleton?: boolean;
 }
 /**
  * Block content for page scaffolding.

package/dist/server/{types-BC9eB2KH.d.mts → types-CdhKJrB0.d.mts}

@@ -1,4 +1,4 @@
-import { A as APIEndpoints } from './types-BA-J9K8r.mjs';
+import { A as APIEndpoints } from './types-BLf-hE50.mjs';
 
 type SiteResponse = NonNullable<APIEndpoints['getSite']['response']>;
 type PageResponse = NonNullable<APIEndpoints['getContentByPath']['response']>;

package/dist/server/{types-CAnC529E.d.ts → types-Dj8B3QRb.d.ts}

@@ -1,4 +1,4 @@
-import { A as APIEndpoints } from './types-5XdVD2J1.js';
+import { A as APIEndpoints } from './types-BWQ-TohG.js';
 
 type SiteResponse = NonNullable<APIEndpoints['getSite']['response']>;
 type PageResponse = NonNullable<APIEndpoints['getContentByPath']['response']>;

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

@@ -16,6 +16,7 @@ import { B as BlockKind } from './blockKinds-B6MWzNWp.mjs';
  *
  * @example
  * ```typescript
+ * // Regular content type with multiple entries
  * {
  *   key: 'testimonial',
  *   name: 'Testimonial',
@@ -25,6 +26,17 @@ import { B as BlockKind } from './blockKinds-B6MWzNWp.mjs';
  *     { id: 'author', type: 'text', label: 'Author', required: true },
  *   ],
  * }
+ *
+ * // Singleton content type (only one entry allowed)
+ * {
+ *   key: 'site-settings',
+ *   name: 'Site Settings',
+ *   isSingleton: true,
+ *   hasPages: false,
+ *   fields: [
+ *     { id: 'contactEmail', type: 'text', label: 'Contact Email' },
+ *   ],
+ * }
  * ```
  */
 interface ContentTypeConfig {
@@ -36,12 +48,22 @@ interface ContentTypeConfig {
     description?: string;
     /** Whether entries of this type have routable pages */
     hasPages: boolean;
-    /** Route pattern with {slug} placeholder. Required if hasPages=true. */
+    /**
+     * Route pattern for routable content types. Required if hasPages=true.
+     * - For regular types: must include {slug} placeholder (e.g., '/blog/{slug}')
+     * - For singletons: can be a fixed path without {slug} (e.g., '/')
+     */
     routePattern?: string;
     /** Field definitions for this content type */
     fields: FieldDefinition[];
     /** Field ID to use as the entry title source */
     titleField?: string;
+    /**
+     * When true, only one entry can exist for this content type.
+     * The entry is auto-created when the content type is created.
+     * Use for homepage content, site-wide settings, etc.
+     */
+    isSingleton?: boolean;
 }
 /**
  * Block content for page scaffolding.

package/dist/server/{validation-C7W2Fe0i.d.ts → validation-CoU8uAiu.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { S as SdkCustomBlock } from './schema-Bpy9N5ZI.js';
-import { C as ContentConfig, l as ContentTypeConfig, R as RiverbankSiteConfig, i as BlockFieldOptionsMap, j as BlockFieldExtension, k as BlockFieldExtensionsMap } from './types-CMqVHYLG.js';
+import { C as ContentConfig, l as ContentTypeConfig, R as RiverbankSiteConfig, i as BlockFieldOptionsMap, j as BlockFieldExtension, k as BlockFieldExtensionsMap } from './types-CL916r6x.js';
 
 /**
  * SDK Content Config Validation

package/dist/server/{validation-hg1sqhrt.d.mts → validation-DzvDwwRo.d.mts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { S as SdkCustomBlock } from './schema-Bpy9N5ZI.mjs';
-import { C as ContentConfig, l as ContentTypeConfig, R as RiverbankSiteConfig, i as BlockFieldOptionsMap, j as BlockFieldExtension, k as BlockFieldExtensionsMap } from './types-CYfHxUhe.mjs';
+import { C as ContentConfig, l as ContentTypeConfig, R as RiverbankSiteConfig, i as BlockFieldOptionsMap, j as BlockFieldExtension, k as BlockFieldExtensionsMap } from './types-txWsSxN7.mjs';
 
 /**
  * SDK Content Config Validation

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@riverbankcms/sdk",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Riverbank CMS SDK for headless content consumption",
   "main": "./dist/server/index.js",
   "module": "./dist/server/index.mjs",
   "types": "./dist/server/index.d.ts",
   "bin": {
-    "riverbankcms": "./dist/cli/index.js"
+    "riverbankcms": "dist/cli/index.js"
   },
   "exports": {
     ".": {
@@ -138,7 +138,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/riverbankcms/riverbankcms.git",
+    "url": "git+https://github.com/riverbankcms/riverbankcms.git",
     "directory": "packages/sdk"
   },
   "keywords": [