@riverbankcms/sdk 0.7.0 → 0.7.3

package/dist/server/next.d.ts

@@ -1,11 +1,11 @@
 import { ReactNode, ComponentType } from 'react';
-import { R as RiverbankClient } from './types-BvcJU7zk.js';
+import { R as RiverbankClient } from './types-BRQyLrQU.js';
 import { R as RiverbankSiteConfig } from './types-DLBhEPSt.js';
-import { B as BlockOverrides } from './loadPage-DP3nrHBi.js';
+import { B as BlockOverrides } from './loadPage-BmYJCe_V.js';
 import './schema-Z6-afHJG.js';
-import { M as Metadata } from './index-BTwWvSBu.js';
-import { b as LoadContentResult } from './loadContent-DmgpFcFC.js';
-import './types-CVykEqXN.js';
+import { M as Metadata } from './index-C9Ra8dza.js';
+import { b as LoadContentResult } from './loadContent-D7LQwI0o.js';
+import './types-Dt98DeYa.js';
 import '@riverbankcms/ai';
 import 'zod';
 import './link-DjxLyC82.js';
@@ -271,4 +271,162 @@ interface CreateCatchAllPageResult {
  */
 declare function createCatchAllPage(options: CreateCatchAllPageOptions): CreateCatchAllPageResult;
 
-export { type CatchAllContext, type CatchAllPageProps, type CreateCatchAllPageOptions, type CreateCatchAllPageResult, createCatchAllPage };
+/**
+ * Static params generation for Next.js SSG
+ *
+ * Provides helpers for generating static params from published CMS routes.
+ *
+ * @example
+ * ```tsx
+ * // app/[[...slug]]/page.tsx
+ * import { generateAllStaticParams } from '@riverbankcms/sdk/next';
+ *
+ * export { generateAllStaticParams as generateStaticParams };
+ * ```
+ */
+/**
+ * Environment variable validation result
+ */
+type StaticParamsEnvResult = {
+    valid: true;
+    config: {
+        apiKey: string;
+        siteId: string;
+        baseUrl: string;
+    };
+} | {
+    valid: false;
+    missingVars: string[];
+};
+/**
+ * Validate that all required environment variables are set.
+ *
+ * Required env vars:
+ * - RIVERBANK_API_KEY: API key for published content
+ * - RIVERBANK_SITE_ID: Site ID
+ * - NEXT_PUBLIC_DASHBOARD_URL: Dashboard API URL
+ *
+ * @returns Validation result with config or missing vars
+ */
+declare function validateStaticParamsEnv(): StaticParamsEnvResult;
+/**
+ * Convert a route path to a Next.js slug array.
+ *
+ * @param path - The route path (e.g., '/about', '/blog/post')
+ * @returns The slug array for Next.js catch-all route
+ *
+ * @example
+ * ```ts
+ * pathToSlugArray('/')           // []
+ * pathToSlugArray('/about')      // ['about']
+ * pathToSlugArray('/blog/post')  // ['blog', 'post']
+ * ```
+ */
+declare function pathToSlugArray(path: string): string[];
+/**
+ * Generate static params for all published routes.
+ *
+ * This function fetches all published routes from the CMS and converts them
+ * to the static params format expected by Next.js catch-all routes.
+ *
+ * Requires environment variables:
+ * - RIVERBANK_API_KEY: API key for published content
+ * - RIVERBANK_SITE_ID: Site ID
+ * - NEXT_PUBLIC_DASHBOARD_URL: Dashboard API URL
+ *
+ * @throws Error if required env vars are missing (prevents silent empty SSG in CI)
+ * @returns Array of static params objects for Next.js
+ *
+ * @example
+ * ```tsx
+ * // app/[[...slug]]/page.tsx
+ * import { generateAllStaticParams } from '@riverbankcms/sdk/next';
+ *
+ * export { generateAllStaticParams as generateStaticParams };
+ *
+ * // Or with custom logic:
+ * export async function generateStaticParams() {
+ *   const params = await generateAllStaticParams();
+ *   // Filter or modify params as needed
+ *   return params.filter(p => !p.slug.includes('private'));
+ * }
+ * ```
+ */
+declare function generateAllStaticParams(): Promise<{
+    slug: string[];
+}[]>;
+
+/**
+ * Next.js integration helpers for Riverbank CMS SDK.
+ *
+ * Provides opinionated factories for common Next.js patterns, reducing
+ * boilerplate while maintaining full customizability through escape hatches.
+ *
+ * @example Basic catch-all page
+ * ```tsx
+ * // src/app/[[...slug]]/page.tsx
+ * import { createCatchAllPage } from '@riverbankcms/sdk/next';
+ * import { getRiverbankClient } from '@/lib/builder-client';
+ * import config from '@/riverbank.config';
+ *
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient: getRiverbankClient,
+ *   config,
+ * });
+ *
+ * export default Page;
+ * export { generateMetadata };
+ * ```
+ *
+ * @example With customization
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient,
+ *   config,
+ *   blockOverrides: { hero: MyCustomHero },
+ *   beforeRender: async () => {
+ *     if (process.env.MAINTENANCE_MODE === 'true') {
+ *       return <MaintenancePage />;
+ *     }
+ *     return null;
+ *   },
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * ISR revalidation duration in seconds for production mode.
+ * 5 minutes provides a good balance between freshness and performance.
+ */
+declare const ISR_REVALIDATE_SECONDS = 300;
+interface ISRConfig {
+    /**
+     * Revalidation interval in seconds.
+     * - 0: Dynamic rendering (no caching) - used in preview mode
+     * - 300: 5 minute ISR - used in production mode
+     */
+    revalidate: number | false;
+    /**
+     * Whether the current environment is in preview mode.
+     * Useful for conditional rendering or data fetching behavior.
+     */
+    isPreview: boolean;
+}
+/**
+ * Get ISR configuration based on the current environment.
+ *
+ * @example
+ * ```tsx
+ * // app/[[...slug]]/page.tsx
+ * import { getISRConfig } from '@riverbankcms/sdk/next';
+ *
+ * export const revalidate = getISRConfig().revalidate;
+ * ```
+ *
+ * @returns ISR configuration with revalidate interval and preview flag
+ */
+declare function getISRConfig(): ISRConfig;
+
+export { type CatchAllContext, type CatchAllPageProps, type CreateCatchAllPageOptions, type CreateCatchAllPageResult, type ISRConfig, ISR_REVALIDATE_SECONDS, type StaticParamsEnvResult, createCatchAllPage, generateAllStaticParams, getISRConfig, pathToSlugArray, validateStaticParamsEnv };

package/dist/server/next.js

@@ -4,6 +4,12 @@
 var _chunkBNQV3PXPjs = require('./chunk-BNQV3PXP.js');
 
 
+var _chunk2IZ6S225js = require('./chunk-2IZ6S225.js');
+
+
+var _chunkVLXTNB2Cjs = require('./chunk-VLXTNB2C.js');
+
+
 
 
 var _chunkJWRNMNWIjs = require('./chunk-JWRNMNWI.js');
@@ -13,14 +19,12 @@ var _chunkT26N3P26js = require('./chunk-T26N3P26.js');
 require('./chunk-7UPVCT3K.js');
 require('./chunk-RVDS7VSP.js');
 require('./chunk-YYO3RIFO.js');
-
-
-var _chunkDGUM43GVjs = require('./chunk-DGUM43GV.js');
+require('./chunk-4CV4JOE5.js');
 
 // src/next/catch-all.tsx
+var _navigation = require('next/navigation');
 var _jsxruntime = require('react/jsx-runtime');
-var { notFound } = _chunkDGUM43GVjs.__require.call(void 0, "next/navigation");
-function isPreviewMode() {
+function isPreviewMode2() {
   return process.env.RIVERBANK_PREVIEW_MODE === "true";
 }
 function slugToPath(slug) {
@@ -43,7 +47,7 @@ function createCatchAllPage(options) {
       _nullishCoalesce(searchParamsPromise, () => ( Promise.resolve({})))
     ]);
     const path = slugToPath(slug);
-    const preview = isPreviewMode();
+    const preview = isPreviewMode2();
     const client = getClient();
     let content;
     try {
@@ -55,7 +59,7 @@ function createCatchAllPage(options) {
       });
     } catch (error) {
       console.debug("[createCatchAllPage] Failed to load content for path:", path, error);
-      return notFound();
+      return _navigation.notFound.call(void 0, );
     }
     if (beforeRender) {
       const intercepted = await beforeRender({ content, path, preview, searchParams });
@@ -77,7 +81,7 @@ function createCatchAllPage(options) {
       );
     } else if (_chunkJWRNMNWIjs.isEntryContent.call(void 0, content)) {
       if (!content.templatePage) {
-        return notFound();
+        return _navigation.notFound.call(void 0, );
       }
       rendered = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
         _chunkT26N3P26js.Page,
@@ -93,7 +97,7 @@ function createCatchAllPage(options) {
         }
       );
     } else {
-      return notFound();
+      return _navigation.notFound.call(void 0, );
     }
     return Wrapper ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, Wrapper, { children: rendered }) : rendered;
   }
@@ -103,7 +107,7 @@ function createCatchAllPage(options) {
       _nullishCoalesce(searchParamsPromise, () => ( Promise.resolve({})))
     ]);
     const path = slugToPath(slug);
-    const preview = isPreviewMode();
+    const preview = isPreviewMode2();
     try {
       const content = await _chunkJWRNMNWIjs.loadContent.call(void 0, {
         client: getClient(),
@@ -145,6 +149,70 @@ function createCatchAllPage(options) {
   };
 }
 
+// src/rendering/hooks/usePage.ts
+var _react = require('react');
+
+// src/rendering/hooks/useContent.ts
+
+
+// src/next/static-params.ts
+function validateStaticParamsEnv() {
+  const apiKey = process.env.RIVERBANK_API_KEY;
+  const siteId = process.env.RIVERBANK_SITE_ID;
+  const baseUrl = process.env.NEXT_PUBLIC_DASHBOARD_URL;
+  const missingVars = [];
+  if (!apiKey) missingVars.push("RIVERBANK_API_KEY");
+  if (!siteId) missingVars.push("RIVERBANK_SITE_ID");
+  if (!baseUrl) missingVars.push("NEXT_PUBLIC_DASHBOARD_URL");
+  if (missingVars.length > 0) {
+    return { valid: false, missingVars };
+  }
+  return {
+    valid: true,
+    config: { apiKey, siteId, baseUrl }
+  };
+}
+function pathToSlugArray(path) {
+  if (path === "/") return [];
+  return path.slice(1).split("/");
+}
+async function generateAllStaticParams() {
+  const envResult = validateStaticParamsEnv();
+  if (!envResult.valid) {
+    throw new Error(
+      `[Riverbank] generateAllStaticParams requires env vars: ${envResult.missingVars.join(", ")}. This error prevents accidentally deploying with zero static pages.`
+    );
+  }
+  const { apiKey, siteId: _siteId, baseUrl } = envResult.config;
+  const _client = _chunkVLXTNB2Cjs.createRiverbankClient.call(void 0, {
+    apiKey,
+    baseUrl,
+    // Disable caching for build-time fetches
+    cache: { enabled: false },
+    // Disable resilience for build-time fetches (want fast failure)
+    resilience: { enabled: false }
+  });
+  console.warn(
+    "[Riverbank] generateAllStaticParams: getAllPublishedRoutes API not yet implemented. Pages will be generated on-demand with ISR."
+  );
+  return [{ slug: [] }];
+}
+
+// src/next/index.ts
+var ISR_REVALIDATE_SECONDS = 300;
+function getISRConfig() {
+  const preview = _chunk2IZ6S225js.isPreviewMode.call(void 0, );
+  return {
+    revalidate: preview ? 0 : ISR_REVALIDATE_SECONDS,
+    isPreview: preview
+  };
+}
+
+
+
+
+
+
 
-exports.createCatchAllPage = createCatchAllPage;
+exports.ISR_REVALIDATE_SECONDS = ISR_REVALIDATE_SECONDS; exports.createCatchAllPage = createCatchAllPage; exports.generateAllStaticParams = generateAllStaticParams; exports.getISRConfig = getISRConfig; exports.pathToSlugArray = pathToSlugArray; exports.validateStaticParamsEnv = validateStaticParamsEnv;
 //# sourceMappingURL=next.js.map

package/dist/server/next.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/next.js","../../src/next/catch-all.tsx"],"names":["Page"],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/next.js","sourcesContent":[null,"/**\n * Next.js catch-all page factory for Riverbank CMS.\n *\n * Provides a simple, opinionated way to render CMS content in Next.js catch-all routes.\n * Reduces typical page.tsx boilerplate from ~160 lines to ~10 lines.\n *\n * @example\n * ```tsx\n * // src/app/[[...slug]]/page.tsx\n * import { createCatchAllPage } from '@riverbankcms/sdk/next';\n * import { getRiverbankClient } from '@/lib/builder-client';\n * import config from '@/riverbank.config';\n *\n * const { Page, generateMetadata } = createCatchAllPage({\n *   getClient: getRiverbankClient,\n *   config,\n *   blockOverrides: { hero: MyCustomHero },\n * });\n *\n * export default Page;\n * export { generateMetadata };\n * ```\n */\n\n// Note: next is a peerDependency - this module only works in Next.js projects.\n// We use require() with a type cast because Next.js's notFound() is typed as () => never\n// but TypeScript doesn't infer this from the dynamic import, causing false\n// \"unreachable code\" warnings without explicit type information.\nconst { notFound } = require('next/navigation') as { notFound: () => never };\n\nimport {\n  loadContent,\n  isPageContent,\n  isEntryContent,\n} from '../rendering/helpers/loadContent';\nimport type { LoadContentResult } from '../rendering/helpers/loadContent';\nimport { Page as PageComponent } from '../rendering/components/Page';\nimport {\n  generatePageMetadata,\n  generatePreviewMetadata,\n  type Metadata,\n} from '../metadata/generatePageMetadata';\nimport type {\n  CreateCatchAllPageOptions,\n  CatchAllPageProps,\n  CreateCatchAllPageResult,\n} from './types';\n\n/**\n * Detect preview mode from environment variable.\n *\n * Sites can enable preview mode by setting:\n * ```\n * RIVERBANK_PREVIEW_MODE=true\n * ```\n *\n * This is typically set in preview/staging environments to fetch\n * draft content instead of published content.\n */\nfunction isPreviewMode(): boolean {\n  return process.env.RIVERBANK_PREVIEW_MODE === 'true';\n}\n\n/**\n * Convert URL slug segments to a path string.\n *\n * @example\n * ```\n * slugToPath(undefined)        // '/'\n * slugToPath([])               // '/'\n * slugToPath(['about'])        // '/about'\n * slugToPath(['blog', 'post']) // '/blog/post'\n * ```\n */\nfunction slugToPath(slug?: string[]): string {\n  if (!slug || slug.length === 0) return '/';\n  return '/' + slug.join('/');\n}\n\n/**\n * Factory function to create a Next.js catch-all page component and metadata generator.\n *\n * This provides a simple, opinionated setup for rendering Riverbank CMS content\n * in external SDK sites. It handles:\n *\n * - Page and content entry routing\n * - Preview mode detection (via `RIVERBANK_PREVIEW_MODE` env var)\n * - SEO metadata generation\n * - Block overrides for custom components\n * - 404 handling for missing content\n *\n * ## Escape Hatches\n *\n * For customization beyond the defaults, use these options:\n *\n * - `beforeRender`: Intercept before rendering (maintenance mode, access control)\n * - `customMetadata`: Full control over SEO metadata\n * - `wrapper`: Wrap all content (analytics, error boundaries)\n *\n * For maximum control, use the lower-level helpers directly:\n * - `loadContent()` from `@riverbankcms/sdk/rendering`\n * - `Page` component from `@riverbankcms/sdk/rendering`\n * - `generatePageMetadata()` from `@riverbankcms/sdk/metadata`\n *\n * @param options - Configuration options\n * @returns Object with `Page` component and `generateMetadata` function\n *\n * @example Basic usage\n * ```tsx\n * const { Page, generateMetadata } = createCatchAllPage({\n *   getClient: getRiverbankClient,\n *   config,\n * });\n *\n * export default Page;\n * export { generateMetadata };\n * ```\n *\n * @example With maintenance mode\n * ```tsx\n * const { Page, generateMetadata } = createCatchAllPage({\n *   getClient,\n *   config,\n *   beforeRender: async () => {\n *     if (process.env.MAINTENANCE_MODE === 'true') {\n *       return <MaintenancePage />;\n *     }\n *     return null;\n *   },\n * });\n * ```\n */\nexport function createCatchAllPage(\n  options: CreateCatchAllPageOptions\n): CreateCatchAllPageResult {\n  const {\n    getClient,\n    config,\n    blockOverrides,\n    siteUrl,\n    beforeRender,\n    customMetadata,\n    wrapper: Wrapper,\n  } = options;\n\n  /**\n   * Main page component that loads and renders CMS content.\n   */\n  async function Page({ params, searchParams: searchParamsPromise }: CatchAllPageProps): Promise<React.ReactNode> {\n    const [{ slug }, searchParams] = await Promise.all([\n      params,\n      searchParamsPromise ?? Promise.resolve({}),\n    ]);\n    const path = slugToPath(slug);\n    const preview = isPreviewMode();\n    const client = getClient();\n\n    // Load content (page or entry)\n    let content: LoadContentResult;\n    try {\n      content = await loadContent({\n        client,\n        siteId: config.siteId,\n        path,\n        preview,\n      });\n    } catch (error) {\n      // Log the error for debugging - could be a network error, auth failure, etc.\n      // We treat all errors as \"not found\" since the page can't be rendered\n      console.debug('[createCatchAllPage] Failed to load content for path:', path, error);\n      return notFound();\n    }\n\n    // ESCAPE HATCH: beforeRender for maintenance mode, access control, etc.\n    if (beforeRender) {\n      const intercepted = await beforeRender({ content, path, preview, searchParams });\n      if (intercepted !== null) {\n        return Wrapper ? <Wrapper>{intercepted}</Wrapper> : intercepted;\n      }\n    }\n\n    let rendered: React.ReactNode;\n\n    // Render page content\n    if (isPageContent(content)) {\n      rendered = (\n        <PageComponent\n          page={content.page}\n          theme={content.theme}\n          siteId={content.siteId}\n          resolvedData={content.resolvedData}\n          blockOverrides={blockOverrides}\n        />\n      );\n    }\n    // Render entry content with template\n    else if (isEntryContent(content)) {\n      // Entries without template pages should 404\n      if (!content.templatePage) {\n        return notFound();\n      }\n\n      rendered = (\n        <PageComponent\n          page={content.templatePage}\n          theme={content.theme}\n          siteId={content.siteId}\n          resolvedData={content.resolvedData}\n          blockOverrides={blockOverrides}\n          dataContext={{\n            contentEntry: content.dataContext.contentEntry,\n          }}\n        />\n      );\n    }\n    // Unexpected content type - should never happen\n    else {\n      return notFound();\n    }\n\n    return Wrapper ? <Wrapper>{rendered}</Wrapper> : rendered;\n  }\n\n  /**\n   * Generate SEO metadata for the page.\n   */\n  async function generateMetadataFn({ params, searchParams: searchParamsPromise }: CatchAllPageProps): Promise<Metadata> {\n    const [{ slug }, searchParams] = await Promise.all([\n      params,\n      searchParamsPromise ?? Promise.resolve({}),\n    ]);\n    const path = slugToPath(slug);\n    const preview = isPreviewMode();\n\n    try {\n      const content = await loadContent({\n        client: getClient(),\n        siteId: config.siteId,\n        path,\n        preview,\n      });\n\n      // ESCAPE HATCH: Custom metadata generation\n      if (customMetadata) {\n        return customMetadata({ content, path, preview, searchParams });\n      }\n\n      // Resolve site URL (use config URLs as fallback)\n      const resolvedUrl =\n        siteUrl ?? (preview ? config.previewUrl : config.liveUrl) ?? '';\n\n      // Warn if no site URL is configured - OG/Twitter tags require absolute URLs\n      if (!resolvedUrl) {\n        console.warn(\n          '[createCatchAllPage] No siteUrl configured. OpenGraph and Twitter tags will have relative URLs which may cause social sharing previews to fail. ' +\n          'Set siteUrl option, or config.liveUrl/config.previewUrl in your riverbank.config.'\n        );\n      }\n\n      // Build page object for metadata\n      // For entries, we use metaTitle/metaDescription; purpose is used as description fallback\n      const page = isPageContent(content)\n        ? content.page\n        : isEntryContent(content)\n          ? {\n              name: content.entry.metaTitle ?? content.entry.title,\n              purpose: content.entry.metaDescription ?? undefined,\n            }\n          : { name: 'Page' };\n\n      // Use preview metadata (noindex) in preview mode\n      const metadataGenerator = preview\n        ? generatePreviewMetadata\n        : generatePageMetadata;\n\n      // Use site data from loadContent result (no duplicate API call needed)\n      return metadataGenerator({\n        page,\n        site: content.site,\n        path,\n        siteUrl: resolvedUrl,\n      });\n    } catch (error) {\n      // Log the error for debugging purposes\n      console.debug('[createCatchAllPage] Failed to generate metadata for path:', path, error);\n      // Return minimal metadata on error - page will handle the actual 404\n      return {\n        title: 'Page Not Found',\n        robots: { index: false, follow: false },\n      };\n    }\n  }\n\n  return {\n    Page,\n    generateMetadata: generateMetadataFn,\n  };\n}\n"]}
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/next.js","../../src/next/catch-all.tsx","../../src/rendering/hooks/usePage.ts","../../src/rendering/hooks/useContent.ts","../../src/next/static-params.ts","../../src/next/index.ts"],"names":["isPreviewMode","Page"],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/next.js","sourcesContent":[null,"/**\n * Next.js catch-all page factory for Riverbank CMS.\n *\n * Provides a simple, opinionated way to render CMS content in Next.js catch-all routes.\n * Reduces typical page.tsx boilerplate from ~160 lines to ~10 lines.\n *\n * @example\n * ```tsx\n * // src/app/[[...slug]]/page.tsx\n * import { createCatchAllPage } from '@riverbankcms/sdk/next';\n * import { getRiverbankClient } from '@/lib/builder-client';\n * import config from '@/riverbank.config';\n *\n * const { Page, generateMetadata } = createCatchAllPage({\n *   getClient: getRiverbankClient,\n *   config,\n *   blockOverrides: { hero: MyCustomHero },\n * });\n *\n * export default Page;\n * export { generateMetadata };\n * ```\n */\n\n// Note: next is a peerDependency - this module only works in Next.js projects.\nimport { notFound } from 'next/navigation';\n\nimport {\n  loadContent,\n  isPageContent,\n  isEntryContent,\n} from '../rendering/helpers/loadContent';\nimport type { LoadContentResult } from '../rendering/helpers/loadContent';\nimport { Page as PageComponent } from '../rendering/components/Page';\nimport {\n  generatePageMetadata,\n  generatePreviewMetadata,\n  type Metadata,\n} from '../metadata/generatePageMetadata';\nimport type {\n  CreateCatchAllPageOptions,\n  CatchAllPageProps,\n  CreateCatchAllPageResult,\n} from './types';\n\n/**\n * Detect preview mode from environment variable.\n *\n * Sites can enable preview mode by setting:\n * ```\n * RIVERBANK_PREVIEW_MODE=true\n * ```\n *\n * This is typically set in preview/staging environments to fetch\n * draft content instead of published content.\n */\nfunction isPreviewMode(): boolean {\n  return process.env.RIVERBANK_PREVIEW_MODE === 'true';\n}\n\n/**\n * Convert URL slug segments to a path string.\n *\n * @example\n * ```\n * slugToPath(undefined)        // '/'\n * slugToPath([])               // '/'\n * slugToPath(['about'])        // '/about'\n * slugToPath(['blog', 'post']) // '/blog/post'\n * ```\n */\nfunction slugToPath(slug?: string[]): string {\n  if (!slug || slug.length === 0) return '/';\n  return '/' + slug.join('/');\n}\n\n/**\n * Factory function to create a Next.js catch-all page component and metadata generator.\n *\n * This provides a simple, opinionated setup for rendering Riverbank CMS content\n * in external SDK sites. It handles:\n *\n * - Page and content entry routing\n * - Preview mode detection (via `RIVERBANK_PREVIEW_MODE` env var)\n * - SEO metadata generation\n * - Block overrides for custom components\n * - 404 handling for missing content\n *\n * ## Escape Hatches\n *\n * For customization beyond the defaults, use these options:\n *\n * - `beforeRender`: Intercept before rendering (maintenance mode, access control)\n * - `customMetadata`: Full control over SEO metadata\n * - `wrapper`: Wrap all content (analytics, error boundaries)\n *\n * For maximum control, use the lower-level helpers directly:\n * - `loadContent()` from `@riverbankcms/sdk/rendering`\n * - `Page` component from `@riverbankcms/sdk/rendering`\n * - `generatePageMetadata()` from `@riverbankcms/sdk/metadata`\n *\n * @param options - Configuration options\n * @returns Object with `Page` component and `generateMetadata` function\n *\n * @example Basic usage\n * ```tsx\n * const { Page, generateMetadata } = createCatchAllPage({\n *   getClient: getRiverbankClient,\n *   config,\n * });\n *\n * export default Page;\n * export { generateMetadata };\n * ```\n *\n * @example With maintenance mode\n * ```tsx\n * const { Page, generateMetadata } = createCatchAllPage({\n *   getClient,\n *   config,\n *   beforeRender: async () => {\n *     if (process.env.MAINTENANCE_MODE === 'true') {\n *       return <MaintenancePage />;\n *     }\n *     return null;\n *   },\n * });\n * ```\n */\nexport function createCatchAllPage(\n  options: CreateCatchAllPageOptions\n): CreateCatchAllPageResult {\n  const {\n    getClient,\n    config,\n    blockOverrides,\n    siteUrl,\n    beforeRender,\n    customMetadata,\n    wrapper: Wrapper,\n  } = options;\n\n  /**\n   * Main page component that loads and renders CMS content.\n   */\n  async function Page({ params, searchParams: searchParamsPromise }: CatchAllPageProps): Promise<React.ReactNode> {\n    const [{ slug }, searchParams] = await Promise.all([\n      params,\n      searchParamsPromise ?? Promise.resolve({}),\n    ]);\n    const path = slugToPath(slug);\n    const preview = isPreviewMode();\n    const client = getClient();\n\n    // Load content (page or entry)\n    let content: LoadContentResult;\n    try {\n      content = await loadContent({\n        client,\n        siteId: config.siteId,\n        path,\n        preview,\n      });\n    } catch (error) {\n      // Log the error for debugging - could be a network error, auth failure, etc.\n      // We treat all errors as \"not found\" since the page can't be rendered\n      console.debug('[createCatchAllPage] Failed to load content for path:', path, error);\n      return notFound();\n    }\n\n    // ESCAPE HATCH: beforeRender for maintenance mode, access control, etc.\n    if (beforeRender) {\n      const intercepted = await beforeRender({ content, path, preview, searchParams });\n      if (intercepted !== null) {\n        return Wrapper ? <Wrapper>{intercepted}</Wrapper> : intercepted;\n      }\n    }\n\n    let rendered: React.ReactNode;\n\n    // Render page content\n    if (isPageContent(content)) {\n      rendered = (\n        <PageComponent\n          page={content.page}\n          theme={content.theme}\n          siteId={content.siteId}\n          resolvedData={content.resolvedData}\n          blockOverrides={blockOverrides}\n        />\n      );\n    }\n    // Render entry content with template\n    else if (isEntryContent(content)) {\n      // Entries without template pages should 404\n      if (!content.templatePage) {\n        return notFound();\n      }\n\n      rendered = (\n        <PageComponent\n          page={content.templatePage}\n          theme={content.theme}\n          siteId={content.siteId}\n          resolvedData={content.resolvedData}\n          blockOverrides={blockOverrides}\n          dataContext={{\n            contentEntry: content.dataContext.contentEntry,\n          }}\n        />\n      );\n    }\n    // Unexpected content type - should never happen\n    else {\n      return notFound();\n    }\n\n    return Wrapper ? <Wrapper>{rendered}</Wrapper> : rendered;\n  }\n\n  /**\n   * Generate SEO metadata for the page.\n   */\n  async function generateMetadataFn({ params, searchParams: searchParamsPromise }: CatchAllPageProps): Promise<Metadata> {\n    const [{ slug }, searchParams] = await Promise.all([\n      params,\n      searchParamsPromise ?? Promise.resolve({}),\n    ]);\n    const path = slugToPath(slug);\n    const preview = isPreviewMode();\n\n    try {\n      const content = await loadContent({\n        client: getClient(),\n        siteId: config.siteId,\n        path,\n        preview,\n      });\n\n      // ESCAPE HATCH: Custom metadata generation\n      if (customMetadata) {\n        return customMetadata({ content, path, preview, searchParams });\n      }\n\n      // Resolve site URL (use config URLs as fallback)\n      const resolvedUrl =\n        siteUrl ?? (preview ? config.previewUrl : config.liveUrl) ?? '';\n\n      // Warn if no site URL is configured - OG/Twitter tags require absolute URLs\n      if (!resolvedUrl) {\n        console.warn(\n          '[createCatchAllPage] No siteUrl configured. OpenGraph and Twitter tags will have relative URLs which may cause social sharing previews to fail. ' +\n          'Set siteUrl option, or config.liveUrl/config.previewUrl in your riverbank.config.'\n        );\n      }\n\n      // Build page object for metadata\n      // For entries, we use metaTitle/metaDescription; purpose is used as description fallback\n      const page = isPageContent(content)\n        ? content.page\n        : isEntryContent(content)\n          ? {\n              name: content.entry.metaTitle ?? content.entry.title,\n              purpose: content.entry.metaDescription ?? undefined,\n            }\n          : { name: 'Page' };\n\n      // Use preview metadata (noindex) in preview mode\n      const metadataGenerator = preview\n        ? generatePreviewMetadata\n        : generatePageMetadata;\n\n      // Use site data from loadContent result (no duplicate API call needed)\n      return metadataGenerator({\n        page,\n        site: content.site,\n        path,\n        siteUrl: resolvedUrl,\n      });\n    } catch (error) {\n      // Log the error for debugging purposes\n      console.debug('[createCatchAllPage] Failed to generate metadata for path:', path, error);\n      // Return minimal metadata on error - page will handle the actual 404\n      return {\n        title: 'Page Not Found',\n        robots: { index: false, follow: false },\n      };\n    }\n  }\n\n  return {\n    Page,\n    generateMetadata: generateMetadataFn,\n  };\n}\n","/**\n * Client-side React hook to fetch page data.\n *\n * Use this in client components for dynamic page loading.\n */\n\nimport { useState, useEffect } from 'react';\nimport type { RiverbankClient } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport type { RuntimeSdkConfig } from '../helpers/loadPage';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\n\nexport type UsePageParams = {\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\nexport type UsePageResult =\n  | { loading: true; error: null; page: null; theme: null; siteId: string; resolvedData: null; sdkConfig: null }\n  | { loading: false; error: Error; page: null; theme: null; siteId: string; resolvedData: null; sdkConfig: null }\n  | { loading: false; error: null; sdkConfig: RuntimeSdkConfig | null } & Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholders' | 'sdkConfig'>;\n\n/**\n * Client-side React hook to fetch all data needed for <Page> component.\n *\n * Fetches site data, page data, and prefetches block data loaders.\n * Returns loading and error states for proper UI handling.\n *\n * IMPORTANT: The client object should be stable across renders to avoid\n * unnecessary re-fetches. Create it outside your component or use useMemo:\n *\n * ```tsx\n * // ✅ Good - stable reference\n * const client = useMemo(\n *   () => createRiverbankClient({ apiKey, baseUrl }),\n *   [apiKey, baseUrl]\n * );\n *\n * // ❌ Bad - new client on every render (causes infinite loops)\n * const client = createRiverbankClient({ apiKey, baseUrl });\n * ```\n *\n * @example Basic usage\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { usePage, Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({\n *   apiKey: process.env.NEXT_PUBLIC_RIVERBANK_API_KEY!,\n *   baseUrl: process.env.NEXT_PUBLIC_DASHBOARD_URL + '/api',\n * });\n *\n * function MyPage({ path }: { path: string }) {\n *   const pageData = usePage({ client, siteId: 'site-123', path });\n *\n *   if (pageData.loading) {\n *     return <div>Loading...</div>;\n *   }\n *\n *   if (pageData.error) {\n *     return <div>Error: {pageData.error.message}</div>;\n *   }\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example With custom loading/error states\n * ```tsx\n * function MyPage({ path }: { path: string }) {\n *   const pageData = usePage({ client, siteId: 'site-123', path });\n *\n *   if (pageData.loading) {\n *     return <Skeleton />;\n *   }\n *\n *   if (pageData.error) {\n *     return (\n *       <ErrorBoundary\n *         error={pageData.error}\n *         onRetry={() => window.location.reload()}\n *       />\n *     );\n *   }\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n */\nexport function usePage(params: UsePageParams): UsePageResult {\n  const { client, siteId, path, pageId, preview = false } = params;\n\n  const [result, setResult] = useState<UsePageResult>({\n    loading: true,\n    error: null,\n    page: null,\n    theme: null,\n    siteId,\n    resolvedData: null,\n    sdkConfig: null,\n  });\n\n  useEffect(() => {\n    let cancelled = false;\n\n    async function fetchPage() {\n      try {\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        // If component unmounted, don't update state\n        if (cancelled) return;\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 useContent() instead, which handles both pages and entries. ' +\n            'For entries, useContent() 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\n        // API returns blocks with full content, but PageOutline only needs structure\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          return {\n            id: block.id,\n            kind: block.kind,\n            purpose: block.purpose,\n          };\n        });\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\n        const resolvedData = await prefetchBlockData(\n          pageOutline,\n          {\n            siteId,\n            pageId: pageId ?? pageData.id,\n            previewStage: preview ? 'preview' : 'published',\n          },\n          client\n        );\n\n        // If component unmounted, don't update state\n        if (cancelled) return;\n\n        setResult({\n          loading: false,\n          error: null,\n          page: pageOutline,\n          theme: site.theme,\n          siteId,\n          resolvedData,\n          sdkConfig: site.sdkConfig ?? null,\n        });\n      } catch (error) {\n        if (cancelled) return;\n\n        setResult({\n          loading: false,\n          error: error instanceof Error ? error : new Error(String(error)),\n          page: null,\n          theme: null,\n          siteId,\n          resolvedData: null,\n          sdkConfig: null,\n        });\n      }\n    }\n\n    fetchPage();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [client, siteId, path, pageId, preview]);\n\n  return result;\n}\n","/**\n * Client-side React hook to fetch content (page or entry) by path.\n *\n * Use this in client components for dynamic routing where a path\n * could resolve to either a page or content entry.\n */\n\nimport { useState, useEffect } from 'react';\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';\nimport type { ContentEntryData } from '../helpers/loadContent';\n\nexport type UseContentParams = {\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 * Loading state\n */\ntype LoadingState = {\n  loading: true;\n  error: null;\n  type: null;\n  page: null;\n  entry: null;\n  theme: null;\n  siteId: string;\n  resolvedData: null;\n};\n\n/**\n * Error state\n */\ntype ErrorState = {\n  loading: false;\n  error: Error;\n  type: null;\n  page: null;\n  entry: null;\n  theme: null;\n  siteId: string;\n  resolvedData: null;\n};\n\n/**\n * Success state for page content\n */\ntype PageSuccessState = {\n  loading: false;\n  error: null;\n  type: 'page';\n  page: PageProps['page'];\n  entry: null;\n  theme: Theme;\n  siteId: string;\n  resolvedData: ResolvedBlockData;\n};\n\n/**\n * Success state for entry content\n */\ntype EntrySuccessState = {\n  loading: false;\n  error: null;\n  type: 'entry';\n  page: null;\n  entry: ContentEntryData;\n  theme: Theme;\n  siteId: string;\n  resolvedData: null;\n};\n\nexport type UseContentResult = LoadingState | ErrorState | PageSuccessState | EntrySuccessState;\n\n/**\n * Type guard to check if result is loading\n */\nexport function isContentLoading(result: UseContentResult): result is LoadingState {\n  return result.loading === true;\n}\n\n/**\n * Type guard to check if result has an error\n */\nexport function isContentError(result: UseContentResult): result is ErrorState {\n  return result.loading === false && result.error !== null;\n}\n\n/**\n * Type guard to check if result is a page\n */\nexport function isPageContentResult(result: UseContentResult): result is PageSuccessState {\n  return result.loading === false && result.error === null && result.type === 'page';\n}\n\n/**\n * Type guard to check if result is an entry\n */\nexport function isEntryContentResult(result: UseContentResult): result is EntrySuccessState {\n  return result.loading === false && result.error === null && result.type === 'entry';\n}\n\n/**\n * Client-side React hook to fetch content by path.\n *\n * Returns a discriminated union with loading/error states, and either\n * page data (ready for `<Page>` component) or raw entry data (for custom rendering).\n *\n * IMPORTANT: The client object should be stable across renders to avoid\n * unnecessary re-fetches. Create it outside your component or use useMemo.\n *\n * @example Dynamic routing with both pages and entries\n * ```tsx\n * \"use client\";\n *\n * import { useContent, Page, isPageContentResult } from '@riverbankcms/sdk/client';\n *\n * function DynamicPage({ path }: { path: string }) {\n *   const content = useContent({ client, siteId: 'site-123', path });\n *\n *   if (content.loading) return <div>Loading...</div>;\n *   if (content.error) return <div>Error: {content.error.message}</div>;\n *\n *   if (isPageContentResult(content)) {\n *     return <Page page={content.page} theme={content.theme} siteId={content.siteId} resolvedData={content.resolvedData} />;\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 = useContent({ client, siteId, path });\n *\n * if (content.loading) return <Spinner />;\n * if (content.error) return <Error error={content.error} />;\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 *   }\n * }\n *\n * return <Page {...content} />;\n * ```\n */\nexport function useContent(params: UseContentParams): UseContentResult {\n  const { client, siteId, path, preview = false } = params;\n\n  const [result, setResult] = useState<UseContentResult>({\n    loading: true,\n    error: null,\n    type: null,\n    page: null,\n    entry: null,\n    theme: null,\n    siteId,\n    resolvedData: null,\n  });\n\n  useEffect(() => {\n    let cancelled = false;\n\n    async function fetchContent() {\n      try {\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        // If component unmounted, don't update state\n        if (cancelled) return;\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            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          setResult({\n            loading: false,\n            error: null,\n            type: 'entry',\n            page: null,\n            entry,\n            theme: site.theme,\n            siteId,\n            resolvedData: null,\n          });\n          return;\n        }\n\n        // Handle page response\n        const { page: pageData } = contentResponse;\n\n        // Convert API response blocks to PageOutline format\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          return {\n            id: block.id,\n            kind: block.kind,\n            purpose: block.purpose,\n          };\n        });\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        // If component unmounted, don't update state\n        if (cancelled) return;\n\n        setResult({\n          loading: false,\n          error: null,\n          type: 'page',\n          page: pageOutline,\n          entry: null,\n          theme: site.theme,\n          siteId,\n          resolvedData,\n        });\n      } catch (error) {\n        if (cancelled) return;\n\n        setResult({\n          loading: false,\n          error: error instanceof Error ? error : new Error(String(error)),\n          type: null,\n          page: null,\n          entry: null,\n          theme: null,\n          siteId,\n          resolvedData: null,\n        });\n      }\n    }\n\n    fetchContent();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [client, siteId, path, preview]);\n\n  return result;\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 * Static params generation for Next.js SSG\n *\n * Provides helpers for generating static params from published CMS routes.\n *\n * @example\n * ```tsx\n * // app/[[...slug]]/page.tsx\n * import { generateAllStaticParams } from '@riverbankcms/sdk/next';\n *\n * export { generateAllStaticParams as generateStaticParams };\n * ```\n */\n\nimport { createRiverbankClient } from '../client';\n\n/**\n * Environment variable validation result\n */\nexport type StaticParamsEnvResult =\n  | { valid: true; config: { apiKey: string; siteId: string; baseUrl: string } }\n  | { valid: false; missingVars: string[] };\n\n/**\n * Validate that all required environment variables are set.\n *\n * Required env vars:\n * - RIVERBANK_API_KEY: API key for published content\n * - RIVERBANK_SITE_ID: Site ID\n * - NEXT_PUBLIC_DASHBOARD_URL: Dashboard API URL\n *\n * @returns Validation result with config or missing vars\n */\nexport function validateStaticParamsEnv(): StaticParamsEnvResult {\n  const apiKey = process.env.RIVERBANK_API_KEY;\n  const siteId = process.env.RIVERBANK_SITE_ID;\n  const baseUrl = process.env.NEXT_PUBLIC_DASHBOARD_URL;\n\n  const missingVars: string[] = [];\n\n  if (!apiKey) missingVars.push('RIVERBANK_API_KEY');\n  if (!siteId) missingVars.push('RIVERBANK_SITE_ID');\n  if (!baseUrl) missingVars.push('NEXT_PUBLIC_DASHBOARD_URL');\n\n  if (missingVars.length > 0) {\n    return { valid: false, missingVars };\n  }\n\n  // TypeScript can't narrow through the checks above, so assert non-null\n  return {\n    valid: true,\n    config: { apiKey: apiKey!, siteId: siteId!, baseUrl: baseUrl! },\n  };\n}\n\n/**\n * Convert a route path to a Next.js slug array.\n *\n * @param path - The route path (e.g., '/about', '/blog/post')\n * @returns The slug array for Next.js catch-all route\n *\n * @example\n * ```ts\n * pathToSlugArray('/')           // []\n * pathToSlugArray('/about')      // ['about']\n * pathToSlugArray('/blog/post')  // ['blog', 'post']\n * ```\n */\nexport function pathToSlugArray(path: string): string[] {\n  if (path === '/') return [];\n  return path.slice(1).split('/');\n}\n\n/**\n * Generate static params for all published routes.\n *\n * This function fetches all published routes from the CMS and converts them\n * to the static params format expected by Next.js catch-all routes.\n *\n * Requires environment variables:\n * - RIVERBANK_API_KEY: API key for published content\n * - RIVERBANK_SITE_ID: Site ID\n * - NEXT_PUBLIC_DASHBOARD_URL: Dashboard API URL\n *\n * @throws Error if required env vars are missing (prevents silent empty SSG in CI)\n * @returns Array of static params objects for Next.js\n *\n * @example\n * ```tsx\n * // app/[[...slug]]/page.tsx\n * import { generateAllStaticParams } from '@riverbankcms/sdk/next';\n *\n * export { generateAllStaticParams as generateStaticParams };\n *\n * // Or with custom logic:\n * export async function generateStaticParams() {\n *   const params = await generateAllStaticParams();\n *   // Filter or modify params as needed\n *   return params.filter(p => !p.slug.includes('private'));\n * }\n * ```\n */\nexport async function generateAllStaticParams(): Promise<{ slug: string[] }[]> {\n  const envResult = validateStaticParamsEnv();\n\n  if (!envResult.valid) {\n    throw new Error(\n      `[Riverbank] generateAllStaticParams requires env vars: ${envResult.missingVars.join(', ')}. ` +\n        `This error prevents accidentally deploying with zero static pages.`\n    );\n  }\n\n  const { apiKey, siteId: _siteId, baseUrl } = envResult.config;\n\n  // Create client (unused until getAllPublishedRoutes is implemented)\n  const _client = createRiverbankClient({\n    apiKey,\n    baseUrl,\n    // Disable caching for build-time fetches\n    cache: { enabled: false },\n    // Disable resilience for build-time fetches (want fast failure)\n    resilience: { enabled: false },\n  });\n\n  // TODO: This requires adding getAllPublishedRoutes to the client\n  // which requires the CMS endpoint to be updated to accept API key auth\n  // and support the publishedOnly query param.\n  //\n  // For now, we'll use getPage to fetch the site's homepage which contains\n  // the navigation data, and extract routes from there.\n  //\n  // In the future, implement:\n  // const routes = await client.getAllPublishedRoutes({ siteId });\n  // return routes.map(path => ({ slug: pathToSlugArray(path) }));\n\n  // Temporary: Return empty array with warning\n  // This allows the helper to be used but won't pre-render any pages\n  console.warn(\n    '[Riverbank] generateAllStaticParams: getAllPublishedRoutes API not yet implemented. ' +\n      'Pages will be generated on-demand with ISR.'\n  );\n\n  // Return at least the homepage\n  return [{ slug: [] }];\n}\n","/**\n * Next.js integration helpers for Riverbank CMS SDK.\n *\n * Provides opinionated factories for common Next.js patterns, reducing\n * boilerplate while maintaining full customizability through escape hatches.\n *\n * @example Basic catch-all page\n * ```tsx\n * // src/app/[[...slug]]/page.tsx\n * import { createCatchAllPage } from '@riverbankcms/sdk/next';\n * import { getRiverbankClient } from '@/lib/builder-client';\n * import config from '@/riverbank.config';\n *\n * const { Page, generateMetadata } = createCatchAllPage({\n *   getClient: getRiverbankClient,\n *   config,\n * });\n *\n * export default Page;\n * export { generateMetadata };\n * ```\n *\n * @example With customization\n * ```tsx\n * const { Page, generateMetadata } = createCatchAllPage({\n *   getClient,\n *   config,\n *   blockOverrides: { hero: MyCustomHero },\n *   beforeRender: async () => {\n *     if (process.env.MAINTENANCE_MODE === 'true') {\n *       return <MaintenancePage />;\n *     }\n *     return null;\n *   },\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { isPreviewMode } from '../env';\n\n// Catch-all page factory\nexport { createCatchAllPage } from './catch-all';\nexport type {\n  CreateCatchAllPageOptions,\n  CreateCatchAllPageResult,\n  CatchAllPageProps,\n  CatchAllContext,\n} from './types';\n\n// Static params utilities\nexport {\n  generateAllStaticParams,\n  validateStaticParamsEnv,\n  pathToSlugArray,\n  type StaticParamsEnvResult,\n} from './static-params';\n\n/**\n * ISR revalidation duration in seconds for production mode.\n * 5 minutes provides a good balance between freshness and performance.\n */\nexport const ISR_REVALIDATE_SECONDS = 300;\n\nexport interface ISRConfig {\n  /**\n   * Revalidation interval in seconds.\n   * - 0: Dynamic rendering (no caching) - used in preview mode\n   * - 300: 5 minute ISR - used in production mode\n   */\n  revalidate: number | false;\n\n  /**\n   * Whether the current environment is in preview mode.\n   * Useful for conditional rendering or data fetching behavior.\n   */\n  isPreview: boolean;\n}\n\n/**\n * Get ISR configuration based on the current environment.\n *\n * @example\n * ```tsx\n * // app/[[...slug]]/page.tsx\n * import { getISRConfig } from '@riverbankcms/sdk/next';\n *\n * export const revalidate = getISRConfig().revalidate;\n * ```\n *\n * @returns ISR configuration with revalidate interval and preview flag\n */\nexport function getISRConfig(): ISRConfig {\n  const preview = isPreviewMode();\n  return {\n    revalidate: preview ? 0 : ISR_REVALIDATE_SECONDS,\n    isPreview: preview,\n  };\n}\n"]}

package/dist/server/next.mjs

@@ -2,6 +2,12 @@ import {
   generatePageMetadata,
   generatePreviewMetadata
 } from "./chunk-SWYWZT3L.mjs";
+import {
+  isPreviewMode
+} from "./chunk-PPHZV6YD.mjs";
+import {
+  createRiverbankClient
+} from "./chunk-NFQLH5IA.mjs";
 import {
   isEntryContent,
   isPageContent,
@@ -13,14 +19,12 @@ import {
 import "./chunk-LNOUXALA.mjs";
 import "./chunk-AEFWG657.mjs";
 import "./chunk-BYBJA6SP.mjs";
-import {
-  __require
-} from "./chunk-BJTO5JO5.mjs";
+import "./chunk-NFEGQTCC.mjs";
 
 // src/next/catch-all.tsx
+import { notFound } from "next/navigation";
 import { jsx } from "react/jsx-runtime";
-var { notFound } = __require("next/navigation");
-function isPreviewMode() {
+function isPreviewMode2() {
   return process.env.RIVERBANK_PREVIEW_MODE === "true";
 }
 function slugToPath(slug) {
@@ -43,7 +47,7 @@ function createCatchAllPage(options) {
       searchParamsPromise ?? Promise.resolve({})
     ]);
     const path = slugToPath(slug);
-    const preview = isPreviewMode();
+    const preview = isPreviewMode2();
     const client = getClient();
     let content;
     try {
@@ -103,7 +107,7 @@ function createCatchAllPage(options) {
       searchParamsPromise ?? Promise.resolve({})
     ]);
     const path = slugToPath(slug);
-    const preview = isPreviewMode();
+    const preview = isPreviewMode2();
     try {
       const content = await loadContent({
         client: getClient(),
@@ -144,7 +148,71 @@ function createCatchAllPage(options) {
     generateMetadata: generateMetadataFn
   };
 }
+
+// src/rendering/hooks/usePage.ts
+import { useState, useEffect } from "react";
+
+// src/rendering/hooks/useContent.ts
+import { useState as useState2, useEffect as useEffect2 } from "react";
+
+// src/next/static-params.ts
+function validateStaticParamsEnv() {
+  const apiKey = process.env.RIVERBANK_API_KEY;
+  const siteId = process.env.RIVERBANK_SITE_ID;
+  const baseUrl = process.env.NEXT_PUBLIC_DASHBOARD_URL;
+  const missingVars = [];
+  if (!apiKey) missingVars.push("RIVERBANK_API_KEY");
+  if (!siteId) missingVars.push("RIVERBANK_SITE_ID");
+  if (!baseUrl) missingVars.push("NEXT_PUBLIC_DASHBOARD_URL");
+  if (missingVars.length > 0) {
+    return { valid: false, missingVars };
+  }
+  return {
+    valid: true,
+    config: { apiKey, siteId, baseUrl }
+  };
+}
+function pathToSlugArray(path) {
+  if (path === "/") return [];
+  return path.slice(1).split("/");
+}
+async function generateAllStaticParams() {
+  const envResult = validateStaticParamsEnv();
+  if (!envResult.valid) {
+    throw new Error(
+      `[Riverbank] generateAllStaticParams requires env vars: ${envResult.missingVars.join(", ")}. This error prevents accidentally deploying with zero static pages.`
+    );
+  }
+  const { apiKey, siteId: _siteId, baseUrl } = envResult.config;
+  const _client = createRiverbankClient({
+    apiKey,
+    baseUrl,
+    // Disable caching for build-time fetches
+    cache: { enabled: false },
+    // Disable resilience for build-time fetches (want fast failure)
+    resilience: { enabled: false }
+  });
+  console.warn(
+    "[Riverbank] generateAllStaticParams: getAllPublishedRoutes API not yet implemented. Pages will be generated on-demand with ISR."
+  );
+  return [{ slug: [] }];
+}
+
+// src/next/index.ts
+var ISR_REVALIDATE_SECONDS = 300;
+function getISRConfig() {
+  const preview = isPreviewMode();
+  return {
+    revalidate: preview ? 0 : ISR_REVALIDATE_SECONDS,
+    isPreview: preview
+  };
+}
 export {
-  createCatchAllPage
+  ISR_REVALIDATE_SECONDS,
+  createCatchAllPage,
+  generateAllStaticParams,
+  getISRConfig,
+  pathToSlugArray,
+  validateStaticParamsEnv
 };
 //# sourceMappingURL=next.mjs.map