@riverbankcms/sdk 0.6.1 → 0.7.2

package/dist/server/chunk-AET56TQX.mjs

@@ -0,0 +1,45 @@
+// src/webhooks/verify.ts
+import crypto from "crypto";
+import { z } from "zod";
+var WebhookPayloadSchema = z.object({
+  /** Event type (e.g., 'page.published', 'entry.published') */
+  event: z.string(),
+  /** ISO timestamp of when the event occurred */
+  timestamp: z.string(),
+  /** Site ID that triggered the event */
+  siteId: z.string(),
+  /** Event-specific data (varies by event type) */
+  data: z.record(z.string(), z.any()),
+  /** Cache invalidation tags (for tag-based revalidation) */
+  tags: z.array(z.string()).optional()
+});
+function verifyWebhookSignature(payload, signature, secret) {
+  const expectedSignature = crypto.createHmac("sha256", secret).update(payload).digest("hex");
+  if (signature.length !== expectedSignature.length) {
+    return false;
+  }
+  return crypto.timingSafeEqual(
+    Buffer.from(signature),
+    Buffer.from(expectedSignature)
+  );
+}
+function parseWebhookPayload(body) {
+  let parsed;
+  try {
+    parsed = JSON.parse(body);
+  } catch {
+    return { success: false, error: "Invalid JSON" };
+  }
+  const result = WebhookPayloadSchema.safeParse(parsed);
+  if (!result.success) {
+    return { success: false, error: `Invalid payload: ${result.error.message}` };
+  }
+  return { success: true, payload: result.data };
+}
+
+export {
+  WebhookPayloadSchema,
+  verifyWebhookSignature,
+  parseWebhookPayload
+};
+//# sourceMappingURL=chunk-AET56TQX.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/webhooks/verify.ts"],"sourcesContent":["/**\n * Webhook verification utilities for Riverbank SDK\n *\n * Provides framework-agnostic webhook signature verification and payload parsing.\n */\n\nimport crypto from 'crypto';\nimport { z } from 'zod';\n\n/**\n * Zod schema for webhook payload validation.\n */\nexport const WebhookPayloadSchema = z.object({\n  /** Event type (e.g., 'page.published', 'entry.published') */\n  event: z.string(),\n  /** ISO timestamp of when the event occurred */\n  timestamp: z.string(),\n  /** Site ID that triggered the event */\n  siteId: z.string(),\n  /** Event-specific data (varies by event type) */\n  data: z.record(z.string(), z.any()),\n  /** Cache invalidation tags (for tag-based revalidation) */\n  tags: z.array(z.string()).optional(),\n});\n\n/**\n * Webhook payload structure sent by the CMS.\n */\nexport type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;\n\n/**\n * Verify a webhook signature using HMAC-SHA256.\n *\n * Uses timing-safe comparison to prevent timing attacks.\n *\n * @param payload - The raw request body as a string\n * @param signature - The X-Riverbank-Signature header value\n * @param secret - The webhook signing secret (RIVERBANK_WEBHOOK_SECRET)\n * @returns true if signature is valid, false otherwise\n *\n * @example\n * ```ts\n * const body = await request.text();\n * const signature = request.headers.get('x-riverbank-signature');\n * const secret = process.env.RIVERBANK_WEBHOOK_SECRET;\n *\n * if (!verifyWebhookSignature(body, signature, secret)) {\n *   return new Response('Invalid signature', { status: 401 });\n * }\n * ```\n */\nexport function verifyWebhookSignature(\n  payload: string,\n  signature: string,\n  secret: string\n): boolean {\n  const expectedSignature = crypto\n    .createHmac('sha256', secret)\n    .update(payload)\n    .digest('hex');\n\n  // Length check before timing-safe comparison\n  // timingSafeEqual throws if lengths differ\n  if (signature.length !== expectedSignature.length) {\n    return false;\n  }\n\n  // Timing-safe comparison to prevent timing attacks\n  return crypto.timingSafeEqual(\n    Buffer.from(signature),\n    Buffer.from(expectedSignature)\n  );\n}\n\n/**\n * Result type for webhook payload parsing.\n */\nexport type ParseWebhookResult =\n  | { success: true; payload: WebhookPayload }\n  | { success: false; error: string };\n\n/**\n * Parse and validate a webhook payload from the request body.\n *\n * Uses Zod schema validation to ensure the payload has the expected structure.\n *\n * @param body - The raw request body as a string\n * @returns A result object with either the validated payload or an error message\n *\n * @example\n * ```ts\n * const body = await request.text();\n * const result = parseWebhookPayload(body);\n * if (!result.success) {\n *   return new Response(result.error, { status: 400 });\n * }\n * console.log(`Received ${result.payload.event} for site ${result.payload.siteId}`);\n * ```\n */\nexport function parseWebhookPayload(body: string): ParseWebhookResult {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(body);\n  } catch {\n    return { success: false, error: 'Invalid JSON' };\n  }\n\n  const result = WebhookPayloadSchema.safeParse(parsed);\n  if (!result.success) {\n    return { success: false, error: `Invalid payload: ${result.error.message}` };\n  }\n\n  return { success: true, payload: result.data };\n}\n"],"mappings":";AAMA,OAAO,YAAY;AACnB,SAAS,SAAS;AAKX,IAAM,uBAAuB,EAAE,OAAO;AAAA;AAAA,EAE3C,OAAO,EAAE,OAAO;AAAA;AAAA,EAEhB,WAAW,EAAE,OAAO;AAAA;AAAA,EAEpB,QAAQ,EAAE,OAAO;AAAA;AAAA,EAEjB,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,IAAI,CAAC;AAAA;AAAA,EAElC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;AACrC,CAAC;AA4BM,SAAS,uBACd,SACA,WACA,QACS;AACT,QAAM,oBAAoB,OACvB,WAAW,UAAU,MAAM,EAC3B,OAAO,OAAO,EACd,OAAO,KAAK;AAIf,MAAI,UAAU,WAAW,kBAAkB,QAAQ;AACjD,WAAO;AAAA,EACT;AAGA,SAAO,OAAO;AAAA,IACZ,OAAO,KAAK,SAAS;AAAA,IACrB,OAAO,KAAK,iBAAiB;AAAA,EAC/B;AACF;AA2BO,SAAS,oBAAoB,MAAkC;AACpE,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,IAAI;AAAA,EAC1B,QAAQ;AACN,WAAO,EAAE,SAAS,OAAO,OAAO,eAAe;AAAA,EACjD;AAEA,QAAM,SAAS,qBAAqB,UAAU,MAAM;AACpD,MAAI,CAAC,OAAO,SAAS;AACnB,WAAO,EAAE,SAAS,OAAO,OAAO,oBAAoB,OAAO,MAAM,OAAO,GAAG;AAAA,EAC7E;AAEA,SAAO,EAAE,SAAS,MAAM,SAAS,OAAO,KAAK;AAC/C;","names":[]}

package/dist/server/chunk-ARNCLSQT.mjs

@@ -0,0 +1,52 @@
+import {
+  PageRenderer,
+  buildThemeRuntime
+} from "./chunk-LNOUXALA.mjs";
+
+// src/rendering/components/Page.tsx
+import { jsx } from "react/jsx-runtime";
+function Page({
+  page,
+  theme,
+  themeTokens: providedTokens,
+  siteId,
+  resolvedData,
+  routeMap,
+  wrapBlock,
+  registry,
+  usePlaceholders = false,
+  blockOverrides,
+  sdkConfig,
+  supabaseUrl,
+  dataContext
+}) {
+  const baseTokens = providedTokens ?? buildThemeRuntime(theme).tokens;
+  const themeTokens = sdkConfig?.theme?.palette ? { ...baseTokens, palette: { ...baseTokens.palette, ...sdkConfig.theme.palette } } : baseTokens;
+  return /* @__PURE__ */ jsx(
+    PageRenderer,
+    {
+      theme,
+      page,
+      themeTokens,
+      usePlaceholders,
+      dataContext: {
+        siteId,
+        resolvedData,
+        routes: routeMap,
+        occurrenceContext: dataContext?.occurrenceContext ?? null,
+        contentEntry: dataContext?.contentEntry ?? null,
+        supabaseUrl
+      },
+      routeMap,
+      wrapBlock,
+      registry,
+      blockOverrides,
+      sdkConfig
+    }
+  );
+}
+
+export {
+  Page
+};
+//# sourceMappingURL=chunk-ARNCLSQT.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/rendering/components/Page.tsx"],"sourcesContent":["/**\n * Pure Page renderer component for Riverbank CMS.\n *\n * This component expects all data to be provided via props.\n * For data fetching, use:\n * - Server-side: `await loadPage({ client, siteId, path })`\n * - Client-side: `usePage({ client, siteId, path })`\n */\n\nimport { PageRenderer, buildThemeRuntime } from '@riverbankcms/blocks';\nimport type { PageOutline, RouteMap, Theme, ThemeTokens, BlockOverrides, OccurrenceContextData } from '@riverbankcms/blocks';\nimport type { ResolvedBlockData } from '../../data';\nimport type { RuntimeSdkConfig } from '../helpers/loadPage';\n\n// Re-export OccurrenceContextData for SDK consumers\nexport type { OccurrenceContextData };\n\nexport type PageProps = {\n  // Required data (must be provided by caller)\n  page: PageOutline;\n  theme: Theme;\n  siteId: string;\n\n  // Optional data\n  themeTokens?: ThemeTokens; // If not provided, will be built from theme\n  resolvedData?: ResolvedBlockData; // Pre-fetched block data\n  routeMap?: RouteMap;\n  /**\n   * SDK site configuration containing theme palette overrides.\n   * When provided, the SDK palette tokens are merged into the theme tokens,\n   * allowing blocks to use SDK-defined color tokens for section backgrounds.\n   */\n  sdkConfig?: RuntimeSdkConfig | null;\n  /**\n   * Supabase storage URL for direct image access.\n   * SDK sites receive this from the API instead of requiring NEXT_PUBLIC_SUPABASE_URL env var.\n   */\n  supabaseUrl?: string;\n\n  /**\n   * Additional context data for content entry pages.\n   * Used to pass occurrence context and content entry data to blocks.\n   */\n  dataContext?: {\n    /** Occurrence context for event pages (from URL like /events/yoga/2025-01-15) */\n    occurrenceContext?: OccurrenceContextData | null;\n    /** Content entry data for template pages */\n    contentEntry?: Record<string, unknown> | null;\n  };\n\n  // Customization\n  wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;\n  registry?: Parameters<typeof PageRenderer>[0]['registry'];\n  usePlaceholders?: boolean;\n  /**\n   * Custom components to override default block rendering.\n   * Keys can be full block kind (\"block.hero\") or short form (\"hero\").\n   *\n   * This is SSR-safe - no context or hooks required.\n   *\n   * @example\n   * ```tsx\n   * <Page\n   *   {...pageData}\n   *   blockOverrides={{\n   *     'hero': MyCustomHero,\n   *     'block.testimonials': MyCustomTestimonials,\n   *   }}\n   * />\n   * ```\n   */\n  blockOverrides?: BlockOverrides;\n};\n\n/**\n * Pure renderer for Riverbank CMS pages.\n *\n * This component expects all data to be provided via props.\n * For data fetching, use:\n * - Server-side: `await loadPage({ client, siteId, path })`\n * - Client-side: `usePage({ client, siteId, path })`\n *\n * @example Server-side (Next.js App Router)\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { loadPage, Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({ apiKey, baseUrl });\n *\n * export default async function PageRoute({ params }) {\n *   const pageData = await loadPage({\n *     client,\n *     siteId: 'site-id',\n *     path: `/${params.slug}`,\n *   });\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n *\n * @example Client-side\n * ```tsx\n * import { createRiverbankClient } from '@riverbankcms/sdk';\n * import { usePage, Page } from '@riverbankcms/sdk/rendering';\n *\n * const client = createRiverbankClient({ apiKey, baseUrl });\n *\n * function MyPage({ path }) {\n *   const pageData = usePage({ client, siteId: 'site-id', path });\n *\n *   if (pageData.loading) return <LoadingState />;\n *   if (pageData.error) return <ErrorState error={pageData.error} />;\n *   if (!pageData.page) return <NotFound />;\n *\n *   return <Page {...pageData} />;\n * }\n * ```\n */\nexport function Page({\n  page,\n  theme,\n  themeTokens: providedTokens,\n  siteId,\n  resolvedData,\n  routeMap,\n  wrapBlock,\n  registry,\n  usePlaceholders = false,\n  blockOverrides,\n  sdkConfig,\n  supabaseUrl,\n  dataContext,\n}: PageProps) {\n  // Build theme tokens if not provided\n  const baseTokens = providedTokens ?? buildThemeRuntime(theme).tokens;\n\n  // Merge SDK palette tokens into theme tokens\n  // This allows blocks to resolve SDK-defined color tokens (e.g., 'primary' -> '#6d28d9')\n  const themeTokens = sdkConfig?.theme?.palette\n    ? { ...baseTokens, palette: { ...baseTokens.palette, ...sdkConfig.theme.palette } }\n    : baseTokens;\n\n  return (\n    <PageRenderer\n      theme={theme}\n      page={page}\n      themeTokens={themeTokens}\n      usePlaceholders={usePlaceholders}\n      dataContext={{\n        siteId,\n        resolvedData,\n        routes: routeMap,\n        occurrenceContext: dataContext?.occurrenceContext ?? null,\n        contentEntry: dataContext?.contentEntry ?? null,\n        supabaseUrl,\n      }}\n      routeMap={routeMap}\n      wrapBlock={wrapBlock}\n      registry={registry}\n      blockOverrides={blockOverrides}\n      sdkConfig={sdkConfig}\n    />\n  );\n}\n"],"mappings":";;;;;;AA+II;AAzBG,SAAS,KAAK;AAAA,EACnB;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAc;AAEZ,QAAM,aAAa,kBAAkB,kBAAkB,KAAK,EAAE;AAI9D,QAAM,cAAc,WAAW,OAAO,UAClC,EAAE,GAAG,YAAY,SAAS,EAAE,GAAG,WAAW,SAAS,GAAG,UAAU,MAAM,QAAQ,EAAE,IAChF;AAEJ,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,aAAa;AAAA,QACX;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR,mBAAmB,aAAa,qBAAqB;AAAA,QACrD,cAAc,aAAa,gBAAgB;AAAA,QAC3C;AAAA,MACF;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/server/chunk-BNQV3PXP.js

@@ -0,0 +1,69 @@
+"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=chunk-BNQV3PXP.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-BNQV3PXP.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;AACA","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-BNQV3PXP.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"]}