@riverbankcms/sdk 0.1.0 → 0.2.1

package/dist/server/chunk-QQ6U4QX6.js

@@ -1,120 +0,0 @@
-"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; }// src/data/prefetchBlockData.ts
-var _data = require('@riverbankcms/blocks/system/data');
-var SUPPORTED_LOADER_ENDPOINTS = [
-  "listPublishedEntries",
-  "getPublishedEntryPreview",
-  "listPublicEvents",
-  "getPublicFormById",
-  "getPublicBookingServices"
-];
-async function prefetchBlockData(page, context, client, options) {
-  const { customBlocks } = _nullishCoalesce(options, () => ( {}));
-  const customBlockMap = new Map(
-    (_nullishCoalesce(customBlocks, () => ( []))).map((block) => [block.id, block])
-  );
-  return _data.prefetchBlockData.call(void 0, page, context, {
-    apiClient: async ({ endpoint, params }) => {
-      if (!isSupportedEndpoint(endpoint)) {
-        throw new Error(
-          `Unsupported loader endpoint: ${endpoint}. SDK only supports: ${SUPPORTED_LOADER_ENDPOINTS.join(", ")}`
-        );
-      }
-      switch (endpoint) {
-        case "listPublishedEntries": {
-          const { siteId, type, orderBy, limit, stage, mode, entryIds } = _nullishCoalesce(params, () => ( {}));
-          if (!siteId || !type) {
-            throw new Error("listPublishedEntries requires siteId and type params");
-          }
-          const parsedLimit = typeof limit === "string" ? Number.parseInt(limit, 10) : typeof limit === "number" ? limit : void 0;
-          const order = orderBy === "newest" || orderBy === "oldest" || orderBy === "title" || orderBy === "order" ? orderBy : void 0;
-          let parsedEntryIds;
-          if (mode === "manual" && Array.isArray(entryIds)) {
-            parsedEntryIds = entryIds.map((item) => {
-              if (typeof item === "object" && item !== null && "entryId" in item) {
-                return item.entryId;
-              }
-              if (typeof item === "string") {
-                return item;
-              }
-              return null;
-            }).filter((id) => id !== null);
-          }
-          return await client.getEntries({
-            siteId,
-            contentType: type,
-            limit: parsedLimit,
-            order,
-            preview: stage === "preview",
-            // Manual mode - pass entry IDs for hydration
-            mode: mode === "manual" ? "manual" : void 0,
-            entryIds: parsedEntryIds
-          });
-        }
-        case "getPublishedEntryPreview": {
-          const { siteId, type, slug } = _nullishCoalesce(params, () => ( {}));
-          if (!siteId || !type || !slug) {
-            throw new Error("getPublishedEntryPreview requires siteId, type, and slug params");
-          }
-          return await client.getEntry({ siteId, contentType: type, slug });
-        }
-        case "listPublicEvents": {
-          const { siteId, limit, from, to, stage } = _nullishCoalesce(params, () => ( {}));
-          if (!siteId) {
-            throw new Error("listPublicEvents requires siteId param");
-          }
-          const parsedLimit = typeof limit === "string" ? Number.parseInt(limit, 10) : typeof limit === "number" ? limit : void 0;
-          return await client.listPublicEvents({ siteId, limit: parsedLimit, from, to, stage });
-        }
-        case "getPublicFormById": {
-          const { formId } = _nullishCoalesce(params, () => ( {}));
-          if (!formId) {
-            throw new Error("getPublicFormById requires formId param");
-          }
-          return await client.getPublicFormById({ formId });
-        }
-        case "getPublicBookingServices": {
-          const { siteId, ids } = _nullishCoalesce(params, () => ( {}));
-          if (!siteId) {
-            throw new Error("getPublicBookingServices requires siteId param");
-          }
-          return await client.getPublicBookingServices({ siteId, ids });
-        }
-        default: {
-          const _exhaustive = endpoint;
-          throw new Error(`Unhandled endpoint: ${_exhaustive}`);
-        }
-      }
-    },
-    isValidEndpoint: isSupportedEndpoint,
-    onError: (error, { block, loader }) => {
-      console.warn("[prefetchBlockData] failed to prefetch block data", {
-        block,
-        loader,
-        error
-      });
-    },
-    // Provide custom block loader lookup for SDK custom blocks
-    getCustomBlockLoaders: (blockKind) => {
-      const customBlock = customBlockMap.get(blockKind);
-      if (!_optionalChain([customBlock, 'optionalAccess', _ => _.dataLoaders])) return void 0;
-      const loaders = {};
-      for (const [key, loader] of Object.entries(customBlock.dataLoaders)) {
-        loaders[key] = {
-          endpoint: loader.endpoint,
-          params: loader.params,
-          mode: loader.mode
-        };
-      }
-      return loaders;
-    }
-  });
-}
-function isSupportedEndpoint(endpoint) {
-  return SUPPORTED_LOADER_ENDPOINTS.includes(endpoint);
-}
-
-
-
-
-exports.SUPPORTED_LOADER_ENDPOINTS = SUPPORTED_LOADER_ENDPOINTS; exports.prefetchBlockData = prefetchBlockData;
-//# sourceMappingURL=chunk-QQ6U4QX6.js.map

package/dist/server/chunk-QQ6U4QX6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-QQ6U4QX6.js","../../src/data/prefetchBlockData.ts"],"names":[],"mappings":"AAAA;ACMA,wDAA2D;AAepD,IAAM,2BAAA,EAA6B;AAAA,EACxC,sBAAA;AAAA,EACA,0BAAA;AAAA,EACA,kBAAA;AAAA,EACA,mBAAA;AAAA,EACA;AACF,CAAA;AA6CA,MAAA,SAAsB,iBAAA,CACpB,IAAA,EACA,OAAA,EACA,MAAA,EACA,OAAA,EAC4B;AAC5B,EAAA,MAAM,EAAE,aAAa,EAAA,mBAAI,OAAA,UAAW,CAAC,GAAA;AAIrC,EAAA,MAAM,eAAA,EAAiB,IAAI,GAAA;AAAA,IAAA,kBACxB,YAAA,UAAgB,CAAC,GAAA,CAAA,CAAG,GAAA,CAAI,CAAC,KAAA,EAAA,GAAU,CAAC,KAAA,CAAM,EAAA,EAAc,KAAK,CAAC;AAAA,EACjE,CAAA;AAEA,EAAA,OAAO,qCAAA,IAAsB,EAAM,OAAA,EAAS;AAAA,IAC1C,SAAA,EAAW,MAAA,CAAO,EAAE,QAAA,EAAU,OAAO,CAAA,EAAA,GAAM;AAEzC,MAAA,GAAA,CAAI,CAAC,mBAAA,CAAoB,QAAQ,CAAA,EAAG;AAClC,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,6BAAA,EAAgC,QAAQ,CAAA,qBAAA,EAClB,0BAAA,CAA2B,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,QAAA;AAC7D,MAAA;AAIF,MAAA;AAAkB,QAAA;AAEd,UAAA;AACA,UAAA;AACE,YAAA;AAAsE,UAAA;AAIxE,UAAA;AAOA,UAAA;AAMA,UAAA;AACA,UAAA;AACE,YAAA;AAEI,cAAA;AACE,gBAAA;AAAqC,cAAA;AAGvC,cAAA;AACE,gBAAA;AAAO,cAAA;AAET,cAAA;AAAO,YAAA;AAEgC,UAAA;AAG7C,UAAA;AAA+B,YAAA;AAC7B,YAAA;AACa,YAAA;AACN,YAAA;AACP,YAAA;AACmB;AAAA,YAAA;AAEkB,YAAA;AAC3B,UAAA;AACX,QAAA;AACH,QAAA;AAGE,UAAA;AACA,UAAA;AACE,YAAA;AAAiF,UAAA;AAEnF,UAAA;AAAgE,QAAA;AAClE,QAAA;AAEE,UAAA;AACA,UAAA;AACE,YAAA;AAAwD,UAAA;AAE1D,UAAA;AAMA,UAAA;AAAoF,QAAA;AACtF,QAAA;AAEE,UAAA;AACA,UAAA;AACE,YAAA;AAAyD,UAAA;AAE3D,UAAA;AAAgD,QAAA;AAClD,QAAA;AAEE,UAAA;AACA,UAAA;AACE,YAAA;AAAgE,UAAA;AAElE,UAAA;AAA4D,QAAA;AAC9D,QAAA;AAIE,UAAA;AACA,UAAA;AAAoD,QAAA;AACtD,MAAA;AACF,IAAA;AACF,IAAA;AACiB,IAAA;AAEf,MAAA;AAAkE,QAAA;AAChE,QAAA;AACA,QAAA;AACA,MAAA;AACD,IAAA;AACH;AAAA,IAAA;AAGE,MAAA;AACA,MAAA;AAMA,MAAA;AACA,MAAA;AACE,QAAA;AAAe,UAAA;AACI,UAAA;AACF,UAAA;AACF,QAAA;AACf,MAAA;AAEF,MAAA;AAAO,IAAA;AACT,EAAA;AAEJ;AAKA;AACE,EAAA;AACF;AD7GA;AACA;AACA;AACA;AACA","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-QQ6U4QX6.js","sourcesContent":[null,"/**\n * SDK wrapper for block data prefetching.\n * Uses the shared core implementation from @riverbankcms/blocks with the SDK client.\n */\n\nimport type { BlockDataLoader, PageOutline, SdkCustomBlock } from '@riverbankcms/blocks';\nimport { prefetchBlockData as prefetchBlockDataCore } from '@riverbankcms/blocks/system/data';\nimport type { PrefetchContext, ResolvedBlockData } from '@riverbankcms/blocks/system/data';\nimport type { RiverbankClient } from '../client/types';\n\nexport type { PrefetchContext, ResolvedBlockData };\n\n/**\n * Supported loader endpoints for SDK data fetching.\n * Only these endpoints can be used in block data loaders when using the SDK.\n *\n * This is the SINGLE SOURCE OF TRUTH for whitelisted endpoints.\n * - Zod validation schema derives from this array\n * - TypeScript types derive from this array\n * - Runtime validation uses this array\n */\nexport const SUPPORTED_LOADER_ENDPOINTS = [\n  'listPublishedEntries',\n  'getPublishedEntryPreview',\n  'listPublicEvents',\n  'getPublicFormById',\n  'getPublicBookingServices',\n] as const;\n\n/**\n * Union type of all supported loader endpoints.\n * Derived from SUPPORTED_LOADER_ENDPOINTS array.\n */\nexport type SupportedLoaderEndpoint = typeof SUPPORTED_LOADER_ENDPOINTS[number];\n\n/**\n * Options for SDK block data prefetching.\n */\nexport type SdkPrefetchOptions = {\n  /**\n   * SDK custom blocks from site config.\n   * Used to look up data loaders for custom.* blocks.\n   */\n  customBlocks?: SdkCustomBlock[];\n};\n\n/**\n * Prefetch block data for SDK-based applications.\n * Maps loader endpoints to corresponding SDK client methods.\n *\n * Supports both system blocks and SDK custom blocks with data loaders.\n *\n * @example\n * ```typescript\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { prefetchBlockData } from '@riverbankcms/sdk/data';\n *\n * const client = createRiverbankClient({ apiKey, baseUrl });\n * const page = await client.getPage({ siteId, path: '/' });\n *\n * // Basic usage (system blocks only)\n * const blockData = await prefetchBlockData(page.outline, {\n *   siteId: page.siteId,\n *   pageId: page.id,\n * }, client);\n *\n * // With custom blocks from SDK config\n * const blockData = await prefetchBlockData(page.outline, context, client, {\n *   customBlocks: site.sdkConfig?.customBlocks,\n * });\n * ```\n */\nexport async function prefetchBlockData(\n  page: PageOutline,\n  context: PrefetchContext,\n  client: RiverbankClient,\n  options?: SdkPrefetchOptions,\n): Promise<ResolvedBlockData> {\n  const { customBlocks } = options ?? {};\n\n  // Build lookup map for custom block loaders\n  // Key is string (blockKind from page) matching block.id (custom.xxx)\n  const customBlockMap = new Map<string, SdkCustomBlock>(\n    (customBlocks ?? []).map((block) => [block.id as string, block])\n  );\n\n  return prefetchBlockDataCore(page, context, {\n    apiClient: async ({ endpoint, params }) => {\n      // Only support whitelisted loader endpoints\n      if (!isSupportedEndpoint(endpoint)) {\n        throw new Error(\n          `Unsupported loader endpoint: ${endpoint}. ` +\n          `SDK only supports: ${SUPPORTED_LOADER_ENDPOINTS.join(', ')}`\n        );\n      }\n\n      // Map endpoint to SDK client method\n      switch (endpoint) {\n        case 'listPublishedEntries': {\n          const { siteId, type, orderBy, limit, stage, mode, entryIds } = params ?? {};\n          if (!siteId || !type) {\n            throw new Error('listPublishedEntries requires siteId and type params');\n          }\n\n          // Parse limit if provided (can come as string from bindings)\n          const parsedLimit = typeof limit === 'string'\n            ? Number.parseInt(limit, 10)\n            : typeof limit === 'number'\n              ? limit\n              : undefined;\n\n          // Map orderBy to order param (matching embed block field values)\n          const order = (orderBy === 'newest' || orderBy === 'oldest' || orderBy === 'title' || orderBy === 'order')\n            ? orderBy as 'newest' | 'oldest' | 'title' | 'order'\n            : undefined;\n\n          // Extract entry IDs for manual mode\n          // entryIds comes from binding to entries field which contains { entryId: \"uuid\" } objects\n          let parsedEntryIds: string[] | undefined;\n          if (mode === 'manual' && Array.isArray(entryIds)) {\n            parsedEntryIds = entryIds\n              .map((item: unknown) => {\n                if (typeof item === 'object' && item !== null && 'entryId' in item) {\n                  return (item as { entryId: string }).entryId;\n                }\n                // Also support direct string IDs\n                if (typeof item === 'string') {\n                  return item;\n                }\n                return null;\n              })\n              .filter((id): id is string => id !== null);\n          }\n\n          return await client.getEntries({\n            siteId,\n            contentType: type,\n            limit: parsedLimit,\n            order,\n            preview: stage === 'preview',\n            // Manual mode - pass entry IDs for hydration\n            mode: mode === 'manual' ? 'manual' : undefined,\n            entryIds: parsedEntryIds,\n          });\n        }\n\n        case 'getPublishedEntryPreview': {\n          const { siteId, type, slug } = params ?? {};\n          if (!siteId || !type || !slug) {\n            throw new Error('getPublishedEntryPreview requires siteId, type, and slug params');\n          }\n          return await client.getEntry({ siteId, contentType: type, slug });\n        }\n        case 'listPublicEvents': {\n          const { siteId, limit, from, to, stage } = params ?? {};\n          if (!siteId) {\n            throw new Error('listPublicEvents requires siteId param');\n          }\n          const parsedLimit =\n            typeof limit === 'string'\n              ? Number.parseInt(limit, 10)\n              : typeof limit === 'number'\n                ? limit\n                : undefined;\n          return await client.listPublicEvents({ siteId, limit: parsedLimit, from, to, stage });\n        }\n        case 'getPublicFormById': {\n          const { formId } = params ?? {};\n          if (!formId) {\n            throw new Error('getPublicFormById requires formId param');\n          }\n          return await client.getPublicFormById({ formId });\n        }\n        case 'getPublicBookingServices': {\n          const { siteId, ids } = params ?? {};\n          if (!siteId) {\n            throw new Error('getPublicBookingServices requires siteId param');\n          }\n          return await client.getPublicBookingServices({ siteId, ids });\n        }\n\n        default: {\n          // TypeScript should never reach here due to isSupportedEndpoint check\n          const _exhaustive: never = endpoint;\n          throw new Error(`Unhandled endpoint: ${_exhaustive}`);\n        }\n      }\n    },\n    isValidEndpoint: isSupportedEndpoint,\n    onError: (error, { block, loader }) => {\n      console.warn('[prefetchBlockData] failed to prefetch block data', {\n        block,\n        loader,\n        error,\n      });\n    },\n    // Provide custom block loader lookup for SDK custom blocks\n    getCustomBlockLoaders: (blockKind): Record<string, BlockDataLoader> | undefined => {\n      const customBlock = customBlockMap.get(blockKind);\n      if (!customBlock?.dataLoaders) return undefined;\n\n      // Convert SdkConfigLoader to BlockDataLoader\n      // SdkConfigLoader.endpoint is SdkLoaderEndpoint (string union) -> string\n      // SdkConfigLoader.params is Record<string, LoaderParamValue> -> Record<string, unknown>\n      // Both are structurally compatible via covariance\n      const loaders: Record<string, BlockDataLoader> = {};\n      for (const [key, loader] of Object.entries(customBlock.dataLoaders)) {\n        loaders[key] = {\n          endpoint: loader.endpoint,\n          params: loader.params,\n          mode: loader.mode,\n        };\n      }\n      return loaders;\n    },\n  });\n}\n\n/**\n * Type guard for supported loader endpoints\n */\nfunction isSupportedEndpoint(endpoint: string): endpoint is SupportedLoaderEndpoint {\n  return SUPPORTED_LOADER_ENDPOINTS.includes(endpoint as SupportedLoaderEndpoint);\n}\n"]}

package/dist/server/chunk-R5YGLRUG.mjs

@@ -1,122 +0,0 @@
-// src/rendering/components/Page.tsx
-import { PageRenderer, buildThemeRuntime } from "@riverbankcms/blocks";
-import { jsx } from "react/jsx-runtime";
-function Page({
-  page,
-  theme,
-  themeTokens: providedTokens,
-  siteId,
-  resolvedData,
-  routeMap,
-  wrapBlock,
-  registry,
-  usePlaceholders = false,
-  blockOverrides,
-  sdkConfig,
-  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
-      },
-      routeMap,
-      wrapBlock,
-      registry,
-      blockOverrides,
-      sdkConfig
-    }
-  );
-}
-
-// src/rendering/components/Layout.tsx
-import { renderBlock, siteFooterManifest, siteHeaderManifest, buildThemeRuntime as buildThemeRuntime2 } from "@riverbankcms/blocks";
-import { selectPrimaryMenu, buildMenuViewModel, buildLogoViewModel } from "@riverbankcms/site-renderer";
-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 = buildThemeRuntime2(theme);
-  const menu = selectPrimaryMenu(navigation);
-  const menuViewModel = buildMenuViewModel(menu);
-  const logoViewModel = buildLogoViewModel(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-R5YGLRUG.mjs.map

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

@@ -1 +0,0 @@
-{"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  /**\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  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      }}\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 { selectPrimaryMenu, buildMenuViewModel, buildLogoViewModel } from '@riverbankcms/site-renderer';\nimport type { RiverbankClient, SiteResponse } from '../../client/types';\n\nexport type HeaderData = {\n  menu: ReturnType<typeof buildMenuViewModel>;\n  logo: ReturnType<typeof buildLogoViewModel>;\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 using proper helpers from @riverbankcms/site-renderer\n  const menu = selectPrimaryMenu(navigation);\n  const menuViewModel = buildMenuViewModel(menu);\n  const logoViewModel = buildLogoViewModel(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":";AASA,SAAS,cAAc,yBAAyB;AAgI5C;AAxBG,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;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,MAC7C;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;;;ACtJA,SAAS,aAAa,oBAAoB,oBAAoB,qBAAAA,0BAAyB;AACvF,SAAS,mBAAmB,oBAAoB,0BAA0B;AAqItE;AAlFJ,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,eAAeA,mBAAkB,KAAK;AAG5C,QAAM,OAAO,kBAAkB,UAAU;AACzC,QAAM,gBAAgB,mBAAmB,IAAI;AAC7C,QAAM,gBAAgB,mBAAmB,OAAO,QAAQ,MAAM,KAAK,KAAK;AAGxE,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":["buildThemeRuntime"]}

package/dist/server/chunk-SW7LE4M3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-SW7LE4M3.js","../../src/config/validation.ts"],"names":[],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-SW7LE4M3.js","sourcesContent":[null,"/**\n * Zod validation schemas for SDK site configuration.\n *\n * These schemas are used to validate configuration fetched from\n * SDK sites before storing in the database.\n */\n\nimport { z } from 'zod';\nimport { blockCategoryEnum, fieldSchema, getBlockDefinition, type SdkCustomBlock, type FieldDefinition } from '@riverbankcms/blocks';\nimport type { RiverbankSiteConfig, BlockFieldOptionsMap, BlockFieldExtensionsMap, BlockFieldExtension } from './types';\n\n/**\n * Schema for SDK theme palette.\n * Maps token names to CSS color values.\n */\nexport const sdkThemePaletteSchema = z.record(z.string(), z.string());\n\n/**\n * Schema for SDK theme configuration.\n */\nexport const sdkThemeConfigSchema = z.object({\n  palette: sdkThemePaletteSchema,\n});\n\n/**\n * Schema for section background color options.\n */\nexport const sectionBackgroundSchema = z.object({\n  id: z.string(),\n  label: z.string(),\n  token: z.string(), // Reference to theme palette token\n});\n\n/**\n * Schema for section spacing values.\n */\nexport const sectionSpacingSchema = z.enum(['compact', 'default', 'spacious']);\n\n/**\n * Schema for container max-width values.\n */\nexport const containerMaxWidthSchema = z.enum(['narrow', 'default', 'wide', 'full']);\n\n/**\n * Schema for container alignment values.\n */\nexport const containerAlignmentSchema = z.enum(['left', 'center', 'right']);\n\n/**\n * Schema for section options configuration.\n */\nexport const sectionOptionsSchema = z.object({\n  backgroundColor: z.boolean().optional(),\n  backgroundImage: z.boolean().optional(),\n  backgroundGradient: z.boolean().optional(),\n  spacing: z.union([\n    z.array(sectionSpacingSchema),\n    z.boolean(),\n  ]).optional(),\n  textColor: z.boolean().optional(),\n}).optional();\n\n/**\n * Schema for container options configuration.\n */\nexport const containerOptionsSchema = z.object({\n  maxWidth: z.union([\n    z.array(containerMaxWidthSchema),\n    z.boolean(),\n  ]).optional(),\n  alignment: z.union([\n    z.array(containerAlignmentSchema),\n    z.boolean(),\n  ]).optional(),\n}).optional();\n\n/**\n * Schema for site style configuration.\n */\nexport const siteStyleConfigSchema = z.object({\n  sectionBackgrounds: z.array(sectionBackgroundSchema).optional(),\n  sectionOptions: sectionOptionsSchema,\n  containerOptions: containerOptionsSchema,\n}).optional();\n\n// ============================================================================\n// Data Loader Schemas\n// ============================================================================\n\nimport { SUPPORTED_LOADER_ENDPOINTS } from '../data/prefetchBlockData';\n\n/**\n * Whitelisted endpoints for SDK data loaders.\n *\n * These are the only CMS endpoints that can be called from config-based loaders.\n * This ensures SDK sites can only access safe, read-only public endpoints.\n *\n * Derived from SUPPORTED_LOADER_ENDPOINTS - the single source of truth.\n */\nexport const sdkLoaderEndpointSchema = z.enum(SUPPORTED_LOADER_ENDPOINTS);\n\n/**\n * A binding expression for dynamic loader params.\n *\n * @example\n * ```typescript\n * { $bind: { from: 'content.categoryId' } }\n * { $bind: { from: '$root.siteId' } }\n * { $bind: { from: 'content.limit', fallback: '10' } }\n * ```\n */\nexport const loaderParamBindingSchema = z.object({\n  $bind: z.object({\n    from: z.string().min(1, \"Binding path is required\"),\n    fallback: z.string().optional(),\n  }),\n});\n\n/**\n * A loader param value can be static or a binding expression.\n */\nexport const loaderParamValueSchema = z.union([\n  z.string(),\n  z.number(),\n  z.boolean(),\n  loaderParamBindingSchema,\n]);\n\n/**\n * Schema for config-based data loader.\n *\n * Config loaders execute server-side during loadPage() and are\n * restricted to whitelisted CMS endpoints.\n */\nexport const sdkConfigLoaderSchema = z.object({\n  endpoint: sdkLoaderEndpointSchema,\n  params: z.record(z.string(), loaderParamValueSchema),\n  mode: z.enum(['server', 'client']).default('server'),\n});\n\n/**\n * Schema for the dataLoaders field on custom blocks.\n * Validates the loader configuration and limits the number of loaders.\n */\nexport const sdkDataLoadersSchema = z.record(z.string(), sdkConfigLoaderSchema)\n  .refine(\n    (loaders) => Object.keys(loaders).length <= 5,\n    { message: \"Maximum 5 data loaders per block\" }\n  )\n  .optional();\n\n// ============================================================================\n// Custom Block Schema\n// ============================================================================\n\n/**\n * Schema for field select option.\n */\nexport const fieldSelectOptionSchema = z.object({\n  value: z.string().min(1, \"Option value is required\"),\n  label: z.string().min(1, \"Option label is required\"),\n});\n\n/**\n * Schema for per-field configuration within a block.\n */\nexport const blockFieldConfigSchema = z.object({\n  options: z.array(fieldSelectOptionSchema).min(1, \"At least one option is required\").optional(),\n});\n\n/**\n * Schema for per-block field options.\n *\n * Block IDs must be either 'block.*' (system blocks) or 'custom.*' (custom blocks).\n * Field IDs can be any valid identifier string.\n */\nexport const blockFieldOptionsSchema: z.ZodType<BlockFieldOptionsMap> = z.record(\n  z.string().regex(/^(block\\.|custom\\.)[a-z][a-z0-9-]*$/, {\n    message: \"Block ID must be 'block.*' or 'custom.*' format\",\n  }),\n  z.record(\n    z.string().min(1, \"Field ID is required\"),\n    blockFieldConfigSchema\n  )\n).optional() as z.ZodType<BlockFieldOptionsMap>;\n\n// ============================================================================\n// Block Field Extensions Schema\n// ============================================================================\n\n/**\n * Schema for block field extension configuration.\n *\n * Validates additional fields to be appended to a built-in block.\n * Includes refinement to ensure required fields have defaultValue.\n *\n * Note: Explicit type annotation required due to recursive fieldSchema complexity.\n */\nexport const blockFieldExtensionSchema: z.ZodType<BlockFieldExtension> = z.object({\n  fields: fieldSchema.array().min(1, \"At least one field is required\"),\n}).refine(\n  (data) => {\n    // All required fields must have a defaultValue\n    return data.fields.every((field: FieldDefinition) => {\n      if (!field.required) return true;\n      return field.defaultValue !== undefined;\n    });\n  },\n  {\n    message: \"Required fields must have a defaultValue to support existing blocks\",\n  }\n) as z.ZodType<BlockFieldExtension>;\n\n/**\n * Schema for block field extensions map.\n *\n * Block IDs must be system blocks (e.g., 'block.bodyText', 'block.hero').\n * Custom blocks ('custom.*') should define their fields directly, not via extensions.\n */\nexport const blockFieldExtensionsSchema: z.ZodType<BlockFieldExtensionsMap | undefined> = z.record(\n  z.string().regex(/^block\\.[a-z][a-zA-Z0-9]*$/, {\n    message: \"Block ID must be 'block.*' format (system blocks only)\",\n  }),\n  blockFieldExtensionSchema\n).optional() as z.ZodType<BlockFieldExtensionsMap | undefined>;\n\n/**\n * Validates that extended field IDs don't conflict with existing block fields.\n *\n * This validation should be called during config push to provide clear error messages.\n * Returns an array of conflict errors, or empty array if valid.\n *\n * @example\n * ```typescript\n * const conflicts = validateFieldIdConflicts(config.blockFieldExtensions);\n * if (conflicts.length > 0) {\n *   throw new Error(conflicts.map(c => c.message).join('\\n'));\n * }\n * ```\n */\nexport function validateFieldIdConflicts(\n  blockFieldExtensions?: BlockFieldExtensionsMap | null\n): { blockId: string; fieldId: string; message: string }[] {\n  if (!blockFieldExtensions) return [];\n\n  const conflicts: { blockId: string; fieldId: string; message: string }[] = [];\n\n  for (const [blockId, extension] of Object.entries(blockFieldExtensions)) {\n    const definition = getBlockDefinition(blockId);\n    if (!definition) {\n      conflicts.push({\n        blockId,\n        fieldId: '',\n        message: `Unknown block type: ${blockId}`,\n      });\n      continue;\n    }\n\n    // Get all existing field IDs from the block manifest\n    const existingFieldIds = new Set<string>();\n    const collectFieldIds = (fields: FieldDefinition[] | undefined) => {\n      if (!fields) return;\n      for (const field of fields) {\n        existingFieldIds.add(field.id);\n        // Also collect nested field IDs from groups, modals, repeaters, tab groups\n        if (field.type === 'group' || field.type === 'modal') {\n          collectFieldIds(field.schema?.fields);\n        } else if (field.type === 'repeater' && field.schema?.fields) {\n          collectFieldIds(field.schema.fields);\n        } else if (field.type === 'tabGroup') {\n          for (const tab of field.tabs ?? []) {\n            collectFieldIds(tab.fields);\n          }\n        }\n      }\n    };\n    collectFieldIds(definition.manifest.fields);\n\n    // Check for conflicts\n    for (const field of extension.fields) {\n      if (existingFieldIds.has(field.id)) {\n        conflicts.push({\n          blockId,\n          fieldId: field.id,\n          message: `Field ID \"${field.id}\" conflicts with existing field in ${blockId}`,\n        });\n      }\n    }\n  }\n\n  return conflicts;\n}\n\n/**\n * Schema for SDK custom block definitions.\n *\n * Validates custom blocks defined in riverbank.config.ts.\n * Reuses fieldSchema from @riverbankcms/blocks for field validation.\n *\n * Note: Explicit type annotation required due to recursive fieldSchema complexity.\n */\nexport const sdkCustomBlockSchema: z.ZodType<SdkCustomBlock> = z.object({\n  // Block ID must start with 'custom.'\n  id: z.string()\n    .min(8) // 'custom.' + at least 1 char\n    .regex(/^custom\\.[a-z][a-z0-9-]*$/, {\n      message: \"Block ID must start with 'custom.' followed by lowercase letters, numbers, or hyphens\",\n    }),\n  title: z.string().min(1, \"Title is required\"),\n  titleSource: z.string().optional(),\n  description: z.string().optional(),\n  category: blockCategoryEnum,\n  icon: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  // Reuse the exact field schema from @riverbankcms/blocks - all field types supported\n  fields: fieldSchema.array().min(1, \"Custom blocks must have at least one field\"),\n  // Data loaders for CMS endpoints\n  dataLoaders: sdkDataLoadersSchema,\n}).refine(\n  // Validate titleSource references a valid field if provided\n  (data) => {\n    if (!data.titleSource) return true;\n    return data.fields.some(f => f.id === data.titleSource);\n  },\n  {\n    message: \"titleSource must reference a valid field ID\",\n    path: [\"titleSource\"],\n  }\n) as z.ZodType<SdkCustomBlock>;\n\n/**\n * Schema for the complete SDK site configuration.\n *\n * Use this schema to validate configuration fetched from SDK sites\n * before storing in the database.\n *\n * @example\n * ```typescript\n * import { riverbankSiteConfigSchema } from '@riverbankcms/sdk/config/validation';\n *\n * const rawConfig = await response.json();\n * const config = riverbankSiteConfigSchema.parse(rawConfig);\n * ```\n */\nexport const riverbankSiteConfigSchema: z.ZodType<RiverbankSiteConfig> = z.object({\n  siteId: z.string().uuid(),\n  theme: sdkThemeConfigSchema.optional(),\n  styles: siteStyleConfigSchema,\n  customBlocks: z.array(sdkCustomBlockSchema)\n    .max(20, \"Maximum 20 custom blocks per site\")\n    .refine(\n      // Ensure unique block IDs\n      (blocks) => {\n        const ids = blocks.map(b => b.id);\n        return ids.length === new Set(ids).size;\n      },\n      { message: \"Block IDs must be unique\" }\n    )\n    .optional(),\n  blockFieldOptions: blockFieldOptionsSchema,\n  blockFieldExtensions: blockFieldExtensionsSchema,\n}).strict() as z.ZodType<RiverbankSiteConfig>;\n\n/**\n * Type inferred from the validation schema.\n * This should match the RiverbankSiteConfig type from ./types.ts\n */\nexport type ValidatedRiverbankSiteConfig = z.infer<typeof riverbankSiteConfigSchema>;\n\n/**\n * Type for a validated SDK custom block.\n */\nexport type ValidatedSdkCustomBlock = z.infer<typeof sdkCustomBlockSchema>;\n\n// ============================================================================\n// Compile-time type assertions\n//\n// These assertions ensure the Zod schemas stay in sync with the TypeScript types.\n// If the schema output diverges from the expected type, TypeScript will error here.\n// ============================================================================\n\n/** Asserts sdkCustomBlockSchema output matches SdkCustomBlock */\ntype _AssertSdkCustomBlockSchema = z.infer<typeof sdkCustomBlockSchema> extends SdkCustomBlock\n  ? SdkCustomBlock extends z.infer<typeof sdkCustomBlockSchema>\n    ? true\n    : never\n  : never;\n\n/** Asserts riverbankSiteConfigSchema output matches RiverbankSiteConfig */\ntype _AssertRiverbankSiteConfigSchema = z.infer<typeof riverbankSiteConfigSchema> extends RiverbankSiteConfig\n  ? RiverbankSiteConfig extends z.infer<typeof riverbankSiteConfigSchema>\n    ? true\n    : never\n  : never;\n\n// These assignments will fail to compile if the types don't match\nconst _checkSdkCustomBlock: _AssertSdkCustomBlockSchema = true;\nconst _checkRiverbankSiteConfig: _AssertRiverbankSiteConfigSchema = true;\n\n// Prevent unused variable warnings\nvoid _checkSdkCustomBlock;\nvoid _checkRiverbankSiteConfig;\n"]}

package/dist/server/chunk-W3K7LVPS.mjs

@@ -1,120 +0,0 @@
-// src/data/prefetchBlockData.ts
-import { prefetchBlockData as prefetchBlockDataCore } from "@riverbankcms/blocks/system/data";
-var SUPPORTED_LOADER_ENDPOINTS = [
-  "listPublishedEntries",
-  "getPublishedEntryPreview",
-  "listPublicEvents",
-  "getPublicFormById",
-  "getPublicBookingServices"
-];
-async function prefetchBlockData(page, context, client, options) {
-  const { customBlocks } = options ?? {};
-  const customBlockMap = new Map(
-    (customBlocks ?? []).map((block) => [block.id, block])
-  );
-  return prefetchBlockDataCore(page, context, {
-    apiClient: async ({ endpoint, params }) => {
-      if (!isSupportedEndpoint(endpoint)) {
-        throw new Error(
-          `Unsupported loader endpoint: ${endpoint}. SDK only supports: ${SUPPORTED_LOADER_ENDPOINTS.join(", ")}`
-        );
-      }
-      switch (endpoint) {
-        case "listPublishedEntries": {
-          const { siteId, type, orderBy, limit, stage, mode, entryIds } = params ?? {};
-          if (!siteId || !type) {
-            throw new Error("listPublishedEntries requires siteId and type params");
-          }
-          const parsedLimit = typeof limit === "string" ? Number.parseInt(limit, 10) : typeof limit === "number" ? limit : void 0;
-          const order = orderBy === "newest" || orderBy === "oldest" || orderBy === "title" || orderBy === "order" ? orderBy : void 0;
-          let parsedEntryIds;
-          if (mode === "manual" && Array.isArray(entryIds)) {
-            parsedEntryIds = entryIds.map((item) => {
-              if (typeof item === "object" && item !== null && "entryId" in item) {
-                return item.entryId;
-              }
-              if (typeof item === "string") {
-                return item;
-              }
-              return null;
-            }).filter((id) => id !== null);
-          }
-          return await client.getEntries({
-            siteId,
-            contentType: type,
-            limit: parsedLimit,
-            order,
-            preview: stage === "preview",
-            // Manual mode - pass entry IDs for hydration
-            mode: mode === "manual" ? "manual" : void 0,
-            entryIds: parsedEntryIds
-          });
-        }
-        case "getPublishedEntryPreview": {
-          const { siteId, type, slug } = params ?? {};
-          if (!siteId || !type || !slug) {
-            throw new Error("getPublishedEntryPreview requires siteId, type, and slug params");
-          }
-          return await client.getEntry({ siteId, contentType: type, slug });
-        }
-        case "listPublicEvents": {
-          const { siteId, limit, from, to, stage } = params ?? {};
-          if (!siteId) {
-            throw new Error("listPublicEvents requires siteId param");
-          }
-          const parsedLimit = typeof limit === "string" ? Number.parseInt(limit, 10) : typeof limit === "number" ? limit : void 0;
-          return await client.listPublicEvents({ siteId, limit: parsedLimit, from, to, stage });
-        }
-        case "getPublicFormById": {
-          const { formId } = params ?? {};
-          if (!formId) {
-            throw new Error("getPublicFormById requires formId param");
-          }
-          return await client.getPublicFormById({ formId });
-        }
-        case "getPublicBookingServices": {
-          const { siteId, ids } = params ?? {};
-          if (!siteId) {
-            throw new Error("getPublicBookingServices requires siteId param");
-          }
-          return await client.getPublicBookingServices({ siteId, ids });
-        }
-        default: {
-          const _exhaustive = endpoint;
-          throw new Error(`Unhandled endpoint: ${_exhaustive}`);
-        }
-      }
-    },
-    isValidEndpoint: isSupportedEndpoint,
-    onError: (error, { block, loader }) => {
-      console.warn("[prefetchBlockData] failed to prefetch block data", {
-        block,
-        loader,
-        error
-      });
-    },
-    // Provide custom block loader lookup for SDK custom blocks
-    getCustomBlockLoaders: (blockKind) => {
-      const customBlock = customBlockMap.get(blockKind);
-      if (!customBlock?.dataLoaders) return void 0;
-      const loaders = {};
-      for (const [key, loader] of Object.entries(customBlock.dataLoaders)) {
-        loaders[key] = {
-          endpoint: loader.endpoint,
-          params: loader.params,
-          mode: loader.mode
-        };
-      }
-      return loaders;
-    }
-  });
-}
-function isSupportedEndpoint(endpoint) {
-  return SUPPORTED_LOADER_ENDPOINTS.includes(endpoint);
-}
-
-export {
-  SUPPORTED_LOADER_ENDPOINTS,
-  prefetchBlockData
-};
-//# sourceMappingURL=chunk-W3K7LVPS.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/data/prefetchBlockData.ts"],"sourcesContent":["/**\n * SDK wrapper for block data prefetching.\n * Uses the shared core implementation from @riverbankcms/blocks with the SDK client.\n */\n\nimport type { BlockDataLoader, PageOutline, SdkCustomBlock } from '@riverbankcms/blocks';\nimport { prefetchBlockData as prefetchBlockDataCore } from '@riverbankcms/blocks/system/data';\nimport type { PrefetchContext, ResolvedBlockData } from '@riverbankcms/blocks/system/data';\nimport type { RiverbankClient } from '../client/types';\n\nexport type { PrefetchContext, ResolvedBlockData };\n\n/**\n * Supported loader endpoints for SDK data fetching.\n * Only these endpoints can be used in block data loaders when using the SDK.\n *\n * This is the SINGLE SOURCE OF TRUTH for whitelisted endpoints.\n * - Zod validation schema derives from this array\n * - TypeScript types derive from this array\n * - Runtime validation uses this array\n */\nexport const SUPPORTED_LOADER_ENDPOINTS = [\n  'listPublishedEntries',\n  'getPublishedEntryPreview',\n  'listPublicEvents',\n  'getPublicFormById',\n  'getPublicBookingServices',\n] as const;\n\n/**\n * Union type of all supported loader endpoints.\n * Derived from SUPPORTED_LOADER_ENDPOINTS array.\n */\nexport type SupportedLoaderEndpoint = typeof SUPPORTED_LOADER_ENDPOINTS[number];\n\n/**\n * Options for SDK block data prefetching.\n */\nexport type SdkPrefetchOptions = {\n  /**\n   * SDK custom blocks from site config.\n   * Used to look up data loaders for custom.* blocks.\n   */\n  customBlocks?: SdkCustomBlock[];\n};\n\n/**\n * Prefetch block data for SDK-based applications.\n * Maps loader endpoints to corresponding SDK client methods.\n *\n * Supports both system blocks and SDK custom blocks with data loaders.\n *\n * @example\n * ```typescript\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { prefetchBlockData } from '@riverbankcms/sdk/data';\n *\n * const client = createRiverbankClient({ apiKey, baseUrl });\n * const page = await client.getPage({ siteId, path: '/' });\n *\n * // Basic usage (system blocks only)\n * const blockData = await prefetchBlockData(page.outline, {\n *   siteId: page.siteId,\n *   pageId: page.id,\n * }, client);\n *\n * // With custom blocks from SDK config\n * const blockData = await prefetchBlockData(page.outline, context, client, {\n *   customBlocks: site.sdkConfig?.customBlocks,\n * });\n * ```\n */\nexport async function prefetchBlockData(\n  page: PageOutline,\n  context: PrefetchContext,\n  client: RiverbankClient,\n  options?: SdkPrefetchOptions,\n): Promise<ResolvedBlockData> {\n  const { customBlocks } = options ?? {};\n\n  // Build lookup map for custom block loaders\n  // Key is string (blockKind from page) matching block.id (custom.xxx)\n  const customBlockMap = new Map<string, SdkCustomBlock>(\n    (customBlocks ?? []).map((block) => [block.id as string, block])\n  );\n\n  return prefetchBlockDataCore(page, context, {\n    apiClient: async ({ endpoint, params }) => {\n      // Only support whitelisted loader endpoints\n      if (!isSupportedEndpoint(endpoint)) {\n        throw new Error(\n          `Unsupported loader endpoint: ${endpoint}. ` +\n          `SDK only supports: ${SUPPORTED_LOADER_ENDPOINTS.join(', ')}`\n        );\n      }\n\n      // Map endpoint to SDK client method\n      switch (endpoint) {\n        case 'listPublishedEntries': {\n          const { siteId, type, orderBy, limit, stage, mode, entryIds } = params ?? {};\n          if (!siteId || !type) {\n            throw new Error('listPublishedEntries requires siteId and type params');\n          }\n\n          // Parse limit if provided (can come as string from bindings)\n          const parsedLimit = typeof limit === 'string'\n            ? Number.parseInt(limit, 10)\n            : typeof limit === 'number'\n              ? limit\n              : undefined;\n\n          // Map orderBy to order param (matching embed block field values)\n          const order = (orderBy === 'newest' || orderBy === 'oldest' || orderBy === 'title' || orderBy === 'order')\n            ? orderBy as 'newest' | 'oldest' | 'title' | 'order'\n            : undefined;\n\n          // Extract entry IDs for manual mode\n          // entryIds comes from binding to entries field which contains { entryId: \"uuid\" } objects\n          let parsedEntryIds: string[] | undefined;\n          if (mode === 'manual' && Array.isArray(entryIds)) {\n            parsedEntryIds = entryIds\n              .map((item: unknown) => {\n                if (typeof item === 'object' && item !== null && 'entryId' in item) {\n                  return (item as { entryId: string }).entryId;\n                }\n                // Also support direct string IDs\n                if (typeof item === 'string') {\n                  return item;\n                }\n                return null;\n              })\n              .filter((id): id is string => id !== null);\n          }\n\n          return await client.getEntries({\n            siteId,\n            contentType: type,\n            limit: parsedLimit,\n            order,\n            preview: stage === 'preview',\n            // Manual mode - pass entry IDs for hydration\n            mode: mode === 'manual' ? 'manual' : undefined,\n            entryIds: parsedEntryIds,\n          });\n        }\n\n        case 'getPublishedEntryPreview': {\n          const { siteId, type, slug } = params ?? {};\n          if (!siteId || !type || !slug) {\n            throw new Error('getPublishedEntryPreview requires siteId, type, and slug params');\n          }\n          return await client.getEntry({ siteId, contentType: type, slug });\n        }\n        case 'listPublicEvents': {\n          const { siteId, limit, from, to, stage } = params ?? {};\n          if (!siteId) {\n            throw new Error('listPublicEvents requires siteId param');\n          }\n          const parsedLimit =\n            typeof limit === 'string'\n              ? Number.parseInt(limit, 10)\n              : typeof limit === 'number'\n                ? limit\n                : undefined;\n          return await client.listPublicEvents({ siteId, limit: parsedLimit, from, to, stage });\n        }\n        case 'getPublicFormById': {\n          const { formId } = params ?? {};\n          if (!formId) {\n            throw new Error('getPublicFormById requires formId param');\n          }\n          return await client.getPublicFormById({ formId });\n        }\n        case 'getPublicBookingServices': {\n          const { siteId, ids } = params ?? {};\n          if (!siteId) {\n            throw new Error('getPublicBookingServices requires siteId param');\n          }\n          return await client.getPublicBookingServices({ siteId, ids });\n        }\n\n        default: {\n          // TypeScript should never reach here due to isSupportedEndpoint check\n          const _exhaustive: never = endpoint;\n          throw new Error(`Unhandled endpoint: ${_exhaustive}`);\n        }\n      }\n    },\n    isValidEndpoint: isSupportedEndpoint,\n    onError: (error, { block, loader }) => {\n      console.warn('[prefetchBlockData] failed to prefetch block data', {\n        block,\n        loader,\n        error,\n      });\n    },\n    // Provide custom block loader lookup for SDK custom blocks\n    getCustomBlockLoaders: (blockKind): Record<string, BlockDataLoader> | undefined => {\n      const customBlock = customBlockMap.get(blockKind);\n      if (!customBlock?.dataLoaders) return undefined;\n\n      // Convert SdkConfigLoader to BlockDataLoader\n      // SdkConfigLoader.endpoint is SdkLoaderEndpoint (string union) -> string\n      // SdkConfigLoader.params is Record<string, LoaderParamValue> -> Record<string, unknown>\n      // Both are structurally compatible via covariance\n      const loaders: Record<string, BlockDataLoader> = {};\n      for (const [key, loader] of Object.entries(customBlock.dataLoaders)) {\n        loaders[key] = {\n          endpoint: loader.endpoint,\n          params: loader.params,\n          mode: loader.mode,\n        };\n      }\n      return loaders;\n    },\n  });\n}\n\n/**\n * Type guard for supported loader endpoints\n */\nfunction isSupportedEndpoint(endpoint: string): endpoint is SupportedLoaderEndpoint {\n  return SUPPORTED_LOADER_ENDPOINTS.includes(endpoint as SupportedLoaderEndpoint);\n}\n"],"mappings":"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","names":[]}

package/dist/server/chunk-YHEZMVTS.js

@@ -1,122 +0,0 @@
-"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; }// src/rendering/components/Page.tsx
-var _blocks = require('@riverbankcms/blocks');
-var _jsxruntime = require('react/jsx-runtime');
-function Page({
-  page,
-  theme,
-  themeTokens: providedTokens,
-  siteId,
-  resolvedData,
-  routeMap,
-  wrapBlock,
-  registry,
-  usePlaceholders = false,
-  blockOverrides,
-  sdkConfig,
-  dataContext
-}) {
-  const baseTokens = _nullishCoalesce(providedTokens, () => ( _blocks.buildThemeRuntime.call(void 0, theme).tokens));
-  const themeTokens = _optionalChain([sdkConfig, 'optionalAccess', _ => _.theme, 'optionalAccess', _2 => _2.palette]) ? { ...baseTokens, palette: { ...baseTokens.palette, ...sdkConfig.theme.palette } } : baseTokens;
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _blocks.PageRenderer,
-    {
-      theme,
-      page,
-      themeTokens,
-      usePlaceholders,
-      dataContext: {
-        siteId,
-        resolvedData,
-        routes: routeMap,
-        occurrenceContext: _nullishCoalesce(_optionalChain([dataContext, 'optionalAccess', _3 => _3.occurrenceContext]), () => ( null)),
-        contentEntry: _nullishCoalesce(_optionalChain([dataContext, 'optionalAccess', _4 => _4.contentEntry]), () => ( null))
-      },
-      routeMap,
-      wrapBlock,
-      registry,
-      blockOverrides,
-      sdkConfig
-    }
-  );
-}
-
-// src/rendering/components/Layout.tsx
-
-var _siterenderer = require('@riverbankcms/site-renderer');
-
-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 = _blocks.buildThemeRuntime.call(void 0, theme);
-  const menu = _siterenderer.selectPrimaryMenu.call(void 0, navigation);
-  const menuViewModel = _siterenderer.buildMenuViewModel.call(void 0, menu);
-  const logoViewModel = _siterenderer.buildLogoViewModel.call(void 0, _nullishCoalesce(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 = _blocks.renderBlock.call(void 0, _blocks.siteHeaderManifest, headerContent, {
-      theme: themeRuntime.tokens,
-      themeConfig: themeWithVariant,
-      viewModelOverrides
-    });
-  } else if (typeof header === "function") {
-    headerElement = header(headerData);
-  }
-  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _jsxruntime.Fragment, { children: [
-    headerElement,
-    children,
-    footer && _blocks.renderBlock.call(void 0, _blocks.siteFooterManifest, layout.footer, {
-      theme: themeRuntime.tokens,
-      themeConfig: theme,
-      viewModelOverrides
-    })
-  ] });
-}
-
-
-
-
-exports.Page = Page; exports.Layout = Layout;
-//# sourceMappingURL=chunk-YHEZMVTS.js.map

package/dist/server/chunk-YHEZMVTS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-YHEZMVTS.js","../../src/rendering/components/Page.tsx","../../src/rendering/components/Layout.tsx"],"names":["buildThemeRuntime"],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-YHEZMVTS.js","sourcesContent":[null,"/**\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  /**\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  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      }}\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 { selectPrimaryMenu, buildMenuViewModel, buildLogoViewModel } from '@riverbankcms/site-renderer';\nimport type { RiverbankClient, SiteResponse } from '../../client/types';\n\nexport type HeaderData = {\n  menu: ReturnType<typeof buildMenuViewModel>;\n  logo: ReturnType<typeof buildLogoViewModel>;\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 using proper helpers from @riverbankcms/site-renderer\n  const menu = selectPrimaryMenu(navigation);\n  const menuViewModel = buildMenuViewModel(menu);\n  const logoViewModel = buildLogoViewModel(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"]}