@riverbankcms/sdk 0.1.0

package/dist/server/loadPage-CCf15nt8.d.mts

@@ -0,0 +1,216 @@
+import { R as RiverbankClient, S as SiteResponse } from './types-C6gmRHLe.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { PageOutline, Theme, ThemeTokens, RouteMap, OccurrenceContextData, PageRenderer, BlockOverrides } from '@riverbankcms/blocks';
+import { ResolvedBlockData } from '@riverbankcms/blocks/system/data';
+import { D as DataLoaderOverrides } from './types-Bbo01M7P.mjs';
+
+type PageProps = {
+    page: PageOutline;
+    theme: Theme;
+    siteId: string;
+    themeTokens?: ThemeTokens;
+    resolvedData?: ResolvedBlockData;
+    routeMap?: RouteMap;
+    /**
+     * SDK site configuration containing theme palette overrides.
+     * When provided, the SDK palette tokens are merged into the theme tokens,
+     * allowing blocks to use SDK-defined color tokens for section backgrounds.
+     */
+    sdkConfig?: RuntimeSdkConfig | null;
+    /**
+     * Additional context data for content entry pages.
+     * Used to pass occurrence context and content entry data to blocks.
+     */
+    dataContext?: {
+        /** Occurrence context for event pages (from URL like /events/yoga/2025-01-15) */
+        occurrenceContext?: OccurrenceContextData | null;
+        /** Content entry data for template pages */
+        contentEntry?: Record<string, unknown> | null;
+    };
+    wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
+    registry?: Parameters<typeof PageRenderer>[0]['registry'];
+    usePlaceholders?: boolean;
+    /**
+     * Custom components to override default block rendering.
+     * Keys can be full block kind ("block.hero") or short form ("hero").
+     *
+     * This is SSR-safe - no context or hooks required.
+     *
+     * @example
+     * ```tsx
+     * <Page
+     *   {...pageData}
+     *   blockOverrides={{
+     *     'hero': MyCustomHero,
+     *     'block.testimonials': MyCustomTestimonials,
+     *   }}
+     * />
+     * ```
+     */
+    blockOverrides?: BlockOverrides;
+};
+/**
+ * Pure renderer for Riverbank CMS pages.
+ *
+ * This component expects all data to be provided via props.
+ * For data fetching, use:
+ * - Server-side: `await loadPage({ client, siteId, path })`
+ * - Client-side: `usePage({ client, siteId, path })`
+ *
+ * @example Server-side (Next.js App Router)
+ * ```tsx
+ * import { createRiverbankClient } from '@riverbankcms/sdk';
+ * import { loadPage, Page } from '@riverbankcms/sdk/rendering';
+ *
+ * const client = createRiverbankClient({ apiKey, baseUrl });
+ *
+ * export default async function PageRoute({ params }) {
+ *   const pageData = await loadPage({
+ *     client,
+ *     siteId: 'site-id',
+ *     path: `/${params.slug}`,
+ *   });
+ *
+ *   return <Page {...pageData} />;
+ * }
+ * ```
+ *
+ * @example Client-side
+ * ```tsx
+ * import { createRiverbankClient } from '@riverbankcms/sdk';
+ * import { usePage, Page } from '@riverbankcms/sdk/rendering';
+ *
+ * const client = createRiverbankClient({ apiKey, baseUrl });
+ *
+ * function MyPage({ path }) {
+ *   const pageData = usePage({ client, siteId: 'site-id', path });
+ *
+ *   if (pageData.loading) return <LoadingState />;
+ *   if (pageData.error) return <ErrorState error={pageData.error} />;
+ *   if (!pageData.page) return <NotFound />;
+ *
+ *   return <Page {...pageData} />;
+ * }
+ * ```
+ */
+declare function Page({ page, theme, themeTokens: providedTokens, siteId, resolvedData, routeMap, wrapBlock, registry, usePlaceholders, blockOverrides, sdkConfig, dataContext, }: PageProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Server-side helper to fetch all data needed for <Page> component.
+ *
+ * Use this in server components, getServerSideProps, or API routes.
+ */
+
+/**
+ * SDK config from API response (without siteId which is stripped at storage).
+ * This is the runtime representation - for defining configs, use RiverbankSiteConfig.
+ */
+type RuntimeSdkConfig = NonNullable<SiteResponse['sdkConfig']>;
+type LoadPageParams = {
+    client: RiverbankClient;
+    siteId: string;
+    path: string;
+    pageId?: string;
+    /**
+     * If true, fetches draft/unpublished content instead of published content.
+     * This affects both the page structure and block data loaders.
+     * Requires API key with site access.
+     *
+     * @default false
+     */
+    preview?: boolean;
+    /**
+     * Code-based data loaders for custom blocks.
+     *
+     * Use this to fetch data from external APIs (not just whitelisted CMS endpoints).
+     * Keys are block kinds (e.g., 'custom.featured-products').
+     *
+     * Config-based loaders (defined in riverbank.config.ts) run first.
+     * Code loaders run second and take precedence on key conflicts.
+     *
+     * @example
+     * ```typescript
+     * const pageData = await loadPage({
+     *   client,
+     *   siteId: 'site-123',
+     *   path: '/',
+     *   dataLoaderOverrides: {
+     *     'custom.featured-products': {
+     *       products: async (ctx) => {
+     *         const res = await fetch(`https://api.shop.com/products?category=${ctx.content.categoryId}`);
+     *         return res.json();
+     *       },
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    dataLoaderOverrides?: DataLoaderOverrides;
+};
+type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholders' | 'blockOverrides'> & {
+    /**
+     * SDK site configuration, if available.
+     * Contains SDK-defined theme palette, section backgrounds, and style options.
+     */
+    sdkConfig: RuntimeSdkConfig | null;
+};
+/**
+ * Server-side helper to fetch all data needed for <Page> component.
+ *
+ * Fetches site data, page data, and prefetches block data loaders in parallel.
+ *
+ * @example Next.js App Router (published content)
+ * ```tsx
+ * import { createRiverbankClient } from '@riverbankcms/sdk';
+ * import { loadPage, Page } from '@riverbankcms/sdk/rendering';
+ *
+ * const client = createRiverbankClient({
+ *   apiKey: process.env.RIVERBANK_API_KEY!,
+ *   baseUrl: process.env.NEXT_PUBLIC_DASHBOARD_URL + '/api',
+ * });
+ *
+ * export default async function PageRoute({ params }) {
+ *   const pageData = await loadPage({
+ *     client,
+ *     siteId: 'site-123',
+ *     path: `/${params.slug || ''}`,
+ *   });
+ *
+ *   return <Page {...pageData} />;
+ * }
+ * ```
+ *
+ * @example Next.js App Router (preview/draft content)
+ * ```tsx
+ * export default async function PreviewRoute({ params, searchParams }) {
+ *   const pageData = await loadPage({
+ *     client,
+ *     siteId: searchParams.siteId,
+ *     path: `/${params.slug || ''}`,
+ *     preview: true, // Fetch draft content
+ *   });
+ *
+ *   return <Page {...pageData} />;
+ * }
+ * ```
+ *
+ * @example Next.js Pages Router (getServerSideProps)
+ * ```tsx
+ * export async function getServerSideProps({ params }) {
+ *   const pageData = await loadPage({
+ *     client,
+ *     siteId: 'site-123',
+ *     path: `/${params.slug || ''}`,
+ *   });
+ *
+ *   return { props: pageData };
+ * }
+ *
+ * export default function PageRoute(props) {
+ *   return <Page {...props} />;
+ * }
+ * ```
+ */
+declare function loadPage(params: LoadPageParams): Promise<LoadPageResult>;
+
+export { type LoadPageParams as L, Page as P, type RuntimeSdkConfig as R, type LoadPageResult as a, type PageProps as b, loadPage as l };

package/dist/server/loadPage-DVH3DW6E.js

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkADREPXFUjs = require('./chunk-ADREPXFU.js');
+require('./chunk-YXDDFG3N.js');
+require('./chunk-QQ6U4QX6.js');
+
+
+exports.loadPage = _chunkADREPXFUjs.loadPage;
+//# sourceMappingURL=loadPage-DVH3DW6E.js.map

package/dist/server/loadPage-DVH3DW6E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/loadPage-DVH3DW6E.js"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACF,6CAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/loadPage-DVH3DW6E.js"}

package/dist/server/loadPage-PHQZ6XQZ.mjs

@@ -0,0 +1,9 @@
+import {
+  loadPage
+} from "./chunk-2RW5HAQQ.mjs";
+import "./chunk-GWBMJPLH.mjs";
+import "./chunk-W3K7LVPS.mjs";
+export {
+  loadPage
+};
+//# sourceMappingURL=loadPage-PHQZ6XQZ.mjs.map

package/dist/server/loadPage-PHQZ6XQZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server/metadata.d.mts

@@ -0,0 +1,135 @@
+import { a as LoadPageResult } from './loadPage-CCf15nt8.mjs';
+import { S as SiteResponse } from './types-C6gmRHLe.mjs';
+import 'react/jsx-runtime';
+import '@riverbankcms/blocks';
+import '@riverbankcms/blocks/system/data';
+import './types-Bbo01M7P.mjs';
+import '@riverbankcms/api';
+
+/**
+ * Metadata generation helper for Next.js pages
+ *
+ * Generates SEO-optimized metadata from Builder page data for use in
+ * Next.js generateMetadata() functions.
+ */
+
+/**
+ * Next.js Metadata type
+ * Simplified version to avoid requiring Next.js as a dependency
+ */
+type Metadata = {
+    title?: string;
+    description?: string;
+    alternates?: {
+        canonical?: string;
+    };
+    openGraph?: {
+        title?: string;
+        description?: string;
+        url?: string;
+        siteName?: string;
+        type?: string;
+        images?: Array<{
+            url: string;
+            alt?: string;
+        }>;
+    };
+    twitter?: {
+        card?: string;
+        title?: string;
+        description?: string;
+        images?: string[];
+    };
+    robots?: {
+        index?: boolean;
+        follow?: boolean;
+    };
+    verification?: {
+        google?: string;
+    };
+};
+type PageMetadataInput = {
+    /**
+     * Page data from loadPage() or custom page object
+     */
+    page: LoadPageResult['page'] | {
+        name: string;
+        purpose?: string;
+    };
+    /**
+     * Site data from client.getSite()
+     */
+    site: SiteResponse['site'];
+    /**
+     * Current URL path (e.g., '/about', '/blog/post-1')
+     */
+    path: string;
+    /**
+     * Full site URL for canonical and OG URLs
+     * Example: 'https://example.com'
+     */
+    siteUrl: string;
+    /**
+     * Optional custom metadata overrides
+     */
+    overrides?: {
+        title?: string;
+        description?: string;
+        ogImage?: string;
+        canonicalUrl?: string;
+        robots?: {
+            index?: boolean;
+            follow?: boolean;
+        };
+    };
+    /**
+     * Optional Google site verification token
+     */
+    googleSiteVerification?: string;
+};
+/**
+ * Generate Next.js Metadata object from Builder page data
+ *
+ * @example
+ * ```tsx
+ * import { generatePageMetadata } from '@riverbankcms/sdk/metadata';
+ * import { loadPage } from '@riverbankcms/sdk';
+ *
+ * export async function generateMetadata({ params }) {
+ *   const pageData = await loadPage({ client, siteId, path: params.slug });
+ *   const siteData = await client.getSite({ id: siteId });
+ *
+ *   return generatePageMetadata({
+ *     page: pageData.page,
+ *     site: siteData.site,
+ *     path: params.slug,
+ *     siteUrl: 'https://example.com',
+ *   });
+ * }
+ * ```
+ */
+declare function generatePageMetadata(input: PageMetadataInput): Metadata;
+/**
+ * Generate metadata for preview/staging environments
+ *
+ * This helper adds noindex/nofollow robots tags to prevent search engines
+ * from indexing preview or staging URLs.
+ *
+ * @example
+ * ```tsx
+ * export async function generateMetadata({ params }) {
+ *   const pageData = await loadPage({ client, siteId, path: params.slug });
+ *   const isPreview = process.env.VERCEL_ENV !== 'production';
+ *
+ *   return generatePreviewMetadata({
+ *     page: pageData.page,
+ *     site: siteData.site,
+ *     path: params.slug,
+ *     siteUrl: 'https://example.com',
+ *   });
+ * }
+ * ```
+ */
+declare function generatePreviewMetadata(input: PageMetadataInput): Metadata;
+
+export { type PageMetadataInput, generatePageMetadata, generatePreviewMetadata };

package/dist/server/metadata.d.ts

@@ -0,0 +1,135 @@
+import { a as LoadPageResult } from './loadPage-BYmVMk0V.js';
+import { S as SiteResponse } from './types-C6gmRHLe.js';
+import 'react/jsx-runtime';
+import '@riverbankcms/blocks';
+import '@riverbankcms/blocks/system/data';
+import './types-Bbo01M7P.js';
+import '@riverbankcms/api';
+
+/**
+ * Metadata generation helper for Next.js pages
+ *
+ * Generates SEO-optimized metadata from Builder page data for use in
+ * Next.js generateMetadata() functions.
+ */
+
+/**
+ * Next.js Metadata type
+ * Simplified version to avoid requiring Next.js as a dependency
+ */
+type Metadata = {
+    title?: string;
+    description?: string;
+    alternates?: {
+        canonical?: string;
+    };
+    openGraph?: {
+        title?: string;
+        description?: string;
+        url?: string;
+        siteName?: string;
+        type?: string;
+        images?: Array<{
+            url: string;
+            alt?: string;
+        }>;
+    };
+    twitter?: {
+        card?: string;
+        title?: string;
+        description?: string;
+        images?: string[];
+    };
+    robots?: {
+        index?: boolean;
+        follow?: boolean;
+    };
+    verification?: {
+        google?: string;
+    };
+};
+type PageMetadataInput = {
+    /**
+     * Page data from loadPage() or custom page object
+     */
+    page: LoadPageResult['page'] | {
+        name: string;
+        purpose?: string;
+    };
+    /**
+     * Site data from client.getSite()
+     */
+    site: SiteResponse['site'];
+    /**
+     * Current URL path (e.g., '/about', '/blog/post-1')
+     */
+    path: string;
+    /**
+     * Full site URL for canonical and OG URLs
+     * Example: 'https://example.com'
+     */
+    siteUrl: string;
+    /**
+     * Optional custom metadata overrides
+     */
+    overrides?: {
+        title?: string;
+        description?: string;
+        ogImage?: string;
+        canonicalUrl?: string;
+        robots?: {
+            index?: boolean;
+            follow?: boolean;
+        };
+    };
+    /**
+     * Optional Google site verification token
+     */
+    googleSiteVerification?: string;
+};
+/**
+ * Generate Next.js Metadata object from Builder page data
+ *
+ * @example
+ * ```tsx
+ * import { generatePageMetadata } from '@riverbankcms/sdk/metadata';
+ * import { loadPage } from '@riverbankcms/sdk';
+ *
+ * export async function generateMetadata({ params }) {
+ *   const pageData = await loadPage({ client, siteId, path: params.slug });
+ *   const siteData = await client.getSite({ id: siteId });
+ *
+ *   return generatePageMetadata({
+ *     page: pageData.page,
+ *     site: siteData.site,
+ *     path: params.slug,
+ *     siteUrl: 'https://example.com',
+ *   });
+ * }
+ * ```
+ */
+declare function generatePageMetadata(input: PageMetadataInput): Metadata;
+/**
+ * Generate metadata for preview/staging environments
+ *
+ * This helper adds noindex/nofollow robots tags to prevent search engines
+ * from indexing preview or staging URLs.
+ *
+ * @example
+ * ```tsx
+ * export async function generateMetadata({ params }) {
+ *   const pageData = await loadPage({ client, siteId, path: params.slug });
+ *   const isPreview = process.env.VERCEL_ENV !== 'production';
+ *
+ *   return generatePreviewMetadata({
+ *     page: pageData.page,
+ *     site: siteData.site,
+ *     path: params.slug,
+ *     siteUrl: 'https://example.com',
+ *   });
+ * }
+ * ```
+ */
+declare function generatePreviewMetadata(input: PageMetadataInput): Metadata;
+
+export { type PageMetadataInput, generatePageMetadata, generatePreviewMetadata };

package/dist/server/metadata.js

@@ -0,0 +1,68 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/metadata/generatePageMetadata.ts
+function generatePageMetadata(input) {
+  const { page, site, path, siteUrl, overrides, googleSiteVerification } = input;
+  const pageTitle = _nullishCoalesce(_optionalChain([overrides, 'optionalAccess', _ => _.title]), () => ( page.name));
+  const fullTitle = pageTitle === site.title ? pageTitle : `${pageTitle} | ${site.title}`;
+  const description = _nullishCoalesce(_optionalChain([overrides, 'optionalAccess', _2 => _2.description]), () => ( page.purpose));
+  const canonicalUrl = _nullishCoalesce(_optionalChain([overrides, 'optionalAccess', _3 => _3.canonicalUrl]), () => ( `${siteUrl}${path}`));
+  const fullUrl = `${siteUrl}${path}`;
+  const metadata = {
+    title: fullTitle,
+    description: _nullishCoalesce(description, () => ( void 0)),
+    alternates: {
+      canonical: canonicalUrl
+    },
+    openGraph: {
+      title: pageTitle,
+      description: _nullishCoalesce(description, () => ( void 0)),
+      url: fullUrl,
+      siteName: site.title,
+      type: "website",
+      ..._optionalChain([overrides, 'optionalAccess', _4 => _4.ogImage]) ? {
+        images: [
+          {
+            url: overrides.ogImage,
+            alt: pageTitle
+          }
+        ]
+      } : {}
+    },
+    twitter: {
+      card: "summary_large_image",
+      title: pageTitle,
+      description: _nullishCoalesce(description, () => ( void 0)),
+      ..._optionalChain([overrides, 'optionalAccess', _5 => _5.ogImage]) ? {
+        images: [overrides.ogImage]
+      } : {}
+    }
+  };
+  if (_optionalChain([overrides, 'optionalAccess', _6 => _6.robots])) {
+    metadata.robots = {
+      index: _nullishCoalesce(overrides.robots.index, () => ( true)),
+      follow: _nullishCoalesce(overrides.robots.follow, () => ( true))
+    };
+  }
+  if (googleSiteVerification) {
+    metadata.verification = {
+      google: googleSiteVerification
+    };
+  }
+  return metadata;
+}
+function generatePreviewMetadata(input) {
+  return generatePageMetadata({
+    ...input,
+    overrides: {
+      ...input.overrides,
+      robots: {
+        index: false,
+        follow: false
+      }
+    }
+  });
+}
+
+
+
+exports.generatePageMetadata = generatePageMetadata; exports.generatePreviewMetadata = generatePreviewMetadata;
+//# sourceMappingURL=metadata.js.map

package/dist/server/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/metadata.js","../../src/metadata/generatePageMetadata.ts"],"names":[],"mappings":"AAAA;ACgHO,SAAS,oBAAA,CAAqB,KAAA,EAAoC;AACvE,EAAA,MAAM,EAAE,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,SAAA,EAAW,uBAAuB,EAAA,EAAI,KAAA;AAGzE,EAAA,MAAM,UAAA,mCAAY,SAAA,2BAAW,OAAA,UAAS,IAAA,CAAK,MAAA;AAC3C,EAAA,MAAM,UAAA,EAAY,UAAA,IAAc,IAAA,CAAK,MAAA,EAAQ,UAAA,EAAY,CAAA,EAAA;AAGN,EAAA;AAGO,EAAA;AACzB,EAAA;AAGN,EAAA;AAClB,IAAA;AACqB,IAAA;AAChB,IAAA;AACC,MAAA;AACb,IAAA;AACW,IAAA;AACF,MAAA;AACqB,MAAA;AACvB,MAAA;AACU,MAAA;AACT,MAAA;AAEF,MAAA;AACU,QAAA;AACN,UAAA;AACiB,YAAA;AACV,YAAA;AACP,UAAA;AACF,QAAA;AAED,MAAA;AACP,IAAA;AACS,IAAA;AACD,MAAA;AACC,MAAA;AACqB,MAAA;AAExB,MAAA;AAC4B,QAAA;AAE3B,MAAA;AACP,IAAA;AACF,EAAA;AAGuB,EAAA;AACH,IAAA;AACiB,MAAA;AACE,MAAA;AACrC,IAAA;AACF,EAAA;AAG4B,EAAA;AACF,IAAA;AACd,MAAA;AACV,IAAA;AACF,EAAA;AAEO,EAAA;AACT;AAuB4E;AAC9C,EAAA;AACvB,IAAA;AACQ,IAAA;AACA,MAAA;AACD,MAAA;AACC,QAAA;AACC,QAAA;AACV,MAAA;AACF,IAAA;AACD,EAAA;AACH;ADrJ4D;AACA;AACA;AACA","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/metadata.js","sourcesContent":[null,"/**\n * Metadata generation helper for Next.js pages\n *\n * Generates SEO-optimized metadata from Builder page data for use in\n * Next.js generateMetadata() functions.\n */\n\nimport type { LoadPageResult } from '../rendering/helpers/loadPage';\nimport type { SiteResponse } from '../client/types';\n\n/**\n * Next.js Metadata type\n * Simplified version to avoid requiring Next.js as a dependency\n */\nexport type Metadata = {\n  title?: string;\n  description?: string;\n  alternates?: {\n    canonical?: string;\n  };\n  openGraph?: {\n    title?: string;\n    description?: string;\n    url?: string;\n    siteName?: string;\n    type?: string;\n    images?: Array<{\n      url: string;\n      alt?: string;\n    }>;\n  };\n  twitter?: {\n    card?: string;\n    title?: string;\n    description?: string;\n    images?: string[];\n  };\n  robots?: {\n    index?: boolean;\n    follow?: boolean;\n  };\n  verification?: {\n    google?: string;\n  };\n};\n\nexport type PageMetadataInput = {\n  /**\n   * Page data from loadPage() or custom page object\n   */\n  page: LoadPageResult['page'] | {\n    name: string;\n    purpose?: string;\n  };\n\n  /**\n   * Site data from client.getSite()\n   */\n  site: SiteResponse['site'];\n\n  /**\n   * Current URL path (e.g., '/about', '/blog/post-1')\n   */\n  path: string;\n\n  /**\n   * Full site URL for canonical and OG URLs\n   * Example: 'https://example.com'\n   */\n  siteUrl: string;\n\n  /**\n   * Optional custom metadata overrides\n   */\n  overrides?: {\n    title?: string;\n    description?: string;\n    ogImage?: string;\n    canonicalUrl?: string;\n    robots?: {\n      index?: boolean;\n      follow?: boolean;\n    };\n  };\n\n  /**\n   * Optional Google site verification token\n   */\n  googleSiteVerification?: string;\n};\n\n/**\n * Generate Next.js Metadata object from Builder page data\n *\n * @example\n * ```tsx\n * import { generatePageMetadata } from '@riverbankcms/sdk/metadata';\n * import { loadPage } from '@riverbankcms/sdk';\n *\n * export async function generateMetadata({ params }) {\n *   const pageData = await loadPage({ client, siteId, path: params.slug });\n *   const siteData = await client.getSite({ id: siteId });\n *\n *   return generatePageMetadata({\n *     page: pageData.page,\n *     site: siteData.site,\n *     path: params.slug,\n *     siteUrl: 'https://example.com',\n *   });\n * }\n * ```\n */\nexport function generatePageMetadata(input: PageMetadataInput): Metadata {\n  const { page, site, path, siteUrl, overrides, googleSiteVerification } = input;\n\n  // Build page title\n  const pageTitle = overrides?.title ?? page.name;\n  const fullTitle = pageTitle === site.title ? pageTitle : `${pageTitle} | ${site.title}`;\n\n  // Use page purpose as description fallback\n  const description = overrides?.description ?? page.purpose;\n\n  // Build full URLs\n  const canonicalUrl = overrides?.canonicalUrl ?? `${siteUrl}${path}`;\n  const fullUrl = `${siteUrl}${path}`;\n\n  // Build metadata object\n  const metadata: Metadata = {\n    title: fullTitle,\n    description: description ?? undefined,\n    alternates: {\n      canonical: canonicalUrl,\n    },\n    openGraph: {\n      title: pageTitle,\n      description: description ?? undefined,\n      url: fullUrl,\n      siteName: site.title,\n      type: 'website',\n      ...(overrides?.ogImage\n        ? {\n            images: [\n              {\n                url: overrides.ogImage,\n                alt: pageTitle,\n              },\n            ],\n          }\n        : {}),\n    },\n    twitter: {\n      card: 'summary_large_image',\n      title: pageTitle,\n      description: description ?? undefined,\n      ...(overrides?.ogImage\n        ? {\n            images: [overrides.ogImage],\n          }\n        : {}),\n    },\n  };\n\n  // Add robots meta if specified\n  if (overrides?.robots) {\n    metadata.robots = {\n      index: overrides.robots.index ?? true,\n      follow: overrides.robots.follow ?? true,\n    };\n  }\n\n  // Add Google site verification if provided\n  if (googleSiteVerification) {\n    metadata.verification = {\n      google: googleSiteVerification,\n    };\n  }\n\n  return metadata;\n}\n\n/**\n * Generate metadata for preview/staging environments\n *\n * This helper adds noindex/nofollow robots tags to prevent search engines\n * from indexing preview or staging URLs.\n *\n * @example\n * ```tsx\n * export async function generateMetadata({ params }) {\n *   const pageData = await loadPage({ client, siteId, path: params.slug });\n *   const isPreview = process.env.VERCEL_ENV !== 'production';\n *\n *   return generatePreviewMetadata({\n *     page: pageData.page,\n *     site: siteData.site,\n *     path: params.slug,\n *     siteUrl: 'https://example.com',\n *   });\n * }\n * ```\n */\nexport function generatePreviewMetadata(input: PageMetadataInput): Metadata {\n  return generatePageMetadata({\n    ...input,\n    overrides: {\n      ...input.overrides,\n      robots: {\n        index: false,\n        follow: false,\n      },\n    },\n  });\n}\n"]}

package/dist/server/metadata.mjs

@@ -0,0 +1,68 @@
+// src/metadata/generatePageMetadata.ts
+function generatePageMetadata(input) {
+  const { page, site, path, siteUrl, overrides, googleSiteVerification } = input;
+  const pageTitle = overrides?.title ?? page.name;
+  const fullTitle = pageTitle === site.title ? pageTitle : `${pageTitle} | ${site.title}`;
+  const description = overrides?.description ?? page.purpose;
+  const canonicalUrl = overrides?.canonicalUrl ?? `${siteUrl}${path}`;
+  const fullUrl = `${siteUrl}${path}`;
+  const metadata = {
+    title: fullTitle,
+    description: description ?? void 0,
+    alternates: {
+      canonical: canonicalUrl
+    },
+    openGraph: {
+      title: pageTitle,
+      description: description ?? void 0,
+      url: fullUrl,
+      siteName: site.title,
+      type: "website",
+      ...overrides?.ogImage ? {
+        images: [
+          {
+            url: overrides.ogImage,
+            alt: pageTitle
+          }
+        ]
+      } : {}
+    },
+    twitter: {
+      card: "summary_large_image",
+      title: pageTitle,
+      description: description ?? void 0,
+      ...overrides?.ogImage ? {
+        images: [overrides.ogImage]
+      } : {}
+    }
+  };
+  if (overrides?.robots) {
+    metadata.robots = {
+      index: overrides.robots.index ?? true,
+      follow: overrides.robots.follow ?? true
+    };
+  }
+  if (googleSiteVerification) {
+    metadata.verification = {
+      google: googleSiteVerification
+    };
+  }
+  return metadata;
+}
+function generatePreviewMetadata(input) {
+  return generatePageMetadata({
+    ...input,
+    overrides: {
+      ...input.overrides,
+      robots: {
+        index: false,
+        follow: false
+      }
+    }
+  });
+}
+export {
+  generatePageMetadata,
+  generatePreviewMetadata
+};
+//# sourceMappingURL=metadata.mjs.map

package/dist/server/metadata.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/metadata/generatePageMetadata.ts"],"sourcesContent":["/**\n * Metadata generation helper for Next.js pages\n *\n * Generates SEO-optimized metadata from Builder page data for use in\n * Next.js generateMetadata() functions.\n */\n\nimport type { LoadPageResult } from '../rendering/helpers/loadPage';\nimport type { SiteResponse } from '../client/types';\n\n/**\n * Next.js Metadata type\n * Simplified version to avoid requiring Next.js as a dependency\n */\nexport type Metadata = {\n  title?: string;\n  description?: string;\n  alternates?: {\n    canonical?: string;\n  };\n  openGraph?: {\n    title?: string;\n    description?: string;\n    url?: string;\n    siteName?: string;\n    type?: string;\n    images?: Array<{\n      url: string;\n      alt?: string;\n    }>;\n  };\n  twitter?: {\n    card?: string;\n    title?: string;\n    description?: string;\n    images?: string[];\n  };\n  robots?: {\n    index?: boolean;\n    follow?: boolean;\n  };\n  verification?: {\n    google?: string;\n  };\n};\n\nexport type PageMetadataInput = {\n  /**\n   * Page data from loadPage() or custom page object\n   */\n  page: LoadPageResult['page'] | {\n    name: string;\n    purpose?: string;\n  };\n\n  /**\n   * Site data from client.getSite()\n   */\n  site: SiteResponse['site'];\n\n  /**\n   * Current URL path (e.g., '/about', '/blog/post-1')\n   */\n  path: string;\n\n  /**\n   * Full site URL for canonical and OG URLs\n   * Example: 'https://example.com'\n   */\n  siteUrl: string;\n\n  /**\n   * Optional custom metadata overrides\n   */\n  overrides?: {\n    title?: string;\n    description?: string;\n    ogImage?: string;\n    canonicalUrl?: string;\n    robots?: {\n      index?: boolean;\n      follow?: boolean;\n    };\n  };\n\n  /**\n   * Optional Google site verification token\n   */\n  googleSiteVerification?: string;\n};\n\n/**\n * Generate Next.js Metadata object from Builder page data\n *\n * @example\n * ```tsx\n * import { generatePageMetadata } from '@riverbankcms/sdk/metadata';\n * import { loadPage } from '@riverbankcms/sdk';\n *\n * export async function generateMetadata({ params }) {\n *   const pageData = await loadPage({ client, siteId, path: params.slug });\n *   const siteData = await client.getSite({ id: siteId });\n *\n *   return generatePageMetadata({\n *     page: pageData.page,\n *     site: siteData.site,\n *     path: params.slug,\n *     siteUrl: 'https://example.com',\n *   });\n * }\n * ```\n */\nexport function generatePageMetadata(input: PageMetadataInput): Metadata {\n  const { page, site, path, siteUrl, overrides, googleSiteVerification } = input;\n\n  // Build page title\n  const pageTitle = overrides?.title ?? page.name;\n  const fullTitle = pageTitle === site.title ? pageTitle : `${pageTitle} | ${site.title}`;\n\n  // Use page purpose as description fallback\n  const description = overrides?.description ?? page.purpose;\n\n  // Build full URLs\n  const canonicalUrl = overrides?.canonicalUrl ?? `${siteUrl}${path}`;\n  const fullUrl = `${siteUrl}${path}`;\n\n  // Build metadata object\n  const metadata: Metadata = {\n    title: fullTitle,\n    description: description ?? undefined,\n    alternates: {\n      canonical: canonicalUrl,\n    },\n    openGraph: {\n      title: pageTitle,\n      description: description ?? undefined,\n      url: fullUrl,\n      siteName: site.title,\n      type: 'website',\n      ...(overrides?.ogImage\n        ? {\n            images: [\n              {\n                url: overrides.ogImage,\n                alt: pageTitle,\n              },\n            ],\n          }\n        : {}),\n    },\n    twitter: {\n      card: 'summary_large_image',\n      title: pageTitle,\n      description: description ?? undefined,\n      ...(overrides?.ogImage\n        ? {\n            images: [overrides.ogImage],\n          }\n        : {}),\n    },\n  };\n\n  // Add robots meta if specified\n  if (overrides?.robots) {\n    metadata.robots = {\n      index: overrides.robots.index ?? true,\n      follow: overrides.robots.follow ?? true,\n    };\n  }\n\n  // Add Google site verification if provided\n  if (googleSiteVerification) {\n    metadata.verification = {\n      google: googleSiteVerification,\n    };\n  }\n\n  return metadata;\n}\n\n/**\n * Generate metadata for preview/staging environments\n *\n * This helper adds noindex/nofollow robots tags to prevent search engines\n * from indexing preview or staging URLs.\n *\n * @example\n * ```tsx\n * export async function generateMetadata({ params }) {\n *   const pageData = await loadPage({ client, siteId, path: params.slug });\n *   const isPreview = process.env.VERCEL_ENV !== 'production';\n *\n *   return generatePreviewMetadata({\n *     page: pageData.page,\n *     site: siteData.site,\n *     path: params.slug,\n *     siteUrl: 'https://example.com',\n *   });\n * }\n * ```\n */\nexport function generatePreviewMetadata(input: PageMetadataInput): Metadata {\n  return generatePageMetadata({\n    ...input,\n    overrides: {\n      ...input.overrides,\n      robots: {\n        index: false,\n        follow: false,\n      },\n    },\n  });\n}\n"],"mappings":";AAgHO,SAAS,qBAAqB,OAAoC;AACvE,QAAM,EAAE,MAAM,MAAM,MAAM,SAAS,WAAW,uBAAuB,IAAI;AAGzE,QAAM,YAAY,WAAW,SAAS,KAAK;AAC3C,QAAM,YAAY,cAAc,KAAK,QAAQ,YAAY,GAAG,SAAS,MAAM,KAAK,KAAK;AAGrF,QAAM,cAAc,WAAW,eAAe,KAAK;AAGnD,QAAM,eAAe,WAAW,gBAAgB,GAAG,OAAO,GAAG,IAAI;AACjE,QAAM,UAAU,GAAG,OAAO,GAAG,IAAI;AAGjC,QAAM,WAAqB;AAAA,IACzB,OAAO;AAAA,IACP,aAAa,eAAe;AAAA,IAC5B,YAAY;AAAA,MACV,WAAW;AAAA,IACb;AAAA,IACA,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa,eAAe;AAAA,MAC5B,KAAK;AAAA,MACL,UAAU,KAAK;AAAA,MACf,MAAM;AAAA,MACN,GAAI,WAAW,UACX;AAAA,QACE,QAAQ;AAAA,UACN;AAAA,YACE,KAAK,UAAU;AAAA,YACf,KAAK;AAAA,UACP;AAAA,QACF;AAAA,MACF,IACA,CAAC;AAAA,IACP;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa,eAAe;AAAA,MAC5B,GAAI,WAAW,UACX;AAAA,QACE,QAAQ,CAAC,UAAU,OAAO;AAAA,MAC5B,IACA,CAAC;AAAA,IACP;AAAA,EACF;AAGA,MAAI,WAAW,QAAQ;AACrB,aAAS,SAAS;AAAA,MAChB,OAAO,UAAU,OAAO,SAAS;AAAA,MACjC,QAAQ,UAAU,OAAO,UAAU;AAAA,IACrC;AAAA,EACF;AAGA,MAAI,wBAAwB;AAC1B,aAAS,eAAe;AAAA,MACtB,QAAQ;AAAA,IACV;AAAA,EACF;AAEA,SAAO;AACT;AAuBO,SAAS,wBAAwB,OAAoC;AAC1E,SAAO,qBAAqB;AAAA,IAC1B,GAAG;AAAA,IACH,WAAW;AAAA,MACT,GAAG,MAAM;AAAA,MACT,QAAQ;AAAA,QACN,OAAO;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}