@riverbankcms/sdk 0.4.2 → 0.5.0

package/dist/server/{chunk-ZEAJW6T3.mjs → chunk-C6FIJC7T.mjs}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-A2FZMRDW.mjs";
 import {
   prefetchBlockData
-} from "./chunk-7DS4Q3GA.mjs";
+} from "./chunk-AEFWG657.mjs";
 
 // src/rendering/helpers/loadPage.ts
 async function loadPage(params) {
@@ -74,7 +74,8 @@ async function loadPage(params) {
     theme: site.theme,
     sdkConfig: site.sdkConfig ?? null,
     siteId,
-    resolvedData
+    resolvedData,
+    supabaseUrl: site.supabaseUrl
     // Note: routeMap is optional and can be built from site data if needed for internal links.
     // Consumers can construct it from site.pages and pass explicitly via Page component props.
     // Example: const routeMap = site.pages.reduce((map, p) => ({ ...map, [p.id]: p.path }), {});
@@ -84,4 +85,4 @@ async function loadPage(params) {
 export {
   loadPage
 };
-//# sourceMappingURL=chunk-ZEAJW6T3.mjs.map
+//# sourceMappingURL=chunk-C6FIJC7T.mjs.map

package/dist/server/chunk-C6FIJC7T.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/rendering/helpers/loadPage.ts"],"sourcesContent":["/**\n * Server-side helper to fetch all data needed for <Page> component.\n *\n * Use this in server components, getServerSideProps, or API routes.\n */\n\nimport type { RiverbankClient, SiteResponse } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\nimport { executeCodeLoaders, mergeLoaderResults } from '../../data/executeCodeLoaders';\nimport type { DataLoaderOverrides } from '../../data/types';\n\n/**\n * SDK config from API response (without siteId which is stripped at storage).\n * This is the runtime representation - for defining configs, use RiverbankSiteConfig.\n */\nexport type RuntimeSdkConfig = NonNullable<SiteResponse['sdkConfig']>;\n\nexport type LoadPageParams = {\n  client: RiverbankClient;\n  siteId: string;\n  path: string;\n  pageId?: string;\n  /**\n   * If true, fetches draft/unpublished content instead of published content.\n   * This affects both the page structure and block data loaders.\n   * Requires API key with site access.\n   *\n   * @default false\n   */\n  preview?: boolean;\n  /**\n   * Code-based data loaders for custom blocks.\n   *\n   * Use this to fetch data from external APIs (not just whitelisted CMS endpoints).\n   * Keys are block kinds (e.g., 'custom.featured-products').\n   *\n   * Config-based loaders (defined in riverbank.config.ts) run first.\n   * Code loaders run second and take precedence on key conflicts.\n   *\n   * @example\n   * ```typescript\n   * const pageData = await loadPage({\n   *   client,\n   *   siteId: 'site-123',\n   *   path: '/',\n   *   dataLoaderOverrides: {\n   *     'custom.featured-products': {\n   *       products: async (ctx) => {\n   *         const res = await fetch(`https://api.shop.com/products?category=${ctx.content.categoryId}`);\n   *         return res.json();\n   *       },\n   *     },\n   *   },\n   * });\n   * ```\n   */\n  dataLoaderOverrides?: DataLoaderOverrides;\n  /**\n   * URL search parameters from the page request.\n   * Passed to code-based data loaders for pagination, filtering, etc.\n   *\n   * @example\n   * ```typescript\n   * // In Next.js App Router\n   * export default async function Page({ params, searchParams }) {\n   *   const pageData = await loadPage({\n   *     client,\n   *     siteId: 'site-123',\n   *     path: `/${params.slug || ''}`,\n   *     searchParams: await searchParams,\n   *   });\n   *   return <Page {...pageData} />;\n   * }\n   * ```\n   */\n  searchParams?: Record<string, string | string[] | undefined>;\n};\n\nexport type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholders' | 'blockOverrides'> & {\n  /**\n   * SDK site configuration, if available.\n   * Contains SDK-defined theme palette, section backgrounds, and style options.\n   */\n  sdkConfig: RuntimeSdkConfig | null;\n  /**\n   * Supabase storage URL for direct image access.\n   * SDK sites use this instead of NEXT_PUBLIC_SUPABASE_URL env var.\n   */\n  supabaseUrl?: string;\n};\n\n/**\n * Server-side helper to fetch all data needed for <Page> component.\n *\n * Fetches site data, page data, and prefetches block data loaders in parallel.\n *\n * @example Next.js App Router (published content)\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { loadPage, Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({\n *   apiKey: process.env.RIVERBANK_API_KEY!,\n *   baseUrl: process.env.NEXT_PUBLIC_DASHBOARD_URL + '/api',\n * });\n *\n * export default async function PageRoute({ params }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug || ''}`,\n *   });\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example Next.js App Router (preview/draft content)\n * ```tsx\n * export default async function PreviewRoute({ params, searchParams }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: searchParams.siteId,\n *     path: `/${params.slug || ''}`,\n *     preview: true, // Fetch draft content\n *   });\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example Next.js Pages Router (getServerSideProps)\n * ```tsx\n * export async function getServerSideProps({ params }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug || ''}`,\n *   });\n *\n *   return { props: pageData };\n * }\n *\n * export default function PageRoute(props) {\n *   return <Page {...props} />;\n * }\n * ```\n */\nexport async function loadPage(params: LoadPageParams): Promise<LoadPageResult> {\n  const { client, siteId, path, pageId, preview = false, dataLoaderOverrides, searchParams } = params;\n\n  // Fetch site and page data in parallel\n  const [site, pageResponse] = await Promise.all([\n    client.getSite({ id: siteId }),\n    client.getPage({ siteId, path, preview }),\n  ]);\n\n  // Extract page data (getContentByPath can return page or entry)\n  if ('entry' in pageResponse) {\n    throw new Error(\n      'This path resolves to a content entry, not a page. ' +\n      'Use loadContent() instead, which handles both pages and entries. ' +\n      'For entries, loadContent() returns the raw entry data for custom rendering.'\n    );\n  }\n\n  const { page: pageData } = pageResponse;\n\n  // Convert API response blocks to PageOutline format with content\n  // API returns blocks with full content - PageRenderer needs the content field for rendering\n  const blocks = pageData.blocks.map((block) => {\n    if (!block || typeof block !== 'object') {\n      throw new Error('Invalid block format in API response');\n    }\n    if (typeof block.id !== 'string' && block.id !== null) {\n      throw new Error(`Invalid block id: expected string or null, got ${typeof block.id}`);\n    }\n    if (typeof block.kind !== 'string') {\n      throw new Error(`Invalid block kind: expected string, got ${typeof block.kind}`);\n    }\n    if (typeof block.purpose !== 'string') {\n      throw new Error(`Invalid block purpose: expected string, got ${typeof block.purpose}`);\n    }\n\n    // Include content for rendering\n    // API provides `content` (active content for the requested stage)\n    // and optionally `draftContent` for preview mode\n    const typedBlock = block as {\n      id: string | null;\n      kind: string;\n      purpose: string;\n      content?: Record<string, unknown>;\n      draftContent?: { data: Record<string, unknown> } | null;\n    };\n\n    return {\n      id: typedBlock.id,\n      kind: typedBlock.kind,\n      purpose: typedBlock.purpose,\n      // Include content for PageRenderer's getRenderableContent()\n      content: typedBlock.content ?? {},\n      // Include draftContent if available (for preview mode)\n      draftContent: typedBlock.draftContent?.data ?? null,\n    };\n  });\n\n  const pageOutline = {\n    name: pageData.name,\n    path: pageData.path,\n    purpose: pageData.purpose,\n    blocks,\n  };\n\n  // Build prefetch context\n  const prefetchContext: {\n    siteId: string;\n    pageId: string;\n    previewStage: 'published' | 'preview';\n    searchParams?: Record<string, string | string[] | undefined>;\n  } = {\n    siteId,\n    pageId: pageId ?? pageData.id,\n    previewStage: preview ? 'preview' : 'published',\n    searchParams,\n  };\n\n  // Prefetch block data loaders (config-based loaders for CMS endpoints)\n  // Note: searchParams is intentionally NOT passed to config-based loaders.\n  // Config loaders call CMS endpoints which don't need URL params.\n  // Only code-based loaders (dataLoaderOverrides) receive searchParams for\n  // custom pagination, filtering, and sorting via external APIs.\n  const configData = await prefetchBlockData(\n    pageOutline,\n    prefetchContext,\n    client,\n    {\n      // Pass custom blocks so their config-based loaders are discovered\n      customBlocks: site.sdkConfig?.customBlocks,\n    }\n  );\n\n  // Execute code-based loaders (external APIs) and merge results\n  let resolvedData = configData;\n  if (dataLoaderOverrides && Object.keys(dataLoaderOverrides).length > 0) {\n    const codeData = await executeCodeLoaders(pageOutline, prefetchContext, dataLoaderOverrides);\n    resolvedData = mergeLoaderResults(configData, codeData);\n  }\n\n  return {\n    page: pageOutline,\n    theme: site.theme,\n    sdkConfig: site.sdkConfig ?? null,\n    siteId,\n    resolvedData,\n    supabaseUrl: site.supabaseUrl,\n    // Note: routeMap is optional and can be built from site data if needed for internal links.\n    // Consumers can construct it from site.pages and pass explicitly via Page component props.\n    // Example: const routeMap = site.pages.reduce((map, p) => ({ ...map, [p.id]: p.path }), {});\n  };\n}\n"],"mappings":";;;;;;;;;AAqJA,eAAsB,SAAS,QAAiD;AAC9E,QAAM,EAAE,QAAQ,QAAQ,MAAM,QAAQ,UAAU,OAAO,qBAAqB,aAAa,IAAI;AAG7F,QAAM,CAAC,MAAM,YAAY,IAAI,MAAM,QAAQ,IAAI;AAAA,IAC7C,OAAO,QAAQ,EAAE,IAAI,OAAO,CAAC;AAAA,IAC7B,OAAO,QAAQ,EAAE,QAAQ,MAAM,QAAQ,CAAC;AAAA,EAC1C,CAAC;AAGD,MAAI,WAAW,cAAc;AAC3B,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AAEA,QAAM,EAAE,MAAM,SAAS,IAAI;AAI3B,QAAM,SAAS,SAAS,OAAO,IAAI,CAAC,UAAU;AAC5C,QAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AACA,QAAI,OAAO,MAAM,OAAO,YAAY,MAAM,OAAO,MAAM;AACrD,YAAM,IAAI,MAAM,kDAAkD,OAAO,MAAM,EAAE,EAAE;AAAA,IACrF;AACA,QAAI,OAAO,MAAM,SAAS,UAAU;AAClC,YAAM,IAAI,MAAM,4CAA4C,OAAO,MAAM,IAAI,EAAE;AAAA,IACjF;AACA,QAAI,OAAO,MAAM,YAAY,UAAU;AACrC,YAAM,IAAI,MAAM,+CAA+C,OAAO,MAAM,OAAO,EAAE;AAAA,IACvF;AAKA,UAAM,aAAa;AAQnB,WAAO;AAAA,MACL,IAAI,WAAW;AAAA,MACf,MAAM,WAAW;AAAA,MACjB,SAAS,WAAW;AAAA;AAAA,MAEpB,SAAS,WAAW,WAAW,CAAC;AAAA;AAAA,MAEhC,cAAc,WAAW,cAAc,QAAQ;AAAA,IACjD;AAAA,EACF,CAAC;AAED,QAAM,cAAc;AAAA,IAClB,MAAM,SAAS;AAAA,IACf,MAAM,SAAS;AAAA,IACf,SAAS,SAAS;AAAA,IAClB;AAAA,EACF;AAGA,QAAM,kBAKF;AAAA,IACF;AAAA,IACA,QAAQ,UAAU,SAAS;AAAA,IAC3B,cAAc,UAAU,YAAY;AAAA,IACpC;AAAA,EACF;AAOA,QAAM,aAAa,MAAM;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA,MAEE,cAAc,KAAK,WAAW;AAAA,IAChC;AAAA,EACF;AAGA,MAAI,eAAe;AACnB,MAAI,uBAAuB,OAAO,KAAK,mBAAmB,EAAE,SAAS,GAAG;AACtE,UAAM,WAAW,MAAM,mBAAmB,aAAa,iBAAiB,mBAAmB;AAC3F,mBAAe,mBAAmB,YAAY,QAAQ;AAAA,EACxD;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,KAAK;AAAA,IACZ,WAAW,KAAK,aAAa;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,aAAa,KAAK;AAAA;AAAA;AAAA;AAAA,EAIpB;AACF;","names":[]}

package/dist/server/{chunk-TO7FD6TQ.js → chunk-I2D7KOEA.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkHOY77YBFjs = require('./chunk-HOY77YBF.js');
+var _chunkRVDS7VSPjs = require('./chunk-RVDS7VSP.js');
 
 // src/rendering/helpers/loadContent.ts
 function isPageContent(result) {
@@ -56,7 +56,7 @@ async function loadContent(params) {
     purpose: pageData.purpose,
     blocks
   };
-  const resolvedData = await _chunkHOY77YBFjs.prefetchBlockData.call(void 0, 
+  const resolvedData = await _chunkRVDS7VSPjs.prefetchBlockData.call(void 0, 
     pageOutline,
     {
       siteId,
@@ -120,7 +120,7 @@ async function processEntryTemplate(templates, entry, context, client) {
     purpose: "entry-template",
     blocks
   };
-  const resolvedData = await _chunkHOY77YBFjs.prefetchBlockData.call(void 0, 
+  const resolvedData = await _chunkRVDS7VSPjs.prefetchBlockData.call(void 0, 
     templatePage,
     {
       siteId: context.siteId,
@@ -137,4 +137,4 @@ async function processEntryTemplate(templates, entry, context, client) {
 
 
 exports.isPageContent = isPageContent; exports.isEntryContent = isEntryContent; exports.loadContent = loadContent;
-//# sourceMappingURL=chunk-TO7FD6TQ.js.map
+//# sourceMappingURL=chunk-I2D7KOEA.js.map

package/dist/server/{chunk-TO7FD6TQ.js.map → chunk-I2D7KOEA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-TO7FD6TQ.js","../../src/rendering/helpers/loadContent.ts"],"names":["resolvedData"],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-TO7FD6TQ.js","sourcesContent":[null,"/**\n * Server-side helper to fetch content (page or entry) by path.\n *\n * Use this for dynamic routing where a path could resolve to either\n * a page or a content entry.\n */\n\nimport type { Theme } from '@riverbankcms/blocks';\nimport type { RiverbankClient, PageResponse } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\nimport type { ResolvedBlockData } from '../../data/prefetchBlockData';\n\nexport type LoadContentParams = {\n  client: RiverbankClient;\n  siteId: string;\n  path: string;\n  /**\n   * If true, fetches draft/unpublished content instead of published content.\n   * This affects both pages and entries.\n   * Requires API key with site access.\n   *\n   * @default false\n   */\n  preview?: boolean;\n};\n\n/**\n * Content entry data returned when a path resolves to an entry\n */\nexport type ContentEntryData = {\n  id: string;\n  /** Content type key (e.g., 'blog-post', 'product') */\n  type: string | null;\n  title: string;\n  slug: string | null;\n  path: string | null;\n  status: string;\n  publishAt: string | null;\n  /** The raw content fields - use these to render your own UI */\n  content: Record<string, unknown>;\n  metaTitle: string | null;\n  metaDescription: string | null;\n  createdAt: string;\n  updatedAt: string;\n};\n\n/**\n * Result when path resolves to a page\n */\nexport type PageContentResult = {\n  type: 'page';\n  /** Page outline ready for rendering with <Page> component */\n  page: PageProps['page'];\n  /** Site theme for styling */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n  /** Pre-fetched block data for data loaders */\n  resolvedData: ResolvedBlockData;\n};\n\n/**\n * Result when path resolves to a content entry\n */\nexport type EntryContentResult = {\n  type: 'entry';\n  /** Raw entry data - render this however you want */\n  entry: ContentEntryData;\n  /** Template page for rendering the entry (if available) */\n  templatePage: PageProps['page'] | null;\n  /** Pre-fetched block data for template page data loaders */\n  resolvedData: ResolvedBlockData;\n  /** Data context for template blocks (includes entry content for bindings) */\n  dataContext: { contentEntry: Record<string, unknown> };\n  /** Site theme for styling (useful if rendering with SDK components) */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n};\n\n/**\n * Discriminated union result from loadContent\n */\nexport type LoadContentResult = PageContentResult | EntryContentResult;\n\n/**\n * Type guard to check if result is a page\n */\nexport function isPageContent(result: LoadContentResult): result is PageContentResult {\n  return result.type === 'page';\n}\n\n/**\n * Type guard to check if result is an entry\n */\nexport function isEntryContent(result: LoadContentResult): result is EntryContentResult {\n  return result.type === 'entry';\n}\n\n/**\n * Server-side helper to fetch content by path.\n *\n * Returns a discriminated union - either page data (ready for `<Page>` component)\n * or raw entry data (for custom rendering).\n *\n * @example Dynamic routing with both pages and entries\n * ```tsx\n * import { loadContent, Page, isPageContent } from '@riverbankcms/sdk';\n *\n * export default async function DynamicRoute({ params }) {\n *   const content = await loadContent({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug?.join('/') || ''}`,\n *   });\n *\n *   if (isPageContent(content)) {\n *     return <Page {...content} />;\n *   }\n *\n *   // Render entry with custom UI\n *   return (\n *     <article>\n *       <h1>{content.entry.title}</h1>\n *       <div>{content.entry.content.body}</div>\n *     </article>\n *   );\n * }\n * ```\n *\n * @example Entry-specific rendering based on content type\n * ```tsx\n * const content = await loadContent({ client, siteId, path });\n *\n * if (content.type === 'entry') {\n *   switch (content.entry.type) {\n *     case 'blog-post':\n *       return <BlogPost entry={content.entry} theme={content.theme} />;\n *     case 'product':\n *       return <ProductPage entry={content.entry} theme={content.theme} />;\n *     default:\n *       return <GenericEntry entry={content.entry} />;\n *   }\n * }\n *\n * return <Page {...content} />;\n * ```\n *\n * @example Preview mode for draft content\n * ```tsx\n * const content = await loadContent({\n *   client,\n *   siteId,\n *   path,\n *   preview: true, // Fetches draft content for both pages and entries\n * });\n * ```\n */\nexport async function loadContent(params: LoadContentParams): Promise<LoadContentResult> {\n  const { client, siteId, path, preview = false } = params;\n\n  // Fetch site and content in parallel\n  const [site, contentResponse] = await Promise.all([\n    client.getSite({ id: siteId }),\n    client.getPage({ siteId, path, preview }),\n  ]);\n\n  // Check if response is an entry\n  if (isEntryResponse(contentResponse)) {\n    const entryData = contentResponse.entry;\n\n    const entry: ContentEntryData = {\n      id: entryData.id,\n      type: entryData.type,\n      title: entryData.title,\n      slug: entryData.slug,\n      path: entryData.path,\n      status: entryData.status,\n      publishAt: entryData.publishAt,\n      // Use draft content in preview mode, otherwise use published content\n      content: preview\n        ? (entryData.draftContent ?? entryData.content)\n        : entryData.content,\n      metaTitle: preview\n        ? (entryData.draftMetaTitle ?? entryData.metaTitle)\n        : entryData.metaTitle,\n      metaDescription: preview\n        ? (entryData.draftMetaDescription ?? entryData.metaDescription)\n        : entryData.metaDescription,\n      createdAt: entryData.createdAt,\n      updatedAt: entryData.updatedAt,\n    };\n\n    // Process template if available (uses first template from content type)\n    const { templatePage, resolvedData } = await processEntryTemplate(\n      contentResponse.templates as Template[] | undefined,\n      entry,\n      { siteId, preview },\n      client\n    );\n\n    return {\n      type: 'entry',\n      entry,\n      templatePage,\n      resolvedData,\n      dataContext: { contentEntry: entry.content },\n      theme: site.theme,\n      siteId,\n    };\n  }\n\n  // Handle page response\n  const { page: pageData } = contentResponse;\n\n  // Convert API response blocks to PageOutline format with validation\n  const blocks = pageData.blocks.map((block) => validateAndConvertBlock(block, 'page'));\n\n  const pageOutline = {\n    name: pageData.name,\n    path: pageData.path,\n    purpose: pageData.purpose,\n    blocks,\n  };\n\n  // Prefetch block data loaders for pages\n  const resolvedData = await prefetchBlockData(\n    pageOutline,\n    {\n      siteId,\n      pageId: pageData.id,\n      previewStage: preview ? 'preview' : 'published',\n    },\n    client\n  );\n\n  return {\n    type: 'page',\n    page: pageOutline,\n    theme: site.theme,\n    siteId,\n    resolvedData,\n  };\n}\n\n/**\n * Type guard to check if API response is an entry\n */\nfunction isEntryResponse(response: PageResponse): response is Extract<PageResponse, { type: 'entry' }> {\n  return 'type' in response && response.type === 'entry';\n}\n\n/**\n * Validates and converts a raw block from API response to PageOutline block format.\n * Used for both page blocks and template blocks to ensure consistent validation.\n */\nfunction validateAndConvertBlock(\n  block: unknown,\n  source: 'page' | 'template'\n): { id: string | null; kind: string; purpose: string; content?: Record<string, unknown> } {\n  if (!block || typeof block !== 'object') {\n    throw new Error(`Invalid block format in ${source} API response`);\n  }\n\n  const blockRecord = block as Record<string, unknown>;\n\n  // Template blocks use 'blockKind', page blocks use 'kind'\n  const kindField = source === 'template' ? 'blockKind' : 'kind';\n  const kindValue = blockRecord[kindField];\n\n  if (typeof blockRecord.id !== 'string' && blockRecord.id !== null) {\n    throw new Error(`Invalid block id in ${source}: expected string or null, got ${typeof blockRecord.id}`);\n  }\n  if (typeof kindValue !== 'string') {\n    throw new Error(`Invalid block ${kindField} in ${source}: expected string, got ${typeof kindValue}`);\n  }\n\n  // Template blocks derive purpose from scope, page blocks have explicit purpose\n  if (source === 'page') {\n    if (typeof blockRecord.purpose !== 'string') {\n      throw new Error(`Invalid block purpose in ${source}: expected string, got ${typeof blockRecord.purpose}`);\n    }\n    return {\n      id: blockRecord.id as string | null,\n      kind: kindValue,\n      purpose: blockRecord.purpose,\n    };\n  }\n\n  // Template block: derive purpose from scope, include content\n  const scope = blockRecord.scope as 'entry' | 'template' | undefined;\n  const content = (blockRecord.content as Record<string, unknown> | null) ?? {};\n\n  return {\n    id: blockRecord.id as string | null,\n    kind: kindValue,\n    purpose: scope === 'entry' ? 'entry-content' : 'template-layout',\n    content,\n  };\n}\n\n/** Template block structure from API response */\ntype TemplateBlock = {\n  id: string;\n  blockKind: string;\n  scope: 'entry' | 'template';\n  content: Record<string, unknown> | null;\n};\n\n/** Template structure from API response */\ntype Template = {\n  id: string;\n  name: string;\n  templateKey: string;\n  blocks: TemplateBlock[];\n};\n\n/**\n * Processes an entry's template into a PageOutline format and prefetches block data.\n * Returns null templatePage if no valid template with blocks is available.\n */\nasync function processEntryTemplate(\n  templates: Template[] | undefined,\n  entry: ContentEntryData,\n  context: { siteId: string; preview: boolean },\n  client: RiverbankClient\n): Promise<{ templatePage: PageProps['page'] | null; resolvedData: ResolvedBlockData }> {\n  const template = templates?.[0];\n\n  // Templates without blocks are treated as \"no template\" - the entry should be\n  // rendered with custom UI rather than an empty template page\n  if (!template || !template.blocks?.length) {\n    return { templatePage: null, resolvedData: {} };\n  }\n\n  // Convert template blocks to PageOutline format with validation\n  const blocks = template.blocks.map((block) => validateAndConvertBlock(block, 'template'));\n\n  const templatePage: PageProps['page'] = {\n    name: template.name || 'Entry Template',\n    path: entry.path || '/',\n    purpose: 'entry-template',\n    blocks,\n  };\n\n  // Prefetch block data for template\n  const resolvedData = await prefetchBlockData(\n    templatePage,\n    {\n      siteId: context.siteId,\n      pageId: template.id,\n      previewStage: context.preview ? 'preview' : 'published',\n    },\n    client\n  );\n\n  return { templatePage, resolvedData };\n}\n"]}
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-I2D7KOEA.js","../../src/rendering/helpers/loadContent.ts"],"names":["resolvedData"],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-I2D7KOEA.js","sourcesContent":[null,"/**\n * Server-side helper to fetch content (page or entry) by path.\n *\n * Use this for dynamic routing where a path could resolve to either\n * a page or a content entry.\n */\n\nimport type { Theme } from '@riverbankcms/blocks';\nimport type { RiverbankClient, PageResponse } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\nimport type { ResolvedBlockData } from '../../data/prefetchBlockData';\n\nexport type LoadContentParams = {\n  client: RiverbankClient;\n  siteId: string;\n  path: string;\n  /**\n   * If true, fetches draft/unpublished content instead of published content.\n   * This affects both pages and entries.\n   * Requires API key with site access.\n   *\n   * @default false\n   */\n  preview?: boolean;\n};\n\n/**\n * Content entry data returned when a path resolves to an entry\n */\nexport type ContentEntryData = {\n  id: string;\n  /** Content type key (e.g., 'blog-post', 'product') */\n  type: string | null;\n  title: string;\n  slug: string | null;\n  path: string | null;\n  status: string;\n  publishAt: string | null;\n  /** The raw content fields - use these to render your own UI */\n  content: Record<string, unknown>;\n  metaTitle: string | null;\n  metaDescription: string | null;\n  createdAt: string;\n  updatedAt: string;\n};\n\n/**\n * Result when path resolves to a page\n */\nexport type PageContentResult = {\n  type: 'page';\n  /** Page outline ready for rendering with <Page> component */\n  page: PageProps['page'];\n  /** Site theme for styling */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n  /** Pre-fetched block data for data loaders */\n  resolvedData: ResolvedBlockData;\n};\n\n/**\n * Result when path resolves to a content entry\n */\nexport type EntryContentResult = {\n  type: 'entry';\n  /** Raw entry data - render this however you want */\n  entry: ContentEntryData;\n  /** Template page for rendering the entry (if available) */\n  templatePage: PageProps['page'] | null;\n  /** Pre-fetched block data for template page data loaders */\n  resolvedData: ResolvedBlockData;\n  /** Data context for template blocks (includes entry content for bindings) */\n  dataContext: { contentEntry: Record<string, unknown> };\n  /** Site theme for styling (useful if rendering with SDK components) */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n};\n\n/**\n * Discriminated union result from loadContent\n */\nexport type LoadContentResult = PageContentResult | EntryContentResult;\n\n/**\n * Type guard to check if result is a page\n */\nexport function isPageContent(result: LoadContentResult): result is PageContentResult {\n  return result.type === 'page';\n}\n\n/**\n * Type guard to check if result is an entry\n */\nexport function isEntryContent(result: LoadContentResult): result is EntryContentResult {\n  return result.type === 'entry';\n}\n\n/**\n * Server-side helper to fetch content by path.\n *\n * Returns a discriminated union - either page data (ready for `<Page>` component)\n * or raw entry data (for custom rendering).\n *\n * @example Dynamic routing with both pages and entries\n * ```tsx\n * import { loadContent, Page, isPageContent } from '@riverbankcms/sdk';\n *\n * export default async function DynamicRoute({ params }) {\n *   const content = await loadContent({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug?.join('/') || ''}`,\n *   });\n *\n *   if (isPageContent(content)) {\n *     return <Page {...content} />;\n *   }\n *\n *   // Render entry with custom UI\n *   return (\n *     <article>\n *       <h1>{content.entry.title}</h1>\n *       <div>{content.entry.content.body}</div>\n *     </article>\n *   );\n * }\n * ```\n *\n * @example Entry-specific rendering based on content type\n * ```tsx\n * const content = await loadContent({ client, siteId, path });\n *\n * if (content.type === 'entry') {\n *   switch (content.entry.type) {\n *     case 'blog-post':\n *       return <BlogPost entry={content.entry} theme={content.theme} />;\n *     case 'product':\n *       return <ProductPage entry={content.entry} theme={content.theme} />;\n *     default:\n *       return <GenericEntry entry={content.entry} />;\n *   }\n * }\n *\n * return <Page {...content} />;\n * ```\n *\n * @example Preview mode for draft content\n * ```tsx\n * const content = await loadContent({\n *   client,\n *   siteId,\n *   path,\n *   preview: true, // Fetches draft content for both pages and entries\n * });\n * ```\n */\nexport async function loadContent(params: LoadContentParams): Promise<LoadContentResult> {\n  const { client, siteId, path, preview = false } = params;\n\n  // Fetch site and content in parallel\n  const [site, contentResponse] = await Promise.all([\n    client.getSite({ id: siteId }),\n    client.getPage({ siteId, path, preview }),\n  ]);\n\n  // Check if response is an entry\n  if (isEntryResponse(contentResponse)) {\n    const entryData = contentResponse.entry;\n\n    const entry: ContentEntryData = {\n      id: entryData.id,\n      type: entryData.type,\n      title: entryData.title,\n      slug: entryData.slug,\n      path: entryData.path,\n      status: entryData.status,\n      publishAt: entryData.publishAt,\n      // Use draft content in preview mode, otherwise use published content\n      content: preview\n        ? (entryData.draftContent ?? entryData.content)\n        : entryData.content,\n      metaTitle: preview\n        ? (entryData.draftMetaTitle ?? entryData.metaTitle)\n        : entryData.metaTitle,\n      metaDescription: preview\n        ? (entryData.draftMetaDescription ?? entryData.metaDescription)\n        : entryData.metaDescription,\n      createdAt: entryData.createdAt,\n      updatedAt: entryData.updatedAt,\n    };\n\n    // Process template if available (uses first template from content type)\n    const { templatePage, resolvedData } = await processEntryTemplate(\n      contentResponse.templates as Template[] | undefined,\n      entry,\n      { siteId, preview },\n      client\n    );\n\n    return {\n      type: 'entry',\n      entry,\n      templatePage,\n      resolvedData,\n      dataContext: { contentEntry: entry.content },\n      theme: site.theme,\n      siteId,\n    };\n  }\n\n  // Handle page response\n  const { page: pageData } = contentResponse;\n\n  // Convert API response blocks to PageOutline format with validation\n  const blocks = pageData.blocks.map((block) => validateAndConvertBlock(block, 'page'));\n\n  const pageOutline = {\n    name: pageData.name,\n    path: pageData.path,\n    purpose: pageData.purpose,\n    blocks,\n  };\n\n  // Prefetch block data loaders for pages\n  const resolvedData = await prefetchBlockData(\n    pageOutline,\n    {\n      siteId,\n      pageId: pageData.id,\n      previewStage: preview ? 'preview' : 'published',\n    },\n    client\n  );\n\n  return {\n    type: 'page',\n    page: pageOutline,\n    theme: site.theme,\n    siteId,\n    resolvedData,\n  };\n}\n\n/**\n * Type guard to check if API response is an entry\n */\nfunction isEntryResponse(response: PageResponse): response is Extract<PageResponse, { type: 'entry' }> {\n  return 'type' in response && response.type === 'entry';\n}\n\n/**\n * Validates and converts a raw block from API response to PageOutline block format.\n * Used for both page blocks and template blocks to ensure consistent validation.\n */\nfunction validateAndConvertBlock(\n  block: unknown,\n  source: 'page' | 'template'\n): { id: string | null; kind: string; purpose: string; content?: Record<string, unknown> } {\n  if (!block || typeof block !== 'object') {\n    throw new Error(`Invalid block format in ${source} API response`);\n  }\n\n  const blockRecord = block as Record<string, unknown>;\n\n  // Template blocks use 'blockKind', page blocks use 'kind'\n  const kindField = source === 'template' ? 'blockKind' : 'kind';\n  const kindValue = blockRecord[kindField];\n\n  if (typeof blockRecord.id !== 'string' && blockRecord.id !== null) {\n    throw new Error(`Invalid block id in ${source}: expected string or null, got ${typeof blockRecord.id}`);\n  }\n  if (typeof kindValue !== 'string') {\n    throw new Error(`Invalid block ${kindField} in ${source}: expected string, got ${typeof kindValue}`);\n  }\n\n  // Template blocks derive purpose from scope, page blocks have explicit purpose\n  if (source === 'page') {\n    if (typeof blockRecord.purpose !== 'string') {\n      throw new Error(`Invalid block purpose in ${source}: expected string, got ${typeof blockRecord.purpose}`);\n    }\n    return {\n      id: blockRecord.id as string | null,\n      kind: kindValue,\n      purpose: blockRecord.purpose,\n    };\n  }\n\n  // Template block: derive purpose from scope, include content\n  const scope = blockRecord.scope as 'entry' | 'template' | undefined;\n  const content = (blockRecord.content as Record<string, unknown> | null) ?? {};\n\n  return {\n    id: blockRecord.id as string | null,\n    kind: kindValue,\n    purpose: scope === 'entry' ? 'entry-content' : 'template-layout',\n    content,\n  };\n}\n\n/** Template block structure from API response */\ntype TemplateBlock = {\n  id: string;\n  blockKind: string;\n  scope: 'entry' | 'template';\n  content: Record<string, unknown> | null;\n};\n\n/** Template structure from API response */\ntype Template = {\n  id: string;\n  name: string;\n  templateKey: string;\n  blocks: TemplateBlock[];\n};\n\n/**\n * Processes an entry's template into a PageOutline format and prefetches block data.\n * Returns null templatePage if no valid template with blocks is available.\n */\nasync function processEntryTemplate(\n  templates: Template[] | undefined,\n  entry: ContentEntryData,\n  context: { siteId: string; preview: boolean },\n  client: RiverbankClient\n): Promise<{ templatePage: PageProps['page'] | null; resolvedData: ResolvedBlockData }> {\n  const template = templates?.[0];\n\n  // Templates without blocks are treated as \"no template\" - the entry should be\n  // rendered with custom UI rather than an empty template page\n  if (!template || !template.blocks?.length) {\n    return { templatePage: null, resolvedData: {} };\n  }\n\n  // Convert template blocks to PageOutline format with validation\n  const blocks = template.blocks.map((block) => validateAndConvertBlock(block, 'template'));\n\n  const templatePage: PageProps['page'] = {\n    name: template.name || 'Entry Template',\n    path: entry.path || '/',\n    purpose: 'entry-template',\n    blocks,\n  };\n\n  // Prefetch block data for template\n  const resolvedData = await prefetchBlockData(\n    templatePage,\n    {\n      siteId: context.siteId,\n      pageId: template.id,\n      previewStage: context.preview ? 'preview' : 'published',\n    },\n    client\n  );\n\n  return { templatePage, resolvedData };\n}\n"]}

package/dist/server/chunk-KFLZGNPO.mjs

@@ -0,0 +1,189 @@
+// src/navigation/index.ts
+function getPrimaryNavigation(navigation) {
+  if (!navigation || navigation.length === 0) return null;
+  return navigation.find((menu) => menu.isPrimary) ?? navigation[0] ?? null;
+}
+function getNavigationBySlug(navigation, slug) {
+  if (!navigation || navigation.length === 0) return null;
+  return navigation.find((menu) => menu.name === slug) ?? null;
+}
+function getPrimaryNavItems(navigation) {
+  return transformToNavItems(getPrimaryNavigation(navigation));
+}
+function getNavItemsBySlug(navigation, slug) {
+  return transformToNavItems(getNavigationBySlug(navigation, slug));
+}
+function transformToNavItems(menu) {
+  if (!menu?.items || menu.items.length === 0) return [];
+  return menu.items.filter((item) => !item.parentId && item.urlType !== "dropdown").sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0)).map((item) => ({
+    label: item.label,
+    href: extractHref(item),
+    isExternal: isExternalLink(item)
+  })).filter((item) => Boolean(item.href));
+}
+function buildMenuViewModel(navigation) {
+  const menu = getPrimaryNavigation(navigation);
+  if (!menu) {
+    return { items: [], ctaItem: null };
+  }
+  const flatItems = menu.items.filter((item) => !item.parentId && item.urlType !== "dropdown").sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));
+  const items = [];
+  let ctaItem = null;
+  for (const item of flatItems) {
+    const viewItem = {
+      id: item.id,
+      label: item.label,
+      link: convertToLinkValue(item),
+      target: null,
+      rel: null,
+      active: false
+    };
+    if (!ctaItem && Boolean(item.isCta)) {
+      ctaItem = { ...viewItem, variant: "primary" };
+      continue;
+    }
+    items.push(viewItem);
+  }
+  return { items, ctaItem };
+}
+function buildLogoViewModel(logo, fallbackTitle) {
+  if (!logo) {
+    return null;
+  }
+  if (!logo.url && !logo.storagePath) {
+    return null;
+  }
+  const alt = logo.alt && logo.alt.trim().length > 0 ? logo.alt : fallbackTitle ?? "Site logo";
+  return {
+    type: "image",
+    src: logo.url ?? "",
+    // Empty when using storagePath - MediaNode builds direct URL
+    alt,
+    assetId: logo.assetId ?? void 0,
+    width: logo.width ?? void 0,
+    height: logo.height ?? void 0,
+    storagePath: logo.storagePath ?? void 0,
+    storageBucket: logo.storageBucket ?? void 0
+  };
+}
+function extractHref(item) {
+  const link = item.url;
+  if (!link || typeof link !== "object" || !("href" in link)) return "";
+  return link.href;
+}
+function isExternalLink(item) {
+  const link = item.url;
+  if (!link || typeof link !== "object" || !("kind" in link)) return false;
+  return link.kind === "external";
+}
+function convertToLinkValue(item) {
+  const payload = item.url;
+  if (!payload) return null;
+  const kind = typeof payload.kind === "string" ? payload.kind : null;
+  if (kind === "external" || kind === "url") {
+    const href = typeof payload.href === "string" ? payload.href : null;
+    return href ? { kind, href } : null;
+  }
+  if (kind === "internal") {
+    const routeId = typeof payload.routeId === "string" ? payload.routeId : null;
+    const entityId = typeof payload.entityId === "string" ? payload.entityId : null;
+    const entityType = payload.entityType === "page" || payload.entityType === "content" ? payload.entityType : null;
+    const href = typeof payload.href === "string" ? payload.href : null;
+    const title = typeof payload.title === "string" ? payload.title : null;
+    const typeLabel = typeof payload.typeLabel === "string" ? payload.typeLabel : null;
+    if (!routeId || !entityId || !entityType || !href || !title || !typeLabel) {
+      return null;
+    }
+    return {
+      kind: "internal",
+      routeId,
+      entityId,
+      entityType,
+      href,
+      title,
+      typeLabel,
+      contentTypeKey: typeof payload.contentTypeKey === "string" ? payload.contentTypeKey : null,
+      contentTypeName: typeof payload.contentTypeName === "string" ? payload.contentTypeName : null,
+      updatedAt: typeof payload.updatedAt === "string" ? payload.updatedAt : null
+    };
+  }
+  return null;
+}
+function buildSimpleMenu(navigation, routes) {
+  const menu = getPrimaryNavigation(navigation);
+  if (!menu) {
+    return { items: [], ctaItem: null };
+  }
+  const flatItems = menu.items.filter((item) => !item.parentId && item.urlType !== "dropdown").sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));
+  const items = [];
+  let ctaItem = null;
+  for (const item of flatItems) {
+    const link = item.url;
+    const href = resolveHref(link, routes);
+    if (!href) continue;
+    const navLink = {
+      id: item.id,
+      label: item.label,
+      href,
+      isExternal: link?.kind === "external"
+    };
+    if (!ctaItem && Boolean(item.isCta)) {
+      ctaItem = navLink;
+      continue;
+    }
+    items.push(navLink);
+  }
+  return { items, ctaItem };
+}
+function resolveHref(link, routes) {
+  if (!link) return null;
+  if (link.kind === "external" || link.kind === "url") {
+    return link.href || null;
+  }
+  if (link.kind === "internal" && link.routeId) {
+    const route = routes[link.routeId];
+    if (route) {
+      if (typeof route === "string") {
+        return route;
+      }
+      return route.path ?? route.href ?? route.draftPath ?? link.href ?? null;
+    }
+    return link.href ?? null;
+  }
+  return null;
+}
+function buildSimpleLogo(logo, fallbackAlt) {
+  if (!logo || !logo.url) {
+    return null;
+  }
+  const alt = logo.alt && logo.alt.trim().length > 0 ? logo.alt : fallbackAlt ?? "Site logo";
+  const result = {
+    type: "image",
+    src: logo.url,
+    alt
+  };
+  if (logo.width != null) {
+    result.width = logo.width;
+  }
+  if (logo.height != null) {
+    result.height = logo.height;
+  }
+  return result;
+}
+var transformNavItems = transformToNavItems;
+var selectPrimaryMenu = getPrimaryNavigation;
+
+export {
+  getPrimaryNavigation,
+  getNavigationBySlug,
+  getPrimaryNavItems,
+  getNavItemsBySlug,
+  transformToNavItems,
+  buildMenuViewModel,
+  buildLogoViewModel,
+  buildSimpleMenu,
+  buildSimpleLogo,
+  transformNavItems,
+  selectPrimaryMenu
+};
+//# sourceMappingURL=chunk-KFLZGNPO.mjs.map

package/dist/server/chunk-KFLZGNPO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/navigation/index.ts"],"sourcesContent":["/**\n * Navigation helper utilities for SDK sites.\n *\n * Provides helpers to transform CMS navigation data into render-ready structures.\n * Supports both simple NavItem arrays and full MenuViewModels for block rendering.\n *\n * @example Simple usage\n * ```ts\n * import { getPrimaryNavItems } from '@riverbankcms/sdk/navigation';\n *\n * const headerNav = getPrimaryNavItems(siteData.navigation);\n * // [{ href: '/', label: 'Home', isExternal: false }, ...]\n * ```\n *\n * @example Block rendering usage\n * ```ts\n * import { buildMenuViewModel, buildLogoViewModel } from '@riverbankcms/sdk/navigation';\n *\n * const menu = buildMenuViewModel(siteData.navigation);\n * const logo = buildLogoViewModel(siteData.layout.logo, siteData.site.title);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { menu, content: { logo } },\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '@riverbankcms/api';\nimport type { RouteMap } from '@riverbankcms/blocks';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types for block rendering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Link value types matching @riverbankcms/blocks\n */\nexport type InternalLinkValue = {\n  kind: 'internal';\n  routeId: string;\n  entityId: string;\n  entityType: 'page' | 'content';\n  href: string;\n  title: string;\n  typeLabel: string;\n  contentTypeKey?: string | null;\n  contentTypeName?: string | null;\n  updatedAt?: string | null;\n};\n\nexport type ExternalLinkValue = {\n  kind: 'external';\n  href: string;\n};\n\nexport type CustomLinkValue = {\n  kind: 'url';\n  href: string;\n};\n\nexport type LinkValue = InternalLinkValue | ExternalLinkValue | CustomLinkValue;\n\n/**\n * Menu link view model for block rendering\n */\nexport type MenuLinkViewModel = {\n  id: string;\n  label: string;\n  link: LinkValue | null;\n  target: string | null;\n  rel: string | null;\n  active?: boolean;\n};\n\n/**\n * CTA link view model (extends MenuLinkViewModel with variant)\n */\nexport type MenuCtaViewModel = MenuLinkViewModel & {\n  variant: string;\n};\n\n/**\n * Complete menu view model for header/footer blocks\n */\nexport type MenuViewModel = {\n  items: MenuLinkViewModel[];\n  ctaItem: MenuCtaViewModel | null;\n};\n\n/**\n * Logo source data from site layout\n */\nexport type LogoSource = {\n  url: string | null;\n  alt: string | null;\n  assetId?: string | null;\n  width?: number | null;\n  height?: number | null;\n  storagePath?: string | null;\n  storageBucket?: string | null;\n} | null;\n\n/**\n * Logo view model for block rendering\n */\nexport type LogoViewModel = {\n  type: 'image';\n  src: string;\n  alt: string;\n  assetId?: string;\n  width?: number | null;\n  height?: number | null;\n  storagePath?: string;\n  storageBucket?: string;\n} | null;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple NavItem type for basic usage\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * A simplified navigation item structure for component rendering.\n */\nexport type NavItem = {\n  /** The URL to navigate to */\n  href: string;\n  /** Display text for the navigation link */\n  label: string;\n  /** Whether link should open in new tab (external links) */\n  isExternal: boolean;\n};\n\n/**\n * Simple nav link with pre-resolved href for block rendering.\n */\nexport type SimpleNavLink = {\n  id: string;\n  label: string;\n  href: string;\n  isExternal: boolean;\n};\n\n/**\n * Simple menu view model with pre-resolved hrefs.\n * Use this instead of MenuViewModel for cleaner data flow.\n */\nexport type SimpleMenuViewModel = {\n  items: SimpleNavLink[];\n  ctaItem: SimpleNavLink | null;\n};\n\n/**\n * Simple logo data for block rendering.\n */\nexport type SimpleLogo = {\n  type: 'image';\n  src: string;\n  alt: string;\n  width?: number;\n  height?: number;\n} | null;\n\n// RouteMap type is imported from @riverbankcms/blocks for consistency\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Menu selection helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get the primary navigation menu object.\n * Returns menu marked as isPrimary, or first menu if none marked.\n *\n * @example\n * ```ts\n * const menu = getPrimaryNavigation(siteData.navigation);\n * console.log(menu?.title); // \"Main Navigation\"\n * ```\n */\nexport function getPrimaryNavigation(\n  navigation: NavigationMenuWithItems[],\n): NavigationMenuWithItems | null {\n  if (!navigation || navigation.length === 0) return null;\n  // navigation.length > 0 is guaranteed above, so [0] exists\n  return navigation.find((menu) => menu.isPrimary) ?? navigation[0] ?? null;\n}\n\n/**\n * Get a navigation menu by name/slug.\n *\n * @example\n * ```ts\n * const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');\n * ```\n */\nexport function getNavigationBySlug(\n  navigation: NavigationMenuWithItems[],\n  slug: string,\n): NavigationMenuWithItems | null {\n  if (!navigation || navigation.length === 0) return null;\n  return navigation.find((menu) => menu.name === slug) ?? null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple NavItem[] transformations\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get nav items from the primary menu (marked isPrimary, or first menu).\n * Returns empty array if no navigation configured.\n *\n * @example\n * ```ts\n * const headerNav = getPrimaryNavItems(siteData.navigation);\n * // [{ href: '/', label: 'Home', isExternal: false }, ...]\n * ```\n */\nexport function getPrimaryNavItems(navigation: NavigationMenuWithItems[]): NavItem[] {\n  return transformToNavItems(getPrimaryNavigation(navigation));\n}\n\n/**\n * Get nav items from a specific menu by slug.\n * Useful for footer nav, secondary nav, etc.\n * Returns empty array if menu not found.\n *\n * @example\n * ```ts\n * const footerNav = getNavItemsBySlug(siteData.navigation, 'footer');\n * ```\n */\nexport function getNavItemsBySlug(navigation: NavigationMenuWithItems[], slug: string): NavItem[] {\n  return transformToNavItems(getNavigationBySlug(navigation, slug));\n}\n\n/**\n * Transform a menu into simple NavItem array.\n */\nexport function transformToNavItems(menu: NavigationMenuWithItems | null): NavItem[] {\n  if (!menu?.items || menu.items.length === 0) return [];\n\n  return menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0))\n    .map((item) => ({\n      label: item.label,\n      href: extractHref(item),\n      isExternal: isExternalLink(item),\n    }))\n    .filter((item): item is NavItem => Boolean(item.href));\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Full MenuViewModel for block rendering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a MenuViewModel from navigation data for block rendering.\n * Extracts CTA item separately and preserves full link data.\n *\n * @example\n * ```ts\n * const menuViewModel = buildMenuViewModel(siteData.navigation);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { menu: menuViewModel },\n * });\n * ```\n */\nexport function buildMenuViewModel(navigation: NavigationMenuWithItems[]): MenuViewModel {\n  const menu = getPrimaryNavigation(navigation);\n\n  if (!menu) {\n    return { items: [], ctaItem: null };\n  }\n\n  const flatItems = menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));\n\n  const items: MenuLinkViewModel[] = [];\n  let ctaItem: MenuCtaViewModel | null = null;\n\n  for (const item of flatItems) {\n    const viewItem: MenuLinkViewModel = {\n      id: item.id,\n      label: item.label,\n      link: convertToLinkValue(item),\n      target: null,\n      rel: null,\n      active: false,\n    };\n\n    // Extract first CTA item separately\n    if (!ctaItem && Boolean(item.isCta)) {\n      ctaItem = { ...viewItem, variant: 'primary' };\n      continue;\n    }\n\n    items.push(viewItem);\n  }\n\n  return { items, ctaItem };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Logo view model helper\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a LogoViewModel from site layout data.\n *\n * @param logo - Logo source from siteData.layout.logo\n * @param fallbackTitle - Site title to use as alt text fallback\n *\n * @example\n * ```ts\n * const logoViewModel = buildLogoViewModel(siteData.layout.logo, siteData.site.title);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { content: { logo: logoViewModel } },\n * });\n * ```\n */\nexport function buildLogoViewModel(\n  logo: LogoSource,\n  fallbackTitle: string | null | undefined,\n): LogoViewModel {\n  if (!logo) {\n    return null;\n  }\n\n  // Logo must have storagePath (for direct Supabase URL) or explicit url\n  if (!logo.url && !logo.storagePath) {\n    return null;\n  }\n\n  const alt = logo.alt && logo.alt.trim().length > 0 ? logo.alt : fallbackTitle ?? 'Site logo';\n\n  return {\n    type: 'image',\n    src: logo.url ?? '', // Empty when using storagePath - MediaNode builds direct URL\n    alt,\n    assetId: logo.assetId ?? undefined,\n    width: logo.width ?? undefined,\n    height: logo.height ?? undefined,\n    storagePath: logo.storagePath ?? undefined,\n    storageBucket: logo.storageBucket ?? undefined,\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Internal helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Extracts the href from a navigation item's url field.\n */\nfunction extractHref(item: NavigationItemRecord): string {\n  const link = item.url as LinkPayload | null | undefined;\n  if (!link || typeof link !== 'object' || !('href' in link)) return '';\n  return link.href;\n}\n\n/**\n * Determines if a navigation item's link is external.\n */\nfunction isExternalLink(item: NavigationItemRecord): boolean {\n  const link = item.url as LinkPayload | null | undefined;\n  if (!link || typeof link !== 'object' || !('kind' in link)) return false;\n  return link.kind === 'external';\n}\n\n/**\n * Convert navigation item to LinkValue for block rendering.\n */\nfunction convertToLinkValue(item: NavigationItemRecord): LinkValue | null {\n  const payload = item.url as Record<string, unknown> | null;\n  if (!payload) return null;\n\n  const kind = typeof payload.kind === 'string' ? payload.kind : null;\n\n  if (kind === 'external' || kind === 'url') {\n    const href = typeof payload.href === 'string' ? payload.href : null;\n    return href ? { kind, href } as ExternalLinkValue | CustomLinkValue : null;\n  }\n\n  if (kind === 'internal') {\n    const routeId = typeof payload.routeId === 'string' ? payload.routeId : null;\n    const entityId = typeof payload.entityId === 'string' ? payload.entityId : null;\n    const entityType = payload.entityType === 'page' || payload.entityType === 'content'\n      ? payload.entityType\n      : null;\n    const href = typeof payload.href === 'string' ? payload.href : null;\n    const title = typeof payload.title === 'string' ? payload.title : null;\n    const typeLabel = typeof payload.typeLabel === 'string' ? payload.typeLabel : null;\n\n    if (!routeId || !entityId || !entityType || !href || !title || !typeLabel) {\n      return null;\n    }\n\n    return {\n      kind: 'internal',\n      routeId,\n      entityId,\n      entityType,\n      href,\n      title,\n      typeLabel,\n      contentTypeKey: typeof payload.contentTypeKey === 'string' ? payload.contentTypeKey : null,\n      contentTypeName: typeof payload.contentTypeName === 'string' ? payload.contentTypeName : null,\n      updatedAt: typeof payload.updatedAt === 'string' ? payload.updatedAt : null,\n    };\n  }\n\n  return null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple pre-resolved menu/logo helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a SimpleMenuViewModel from navigation data with pre-resolved hrefs.\n * Use this instead of buildMenuViewModel for cleaner data flow.\n *\n * @param navigation - Navigation menus from site data\n * @param routes - Route map for resolving internal links\n *\n * @example\n * ```ts\n * const menu = buildSimpleMenu(siteData.navigation, siteData.routes);\n * // { items: [{ id, label, href: '/', isExternal: false }], cta: null }\n * ```\n */\nexport function buildSimpleMenu(\n  navigation: NavigationMenuWithItems[],\n  routes: RouteMap,\n): SimpleMenuViewModel {\n  const menu = getPrimaryNavigation(navigation);\n\n  if (!menu) {\n    return { items: [], ctaItem: null };\n  }\n\n  const flatItems = menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));\n\n  const items: SimpleNavLink[] = [];\n  let ctaItem: SimpleNavLink | null = null;\n\n  for (const item of flatItems) {\n    const link = item.url as LinkPayload | null;\n    const href = resolveHref(link, routes);\n\n    if (!href) continue;\n\n    const navLink: SimpleNavLink = {\n      id: item.id,\n      label: item.label,\n      href,\n      isExternal: link?.kind === 'external',\n    };\n\n    // Extract first CTA item separately\n    if (!ctaItem && Boolean(item.isCta)) {\n      ctaItem = navLink;\n      continue;\n    }\n\n    items.push(navLink);\n  }\n\n  return { items, ctaItem };\n}\n\n/**\n * Resolve href from a link payload using route map.\n * @internal\n */\nfunction resolveHref(link: LinkPayload | null, routes: RouteMap): string | null {\n  if (!link) return null;\n\n  // External or custom URL links - use href directly\n  if (link.kind === 'external' || link.kind === 'url') {\n    return link.href || null;\n  }\n\n  // Internal link - resolve from route map\n  if (link.kind === 'internal' && link.routeId) {\n    const route = routes[link.routeId];\n    if (route) {\n      if (typeof route === 'string') {\n        return route;\n      }\n      // Try path first, then href, then draftPath\n      return route.path ?? route.href ?? route.draftPath ?? link.href ?? null;\n    }\n    // Fall back to link.href if route not found\n    return link.href ?? null;\n  }\n\n  return null;\n}\n\n/**\n * Build a SimpleLogo from site layout data.\n *\n * @param logo - Logo data from site layout\n * @param fallbackAlt - Fallback alt text (usually site title)\n *\n * @example\n * ```ts\n * const logo = buildSimpleLogo(siteData.layout.logo, siteData.site.title);\n * // { src: 'https://...', alt: 'Site Name', width: 200, height: 50 }\n * ```\n */\nexport function buildSimpleLogo(\n  logo: { url?: string | null; alt?: string | null; width?: number | null; height?: number | null } | null,\n  fallbackAlt: string | null | undefined,\n): SimpleLogo {\n  if (!logo || !logo.url) {\n    return null;\n  }\n\n  const alt = logo.alt && logo.alt.trim().length > 0 ? logo.alt : (fallbackAlt ?? 'Site logo');\n\n  const result: NonNullable<SimpleLogo> = {\n    type: 'image',\n    src: logo.url,\n    alt,\n  };\n\n  if (logo.width != null) {\n    result.width = logo.width;\n  }\n  if (logo.height != null) {\n    result.height = logo.height;\n  }\n\n  return result;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Deprecated aliases (for backwards compatibility during migration)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * @deprecated Use `transformToNavItems` instead.\n * This alias is maintained for backwards compatibility only.\n */\nexport const transformNavItems = transformToNavItems;\n\n/**\n * @deprecated Use `getPrimaryNavigation` instead.\n * This alias is maintained for backwards compatibility only.\n */\nexport const selectPrimaryMenu = getPrimaryNavigation;\n\n// Re-export types for convenience\nexport type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '@riverbankcms/api';\n"],"mappings":"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","names":[]}

package/dist/server/chunk-L5EA4FXU.mjs

@@ -0,0 +1,134 @@
+import {
+  buildSimpleLogo,
+  buildSimpleMenu
+} from "./chunk-KFLZGNPO.mjs";
+import {
+  PageRenderer,
+  buildThemeRuntime,
+  renderBlock
+} from "./chunk-LNOUXALA.mjs";
+import {
+  siteFooterManifest,
+  siteHeaderManifest
+} from "./chunk-BYBJA6SP.mjs";
+
+// src/rendering/components/Page.tsx
+import { jsx } from "react/jsx-runtime";
+function Page({
+  page,
+  theme,
+  themeTokens: providedTokens,
+  siteId,
+  resolvedData,
+  routeMap,
+  wrapBlock,
+  registry,
+  usePlaceholders = false,
+  blockOverrides,
+  sdkConfig,
+  supabaseUrl,
+  dataContext
+}) {
+  const baseTokens = providedTokens ?? buildThemeRuntime(theme).tokens;
+  const themeTokens = sdkConfig?.theme?.palette ? { ...baseTokens, palette: { ...baseTokens.palette, ...sdkConfig.theme.palette } } : baseTokens;
+  return /* @__PURE__ */ jsx(
+    PageRenderer,
+    {
+      theme,
+      page,
+      themeTokens,
+      usePlaceholders,
+      dataContext: {
+        siteId,
+        resolvedData,
+        routes: routeMap,
+        occurrenceContext: dataContext?.occurrenceContext ?? null,
+        contentEntry: dataContext?.contentEntry ?? null,
+        supabaseUrl
+      },
+      routeMap,
+      wrapBlock,
+      registry,
+      blockOverrides,
+      sdkConfig
+    }
+  );
+}
+
+// src/rendering/components/Layout.tsx
+import { Fragment, jsxs } from "react/jsx-runtime";
+async function Layout({
+  siteData: providedSiteData,
+  client,
+  siteId,
+  slug,
+  domain,
+  children,
+  header = true,
+  footer = true,
+  headerVariant
+}) {
+  let siteData = providedSiteData;
+  if (!siteData) {
+    if (!client) {
+      throw new Error("Layout: must provide either siteData or client");
+    }
+    if (!siteId && !slug && !domain) {
+      throw new Error("Layout: must provide siteId, slug, or domain when using client");
+    }
+    siteData = await client.getSite({ id: siteId, slug, domain });
+  }
+  const { site, theme, navigation, layout, routes } = siteData;
+  const themeRuntime = buildThemeRuntime(theme);
+  const menuViewModel = buildSimpleMenu(navigation, routes);
+  const logoViewModel = buildSimpleLogo(layout.logo ?? null, site.title);
+  const headerData = {
+    menu: menuViewModel,
+    logo: logoViewModel,
+    site,
+    theme,
+    routes
+  };
+  const headerContent = headerVariant ? { ...layout.header, variant: headerVariant } : layout.header;
+  const themeWithVariant = headerVariant ? {
+    ...theme,
+    header: { ...theme.header, variant: headerVariant }
+  } : theme;
+  const viewModelOverrides = {
+    $root: {
+      siteId: site.id,
+      routes,
+      theme: themeWithVariant
+    },
+    site,
+    menu: menuViewModel,
+    content: {
+      logo: logoViewModel
+    }
+  };
+  let headerElement = null;
+  if (header === true) {
+    headerElement = renderBlock(siteHeaderManifest, headerContent, {
+      theme: themeRuntime.tokens,
+      themeConfig: themeWithVariant,
+      viewModelOverrides
+    });
+  } else if (typeof header === "function") {
+    headerElement = header(headerData);
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    headerElement,
+    children,
+    footer && renderBlock(siteFooterManifest, layout.footer, {
+      theme: themeRuntime.tokens,
+      themeConfig: theme,
+      viewModelOverrides
+    })
+  ] });
+}
+
+export {
+  Page,
+  Layout
+};
+//# sourceMappingURL=chunk-L5EA4FXU.mjs.map

package/dist/server/chunk-L5EA4FXU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/rendering/components/Page.tsx","../../src/rendering/components/Layout.tsx"],"sourcesContent":["/**\n * Pure Page renderer component for Riverbank CMS.\n *\n * This component expects all data to be provided via props.\n * For data fetching, use:\n * - Server-side: `await loadPage({ client, siteId, path })`\n * - Client-side: `usePage({ client, siteId, path })`\n */\n\nimport { PageRenderer, buildThemeRuntime } from '@riverbankcms/blocks';\nimport type { PageOutline, RouteMap, Theme, ThemeTokens, BlockOverrides, OccurrenceContextData } from '@riverbankcms/blocks';\nimport type { ResolvedBlockData } from '../../data';\nimport type { RuntimeSdkConfig } from '../helpers/loadPage';\n\n// Re-export OccurrenceContextData for SDK consumers\nexport type { OccurrenceContextData };\n\nexport type PageProps = {\n  // Required data (must be provided by caller)\n  page: PageOutline;\n  theme: Theme;\n  siteId: string;\n\n  // Optional data\n  themeTokens?: ThemeTokens; // If not provided, will be built from theme\n  resolvedData?: ResolvedBlockData; // Pre-fetched block data\n  routeMap?: RouteMap;\n  /**\n   * SDK site configuration containing theme palette overrides.\n   * When provided, the SDK palette tokens are merged into the theme tokens,\n   * allowing blocks to use SDK-defined color tokens for section backgrounds.\n   */\n  sdkConfig?: RuntimeSdkConfig | null;\n  /**\n   * Supabase storage URL for direct image access.\n   * SDK sites receive this from the API instead of requiring NEXT_PUBLIC_SUPABASE_URL env var.\n   */\n  supabaseUrl?: string;\n\n  /**\n   * Additional context data for content entry pages.\n   * Used to pass occurrence context and content entry data to blocks.\n   */\n  dataContext?: {\n    /** Occurrence context for event pages (from URL like /events/yoga/2025-01-15) */\n    occurrenceContext?: OccurrenceContextData | null;\n    /** Content entry data for template pages */\n    contentEntry?: Record<string, unknown> | null;\n  };\n\n  // Customization\n  wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;\n  registry?: Parameters<typeof PageRenderer>[0]['registry'];\n  usePlaceholders?: boolean;\n  /**\n   * Custom components to override default block rendering.\n   * Keys can be full block kind (\"block.hero\") or short form (\"hero\").\n   *\n   * This is SSR-safe - no context or hooks required.\n   *\n   * @example\n   * ```tsx\n   * <Page\n   *   {...pageData}\n   *   blockOverrides={{\n   *     'hero': MyCustomHero,\n   *     'block.testimonials': MyCustomTestimonials,\n   *   }}\n   * />\n   * ```\n   */\n  blockOverrides?: BlockOverrides;\n};\n\n/**\n * Pure renderer for Riverbank CMS pages.\n *\n * This component expects all data to be provided via props.\n * For data fetching, use:\n * - Server-side: `await loadPage({ client, siteId, path })`\n * - Client-side: `usePage({ client, siteId, path })`\n *\n * @example Server-side (Next.js App Router)\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { loadPage, Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({ apiKey, baseUrl });\n *\n * export default async function PageRoute({ params }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: 'site-id',\n *     path: `/${params.slug}`,\n *   });\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example Client-side\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { usePage, Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({ apiKey, baseUrl });\n *\n * function MyPage({ path }) {\n *   const pageData = usePage({ client, siteId: 'site-id', path });\n *\n *   if (pageData.loading) return <LoadingState />;\n *   if (pageData.error) return <ErrorState error={pageData.error} />;\n *   if (!pageData.page) return <NotFound />;\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n */\nexport function Page({\n  page,\n  theme,\n  themeTokens: providedTokens,\n  siteId,\n  resolvedData,\n  routeMap,\n  wrapBlock,\n  registry,\n  usePlaceholders = false,\n  blockOverrides,\n  sdkConfig,\n  supabaseUrl,\n  dataContext,\n}: PageProps) {\n  // Build theme tokens if not provided\n  const baseTokens = providedTokens ?? buildThemeRuntime(theme).tokens;\n\n  // Merge SDK palette tokens into theme tokens\n  // This allows blocks to resolve SDK-defined color tokens (e.g., 'primary' -> '#6d28d9')\n  const themeTokens = sdkConfig?.theme?.palette\n    ? { ...baseTokens, palette: { ...baseTokens.palette, ...sdkConfig.theme.palette } }\n    : baseTokens;\n\n  return (\n    <PageRenderer\n      theme={theme}\n      page={page}\n      themeTokens={themeTokens}\n      usePlaceholders={usePlaceholders}\n      dataContext={{\n        siteId,\n        resolvedData,\n        routes: routeMap,\n        occurrenceContext: dataContext?.occurrenceContext ?? null,\n        contentEntry: dataContext?.contentEntry ?? null,\n        supabaseUrl,\n      }}\n      routeMap={routeMap}\n      wrapBlock={wrapBlock}\n      registry={registry}\n      blockOverrides={blockOverrides}\n      sdkConfig={sdkConfig}\n    />\n  );\n}\n","/**\n * Layout component with header and footer\n *\n * Renders site header and footer around content. Fetches site data if not provided.\n */\n\nimport { renderBlock, siteFooterManifest, siteHeaderManifest, buildThemeRuntime } from '@riverbankcms/blocks';\nimport { buildSimpleMenu, buildSimpleLogo } from '../../navigation';\nimport type { RiverbankClient, SiteResponse } from '../../client/types';\n\nexport type HeaderData = {\n  menu: ReturnType<typeof buildSimpleMenu>;\n  logo: ReturnType<typeof buildSimpleLogo>;\n  site: SiteResponse['site'];\n  theme: SiteResponse['theme'];\n  routes: SiteResponse['routes'];\n};\n\nexport type LayoutProps = {\n  // Option 1: Pass pre-fetched site data\n  siteData?: SiteResponse;\n\n  // Option 2: Fetch site data (provide client + identifier)\n  client?: RiverbankClient;\n  siteId?: string;\n  slug?: string;\n  domain?: string;\n\n  // Content\n  children: React.ReactNode;\n\n  // Control rendering\n  header?: boolean | ((data: HeaderData) => React.ReactNode);\n  footer?: boolean;\n\n  // Header variant override (if using default header)\n  headerVariant?: 'classic' | 'centered' | 'transparent' | 'floating' | 'editorial';\n};\n\n/**\n * Layout component that wraps content with site header and footer.\n *\n * @example With pre-fetched site data (recommended)\n * ```tsx\n * const site = await client.getSite({ slug: 'my-site' });\n *\n * <Layout siteData={site}>\n *   <Page {...pageData} />\n * </Layout>\n * ```\n *\n * @example With automatic fetching\n * ```tsx\n * <Layout client={client} slug=\"my-site\">\n *   <Page {...pageData} />\n * </Layout>\n * ```\n */\nexport async function Layout({\n  siteData: providedSiteData,\n  client,\n  siteId,\n  slug,\n  domain,\n  children,\n  header = true,\n  footer = true,\n  headerVariant,\n}: LayoutProps) {\n  // Fetch site data if not provided\n  let siteData = providedSiteData;\n  if (!siteData) {\n    if (!client) {\n      throw new Error('Layout: must provide either siteData or client');\n    }\n    if (!siteId && !slug && !domain) {\n      throw new Error('Layout: must provide siteId, slug, or domain when using client');\n    }\n\n    siteData = await client.getSite({ id: siteId, slug, domain });\n  }\n\n  const { site, theme, navigation, layout, routes } = siteData;\n  const themeRuntime = buildThemeRuntime(theme);\n\n  // Build view models for header/footer\n  const menuViewModel = buildSimpleMenu(navigation, routes);\n  const logoViewModel = buildSimpleLogo(layout.logo ?? null, site.title);\n\n  // Prepare header data for custom headers\n  const headerData: HeaderData = {\n    menu: menuViewModel,\n    logo: logoViewModel,\n    site,\n    theme,\n    routes,\n  };\n\n  // Override header variant if specified\n  const headerContent = headerVariant\n    ? { ...layout.header, variant: headerVariant }\n    : layout.header;\n\n  // Override theme header variant if specified\n  const themeWithVariant = headerVariant\n    ? {\n        ...theme,\n        header: { ...theme.header, variant: headerVariant },\n      }\n    : theme;\n\n  const viewModelOverrides = {\n    $root: {\n      siteId: site.id,\n      routes,\n      theme: themeWithVariant,\n    },\n    site,\n    menu: menuViewModel,\n    content: {\n      logo: logoViewModel,\n    },\n  };\n\n  // Render header based on type\n  let headerElement: React.ReactNode = null;\n  if (header === true) {\n    // Default header rendering\n    headerElement = renderBlock(siteHeaderManifest, headerContent, {\n      theme: themeRuntime.tokens,\n      themeConfig: themeWithVariant,\n      viewModelOverrides,\n    });\n  } else if (typeof header === 'function') {\n    // Custom header rendering\n    headerElement = header(headerData);\n  }\n\n  return (\n    <>\n      {headerElement}\n\n      {children}\n\n      {footer && renderBlock(siteFooterManifest, layout.footer, {\n        theme: themeRuntime.tokens,\n        themeConfig: theme,\n        viewModelOverrides,\n      })}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;AA+II;AAzBG,SAAS,KAAK;AAAA,EACnB;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAc;AAEZ,QAAM,aAAa,kBAAkB,kBAAkB,KAAK,EAAE;AAI9D,QAAM,cAAc,WAAW,OAAO,UAClC,EAAE,GAAG,YAAY,SAAS,EAAE,GAAG,WAAW,SAAS,GAAG,UAAU,MAAM,QAAQ,EAAE,IAChF;AAEJ,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,aAAa;AAAA,QACX;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR,mBAAmB,aAAa,qBAAqB;AAAA,QACrD,cAAc,aAAa,gBAAgB;AAAA,QAC3C;AAAA,MACF;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;;;ACxBI;AAjFJ,eAAsB,OAAO;AAAA,EAC3B,UAAU;AAAA,EACV;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT,SAAS;AAAA,EACT;AACF,GAAgB;AAEd,MAAI,WAAW;AACf,MAAI,CAAC,UAAU;AACb,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,gDAAgD;AAAA,IAClE;AACA,QAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ;AAC/B,YAAM,IAAI,MAAM,gEAAgE;AAAA,IAClF;AAEA,eAAW,MAAM,OAAO,QAAQ,EAAE,IAAI,QAAQ,MAAM,OAAO,CAAC;AAAA,EAC9D;AAEA,QAAM,EAAE,MAAM,OAAO,YAAY,QAAQ,OAAO,IAAI;AACpD,QAAM,eAAe,kBAAkB,KAAK;AAG5C,QAAM,gBAAgB,gBAAgB,YAAY,MAAM;AACxD,QAAM,gBAAgB,gBAAgB,OAAO,QAAQ,MAAM,KAAK,KAAK;AAGrE,QAAM,aAAyB;AAAA,IAC7B,MAAM;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,QAAM,gBAAgB,gBAClB,EAAE,GAAG,OAAO,QAAQ,SAAS,cAAc,IAC3C,OAAO;AAGX,QAAM,mBAAmB,gBACrB;AAAA,IACE,GAAG;AAAA,IACH,QAAQ,EAAE,GAAG,MAAM,QAAQ,SAAS,cAAc;AAAA,EACpD,IACA;AAEJ,QAAM,qBAAqB;AAAA,IACzB,OAAO;AAAA,MACL,QAAQ,KAAK;AAAA,MACb;AAAA,MACA,OAAO;AAAA,IACT;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN,SAAS;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAGA,MAAI,gBAAiC;AACrC,MAAI,WAAW,MAAM;AAEnB,oBAAgB,YAAY,oBAAoB,eAAe;AAAA,MAC7D,OAAO,aAAa;AAAA,MACpB,aAAa;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH,WAAW,OAAO,WAAW,YAAY;AAEvC,oBAAgB,OAAO,UAAU;AAAA,EACnC;AAEA,SACE,iCACG;AAAA;AAAA,IAEA;AAAA,IAEA,UAAU,YAAY,oBAAoB,OAAO,QAAQ;AAAA,MACxD,OAAO,aAAa;AAAA,MACpB,aAAa;AAAA,MACb;AAAA,IACF,CAAC;AAAA,KACH;AAEJ;","names":[]}