@riverbankcms/sdk 0.6.0 → 0.7.0

package/dist/server/next.d.mts

@@ -0,0 +1,274 @@
+import { ReactNode, ComponentType } from 'react';
+import { R as RiverbankClient } from './types-1cLz0vnq.mjs';
+import { R as RiverbankSiteConfig } from './types-BjgZt8xJ.mjs';
+import { B as BlockOverrides } from './loadPage-B8mQUUSo.mjs';
+import './schema-Z6-afHJG.mjs';
+import { M as Metadata } from './index-DI_qlYx3.mjs';
+import { b as LoadContentResult } from './loadContent-C-YYUKQa.mjs';
+import './types-Dsu9wsUh.mjs';
+import '@riverbankcms/ai';
+import 'zod';
+import './link-DjxLyC82.mjs';
+import '@riverbankcms/media-storage-supabase';
+import '@riverbankcms/db';
+import './blockKinds-B6MWzNWp.mjs';
+import 'react/jsx-runtime';
+import './core-DsNWrl3o.mjs';
+import './types-CbagRQ_7.mjs';
+
+/**
+ * Type definitions for Next.js integration helpers.
+ *
+ * These types define the options and props for the `createCatchAllPage()` factory,
+ * which simplifies catch-all routing for Riverbank CMS sites.
+ */
+
+/**
+ * Context passed to escape hatch callbacks.
+ */
+interface CatchAllContext {
+    /** Loaded content (page or entry) */
+    content: LoadContentResult;
+    /** Resolved URL path (e.g., '/about', '/blog/my-post') */
+    path: string;
+    /** Whether preview mode is enabled */
+    preview: boolean;
+    /** Search parameters from the URL (for filtering, pagination, etc.) */
+    searchParams: Record<string, string | string[] | undefined>;
+}
+/**
+ * Options for the `createCatchAllPage()` factory.
+ *
+ * @example Basic usage
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient: getRiverbankClient,
+ *   config,
+ *   blockOverrides: { hero: MyCustomHero },
+ * });
+ * ```
+ *
+ * @example With maintenance mode
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient,
+ *   config,
+ *   beforeRender: async () => {
+ *     if (process.env.MAINTENANCE_MODE === 'true') {
+ *       return <MaintenancePage />;
+ *     }
+ *     return null; // Continue with normal rendering
+ *   },
+ * });
+ * ```
+ */
+interface CreateCatchAllPageOptions {
+    /**
+     * Function that returns the Riverbank client.
+     * Called fresh on each request to support different caching strategies.
+     */
+    getClient: () => RiverbankClient;
+    /**
+     * Site configuration from `defineConfig()`.
+     * Provides siteId and content type routing information.
+     */
+    config: RiverbankSiteConfig;
+    /**
+     * Custom block component overrides for rendering.
+     * Keys can be full block kind ("block.hero") or short form ("hero").
+     */
+    blockOverrides?: BlockOverrides;
+    /**
+     * Override site URL for metadata generation.
+     * Defaults to `config.liveUrl` or `config.previewUrl` based on preview mode.
+     */
+    siteUrl?: string;
+    /**
+     * Intercept before rendering to implement maintenance mode, access control, etc.
+     *
+     * Return a React node to short-circuit rendering, or `null` to continue
+     * with normal page/entry rendering.
+     *
+     * @example Maintenance mode
+     * ```tsx
+     * beforeRender: async () => {
+     *   if (process.env.MAINTENANCE_MODE === 'true') {
+     *     return <MaintenancePage />;
+     *   }
+     *   return null;
+     * }
+     * ```
+     *
+     * @example Access control
+     * ```tsx
+     * beforeRender: async ({ path }) => {
+     *   if (path.startsWith('/members')) {
+     *     const session = await getSession();
+     *     if (!session) return <LoginPage redirect={path} />;
+     *   }
+     *   return null;
+     * }
+     * ```
+     */
+    beforeRender?: (context: CatchAllContext) => ReactNode | null | Promise<ReactNode | null>;
+    /**
+     * Custom metadata generator. If provided, replaces default metadata generation.
+     *
+     * Use this when you need full control over SEO metadata, such as adding
+     * product-specific Open Graph tags for e-commerce sites.
+     *
+     * @example Custom product metadata
+     * ```tsx
+     * customMetadata: async ({ content }) => {
+     *   if (isEntryContent(content) && content.entry.type === 'product') {
+     *     return {
+     *       title: `${content.entry.title} | Shop`,
+     *       openGraph: { type: 'product' },
+     *     };
+     *   }
+     *   // Use default for other content types
+     *   return generatePageMetadata({ page, site, path, siteUrl });
+     * }
+     * ```
+     */
+    customMetadata?: (context: CatchAllContext) => Metadata | Promise<Metadata>;
+    /**
+     * Wrapper component around rendered content.
+     *
+     * Useful for adding analytics scripts, error boundaries, or layout wrappers
+     * that should wrap all page content.
+     *
+     * @example Analytics wrapper
+     * ```tsx
+     * wrapper: ({ children }) => (
+     *   <>
+     *     {children}
+     *     <AnalyticsScript siteId={config.siteId} />
+     *   </>
+     * )
+     * ```
+     */
+    wrapper?: ComponentType<{
+        children: ReactNode;
+    }>;
+}
+/**
+ * Next.js page props for catch-all routes.
+ *
+ * This matches the signature expected by Next.js 15+ App Router pages
+ * with the `[[...slug]]` pattern.
+ */
+interface CatchAllPageProps {
+    /** Route parameters containing the slug segments */
+    params: Promise<{
+        slug?: string[];
+    }>;
+    /** Optional search parameters from the URL */
+    searchParams?: Promise<Record<string, string | string[] | undefined>>;
+}
+/**
+ * Result of the `createCatchAllPage()` factory.
+ */
+interface CreateCatchAllPageResult {
+    /**
+     * React component to use as the default export of your catch-all page.
+     *
+     * @example
+     * ```tsx
+     * const { Page, generateMetadata } = createCatchAllPage({ ... });
+     * export default Page;
+     * ```
+     */
+    Page: (props: CatchAllPageProps) => Promise<ReactNode>;
+    /**
+     * Metadata generation function for Next.js `generateMetadata`.
+     *
+     * @example
+     * ```tsx
+     * const { Page, generateMetadata } = createCatchAllPage({ ... });
+     * export { generateMetadata };
+     * ```
+     */
+    generateMetadata: (props: CatchAllPageProps) => Promise<Metadata>;
+}
+
+/**
+ * Next.js catch-all page factory for Riverbank CMS.
+ *
+ * Provides a simple, opinionated way to render CMS content in Next.js catch-all routes.
+ * Reduces typical page.tsx boilerplate from ~160 lines to ~10 lines.
+ *
+ * @example
+ * ```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,
+ *   blockOverrides: { hero: MyCustomHero },
+ * });
+ *
+ * export default Page;
+ * export { generateMetadata };
+ * ```
+ */
+
+/**
+ * Factory function to create a Next.js catch-all page component and metadata generator.
+ *
+ * This provides a simple, opinionated setup for rendering Riverbank CMS content
+ * in external SDK sites. It handles:
+ *
+ * - Page and content entry routing
+ * - Preview mode detection (via `RIVERBANK_PREVIEW_MODE` env var)
+ * - SEO metadata generation
+ * - Block overrides for custom components
+ * - 404 handling for missing content
+ *
+ * ## Escape Hatches
+ *
+ * For customization beyond the defaults, use these options:
+ *
+ * - `beforeRender`: Intercept before rendering (maintenance mode, access control)
+ * - `customMetadata`: Full control over SEO metadata
+ * - `wrapper`: Wrap all content (analytics, error boundaries)
+ *
+ * For maximum control, use the lower-level helpers directly:
+ * - `loadContent()` from `@riverbankcms/sdk/rendering`
+ * - `Page` component from `@riverbankcms/sdk/rendering`
+ * - `generatePageMetadata()` from `@riverbankcms/sdk/metadata`
+ *
+ * @param options - Configuration options
+ * @returns Object with `Page` component and `generateMetadata` function
+ *
+ * @example Basic usage
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient: getRiverbankClient,
+ *   config,
+ * });
+ *
+ * export default Page;
+ * export { generateMetadata };
+ * ```
+ *
+ * @example With maintenance mode
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient,
+ *   config,
+ *   beforeRender: async () => {
+ *     if (process.env.MAINTENANCE_MODE === 'true') {
+ *       return <MaintenancePage />;
+ *     }
+ *     return null;
+ *   },
+ * });
+ * ```
+ */
+declare function createCatchAllPage(options: CreateCatchAllPageOptions): CreateCatchAllPageResult;
+
+export { type CatchAllContext, type CatchAllPageProps, type CreateCatchAllPageOptions, type CreateCatchAllPageResult, createCatchAllPage };

package/dist/server/next.d.ts

@@ -0,0 +1,274 @@
+import { ReactNode, ComponentType } from 'react';
+import { R as RiverbankClient } from './types-BvcJU7zk.js';
+import { R as RiverbankSiteConfig } from './types-DLBhEPSt.js';
+import { B as BlockOverrides } from './loadPage-DP3nrHBi.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 '@riverbankcms/ai';
+import 'zod';
+import './link-DjxLyC82.js';
+import '@riverbankcms/media-storage-supabase';
+import '@riverbankcms/db';
+import './blockKinds-B6MWzNWp.js';
+import 'react/jsx-runtime';
+import './core-DsNWrl3o.js';
+import './types-DuQCNVV0.js';
+
+/**
+ * Type definitions for Next.js integration helpers.
+ *
+ * These types define the options and props for the `createCatchAllPage()` factory,
+ * which simplifies catch-all routing for Riverbank CMS sites.
+ */
+
+/**
+ * Context passed to escape hatch callbacks.
+ */
+interface CatchAllContext {
+    /** Loaded content (page or entry) */
+    content: LoadContentResult;
+    /** Resolved URL path (e.g., '/about', '/blog/my-post') */
+    path: string;
+    /** Whether preview mode is enabled */
+    preview: boolean;
+    /** Search parameters from the URL (for filtering, pagination, etc.) */
+    searchParams: Record<string, string | string[] | undefined>;
+}
+/**
+ * Options for the `createCatchAllPage()` factory.
+ *
+ * @example Basic usage
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient: getRiverbankClient,
+ *   config,
+ *   blockOverrides: { hero: MyCustomHero },
+ * });
+ * ```
+ *
+ * @example With maintenance mode
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient,
+ *   config,
+ *   beforeRender: async () => {
+ *     if (process.env.MAINTENANCE_MODE === 'true') {
+ *       return <MaintenancePage />;
+ *     }
+ *     return null; // Continue with normal rendering
+ *   },
+ * });
+ * ```
+ */
+interface CreateCatchAllPageOptions {
+    /**
+     * Function that returns the Riverbank client.
+     * Called fresh on each request to support different caching strategies.
+     */
+    getClient: () => RiverbankClient;
+    /**
+     * Site configuration from `defineConfig()`.
+     * Provides siteId and content type routing information.
+     */
+    config: RiverbankSiteConfig;
+    /**
+     * Custom block component overrides for rendering.
+     * Keys can be full block kind ("block.hero") or short form ("hero").
+     */
+    blockOverrides?: BlockOverrides;
+    /**
+     * Override site URL for metadata generation.
+     * Defaults to `config.liveUrl` or `config.previewUrl` based on preview mode.
+     */
+    siteUrl?: string;
+    /**
+     * Intercept before rendering to implement maintenance mode, access control, etc.
+     *
+     * Return a React node to short-circuit rendering, or `null` to continue
+     * with normal page/entry rendering.
+     *
+     * @example Maintenance mode
+     * ```tsx
+     * beforeRender: async () => {
+     *   if (process.env.MAINTENANCE_MODE === 'true') {
+     *     return <MaintenancePage />;
+     *   }
+     *   return null;
+     * }
+     * ```
+     *
+     * @example Access control
+     * ```tsx
+     * beforeRender: async ({ path }) => {
+     *   if (path.startsWith('/members')) {
+     *     const session = await getSession();
+     *     if (!session) return <LoginPage redirect={path} />;
+     *   }
+     *   return null;
+     * }
+     * ```
+     */
+    beforeRender?: (context: CatchAllContext) => ReactNode | null | Promise<ReactNode | null>;
+    /**
+     * Custom metadata generator. If provided, replaces default metadata generation.
+     *
+     * Use this when you need full control over SEO metadata, such as adding
+     * product-specific Open Graph tags for e-commerce sites.
+     *
+     * @example Custom product metadata
+     * ```tsx
+     * customMetadata: async ({ content }) => {
+     *   if (isEntryContent(content) && content.entry.type === 'product') {
+     *     return {
+     *       title: `${content.entry.title} | Shop`,
+     *       openGraph: { type: 'product' },
+     *     };
+     *   }
+     *   // Use default for other content types
+     *   return generatePageMetadata({ page, site, path, siteUrl });
+     * }
+     * ```
+     */
+    customMetadata?: (context: CatchAllContext) => Metadata | Promise<Metadata>;
+    /**
+     * Wrapper component around rendered content.
+     *
+     * Useful for adding analytics scripts, error boundaries, or layout wrappers
+     * that should wrap all page content.
+     *
+     * @example Analytics wrapper
+     * ```tsx
+     * wrapper: ({ children }) => (
+     *   <>
+     *     {children}
+     *     <AnalyticsScript siteId={config.siteId} />
+     *   </>
+     * )
+     * ```
+     */
+    wrapper?: ComponentType<{
+        children: ReactNode;
+    }>;
+}
+/**
+ * Next.js page props for catch-all routes.
+ *
+ * This matches the signature expected by Next.js 15+ App Router pages
+ * with the `[[...slug]]` pattern.
+ */
+interface CatchAllPageProps {
+    /** Route parameters containing the slug segments */
+    params: Promise<{
+        slug?: string[];
+    }>;
+    /** Optional search parameters from the URL */
+    searchParams?: Promise<Record<string, string | string[] | undefined>>;
+}
+/**
+ * Result of the `createCatchAllPage()` factory.
+ */
+interface CreateCatchAllPageResult {
+    /**
+     * React component to use as the default export of your catch-all page.
+     *
+     * @example
+     * ```tsx
+     * const { Page, generateMetadata } = createCatchAllPage({ ... });
+     * export default Page;
+     * ```
+     */
+    Page: (props: CatchAllPageProps) => Promise<ReactNode>;
+    /**
+     * Metadata generation function for Next.js `generateMetadata`.
+     *
+     * @example
+     * ```tsx
+     * const { Page, generateMetadata } = createCatchAllPage({ ... });
+     * export { generateMetadata };
+     * ```
+     */
+    generateMetadata: (props: CatchAllPageProps) => Promise<Metadata>;
+}
+
+/**
+ * Next.js catch-all page factory for Riverbank CMS.
+ *
+ * Provides a simple, opinionated way to render CMS content in Next.js catch-all routes.
+ * Reduces typical page.tsx boilerplate from ~160 lines to ~10 lines.
+ *
+ * @example
+ * ```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,
+ *   blockOverrides: { hero: MyCustomHero },
+ * });
+ *
+ * export default Page;
+ * export { generateMetadata };
+ * ```
+ */
+
+/**
+ * Factory function to create a Next.js catch-all page component and metadata generator.
+ *
+ * This provides a simple, opinionated setup for rendering Riverbank CMS content
+ * in external SDK sites. It handles:
+ *
+ * - Page and content entry routing
+ * - Preview mode detection (via `RIVERBANK_PREVIEW_MODE` env var)
+ * - SEO metadata generation
+ * - Block overrides for custom components
+ * - 404 handling for missing content
+ *
+ * ## Escape Hatches
+ *
+ * For customization beyond the defaults, use these options:
+ *
+ * - `beforeRender`: Intercept before rendering (maintenance mode, access control)
+ * - `customMetadata`: Full control over SEO metadata
+ * - `wrapper`: Wrap all content (analytics, error boundaries)
+ *
+ * For maximum control, use the lower-level helpers directly:
+ * - `loadContent()` from `@riverbankcms/sdk/rendering`
+ * - `Page` component from `@riverbankcms/sdk/rendering`
+ * - `generatePageMetadata()` from `@riverbankcms/sdk/metadata`
+ *
+ * @param options - Configuration options
+ * @returns Object with `Page` component and `generateMetadata` function
+ *
+ * @example Basic usage
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient: getRiverbankClient,
+ *   config,
+ * });
+ *
+ * export default Page;
+ * export { generateMetadata };
+ * ```
+ *
+ * @example With maintenance mode
+ * ```tsx
+ * const { Page, generateMetadata } = createCatchAllPage({
+ *   getClient,
+ *   config,
+ *   beforeRender: async () => {
+ *     if (process.env.MAINTENANCE_MODE === 'true') {
+ *       return <MaintenancePage />;
+ *     }
+ *     return null;
+ *   },
+ * });
+ * ```
+ */
+declare function createCatchAllPage(options: CreateCatchAllPageOptions): CreateCatchAllPageResult;
+
+export { type CatchAllContext, type CatchAllPageProps, type CreateCatchAllPageOptions, type CreateCatchAllPageResult, createCatchAllPage };

package/dist/server/next.js

@@ -0,0 +1,150 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+var _chunkBNQV3PXPjs = require('./chunk-BNQV3PXP.js');
+
+
+
+
+var _chunkJWRNMNWIjs = require('./chunk-JWRNMNWI.js');
+
+
+var _chunkT26N3P26js = require('./chunk-T26N3P26.js');
+require('./chunk-7UPVCT3K.js');
+require('./chunk-RVDS7VSP.js');
+require('./chunk-YYO3RIFO.js');
+
+
+var _chunkDGUM43GVjs = require('./chunk-DGUM43GV.js');
+
+// src/next/catch-all.tsx
+var _jsxruntime = require('react/jsx-runtime');
+var { notFound } = _chunkDGUM43GVjs.__require.call(void 0, "next/navigation");
+function isPreviewMode() {
+  return process.env.RIVERBANK_PREVIEW_MODE === "true";
+}
+function slugToPath(slug) {
+  if (!slug || slug.length === 0) return "/";
+  return "/" + slug.join("/");
+}
+function createCatchAllPage(options) {
+  const {
+    getClient,
+    config,
+    blockOverrides,
+    siteUrl,
+    beforeRender,
+    customMetadata,
+    wrapper: Wrapper
+  } = options;
+  async function Page2({ params, searchParams: searchParamsPromise }) {
+    const [{ slug }, searchParams] = await Promise.all([
+      params,
+      _nullishCoalesce(searchParamsPromise, () => ( Promise.resolve({})))
+    ]);
+    const path = slugToPath(slug);
+    const preview = isPreviewMode();
+    const client = getClient();
+    let content;
+    try {
+      content = await _chunkJWRNMNWIjs.loadContent.call(void 0, {
+        client,
+        siteId: config.siteId,
+        path,
+        preview
+      });
+    } catch (error) {
+      console.debug("[createCatchAllPage] Failed to load content for path:", path, error);
+      return notFound();
+    }
+    if (beforeRender) {
+      const intercepted = await beforeRender({ content, path, preview, searchParams });
+      if (intercepted !== null) {
+        return Wrapper ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, Wrapper, { children: intercepted }) : intercepted;
+      }
+    }
+    let rendered;
+    if (_chunkJWRNMNWIjs.isPageContent.call(void 0, content)) {
+      rendered = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        _chunkT26N3P26js.Page,
+        {
+          page: content.page,
+          theme: content.theme,
+          siteId: content.siteId,
+          resolvedData: content.resolvedData,
+          blockOverrides
+        }
+      );
+    } else if (_chunkJWRNMNWIjs.isEntryContent.call(void 0, content)) {
+      if (!content.templatePage) {
+        return notFound();
+      }
+      rendered = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        _chunkT26N3P26js.Page,
+        {
+          page: content.templatePage,
+          theme: content.theme,
+          siteId: content.siteId,
+          resolvedData: content.resolvedData,
+          blockOverrides,
+          dataContext: {
+            contentEntry: content.dataContext.contentEntry
+          }
+        }
+      );
+    } else {
+      return notFound();
+    }
+    return Wrapper ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, Wrapper, { children: rendered }) : rendered;
+  }
+  async function generateMetadataFn({ params, searchParams: searchParamsPromise }) {
+    const [{ slug }, searchParams] = await Promise.all([
+      params,
+      _nullishCoalesce(searchParamsPromise, () => ( Promise.resolve({})))
+    ]);
+    const path = slugToPath(slug);
+    const preview = isPreviewMode();
+    try {
+      const content = await _chunkJWRNMNWIjs.loadContent.call(void 0, {
+        client: getClient(),
+        siteId: config.siteId,
+        path,
+        preview
+      });
+      if (customMetadata) {
+        return customMetadata({ content, path, preview, searchParams });
+      }
+      const resolvedUrl = _nullishCoalesce(_nullishCoalesce(siteUrl, () => ( (preview ? config.previewUrl : config.liveUrl))), () => ( ""));
+      if (!resolvedUrl) {
+        console.warn(
+          "[createCatchAllPage] No siteUrl configured. OpenGraph and Twitter tags will have relative URLs which may cause social sharing previews to fail. Set siteUrl option, or config.liveUrl/config.previewUrl in your riverbank.config."
+        );
+      }
+      const page = _chunkJWRNMNWIjs.isPageContent.call(void 0, content) ? content.page : _chunkJWRNMNWIjs.isEntryContent.call(void 0, content) ? {
+        name: _nullishCoalesce(content.entry.metaTitle, () => ( content.entry.title)),
+        purpose: _nullishCoalesce(content.entry.metaDescription, () => ( void 0))
+      } : { name: "Page" };
+      const metadataGenerator = preview ? _chunkBNQV3PXPjs.generatePreviewMetadata : _chunkBNQV3PXPjs.generatePageMetadata;
+      return metadataGenerator({
+        page,
+        site: content.site,
+        path,
+        siteUrl: resolvedUrl
+      });
+    } catch (error) {
+      console.debug("[createCatchAllPage] Failed to generate metadata for path:", path, error);
+      return {
+        title: "Page Not Found",
+        robots: { index: false, follow: false }
+      };
+    }
+  }
+  return {
+    Page: Page2,
+    generateMetadata: generateMetadataFn
+  };
+}
+
+
+exports.createCatchAllPage = createCatchAllPage;
+//# sourceMappingURL=next.js.map