@riverbankcms/sdk 0.4.3 → 0.5.1

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":[]}