@riverbankcms/sdk 0.7.4 → 0.7.5

package/dist/server/{chunk-74XUVNOO.mjs → chunk-4YQJUL5W.mjs}

@@ -95,10 +95,12 @@ function validateAndConvertBlock(block, source) {
     if (typeof blockRecord.purpose !== "string") {
       throw new Error(`Invalid block purpose in ${source}: expected string, got ${typeof blockRecord.purpose}`);
     }
+    const content2 = blockRecord.content ?? {};
     return {
       id: blockRecord.id,
       kind: kindValue,
-      purpose: blockRecord.purpose
+      purpose: blockRecord.purpose,
+      content: content2
     };
   }
   const scope = blockRecord.scope;
@@ -139,4 +141,4 @@ export {
   isEntryContent,
   loadContent
 };
-//# sourceMappingURL=chunk-74XUVNOO.mjs.map
+//# sourceMappingURL=chunk-4YQJUL5W.mjs.map

package/dist/server/{chunk-74XUVNOO.mjs.map → chunk-4YQJUL5W.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../src/rendering/helpers/loadContent.ts"],"sourcesContent":["/**\n * Server-side helper to fetch content (page or entry) by path.\n *\n * Use this for dynamic routing where a path could resolve to either\n * a page or a content entry.\n */\n\nimport type { Theme } from '@riverbankcms/blocks';\nimport type { RiverbankClient, PageResponse, SiteResponse } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\nimport type { ResolvedBlockData } from '../../data/prefetchBlockData';\n\n/**\n * Site data included in content results for metadata generation.\n */\nexport type SiteData = SiteResponse['site'];\n\nexport type LoadContentParams = {\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 * Content entry data returned when a path resolves to an entry\n */\nexport type ContentEntryData = {\n  id: string;\n  /** Content type key (e.g., 'blog-post', 'product') */\n  type: string | null;\n  title: string;\n  slug: string | null;\n  path: string | null;\n  status: string;\n  publishAt: string | null;\n  /** The raw content fields - use these to render your own UI */\n  content: Record<string, unknown>;\n  metaTitle: string | null;\n  metaDescription: string | null;\n  createdAt: string;\n  updatedAt: string;\n};\n\n/**\n * Result when path resolves to a page\n */\nexport type PageContentResult = {\n  type: 'page';\n  /** Page outline ready for rendering with <Page> component */\n  page: PageProps['page'];\n  /** Site theme for styling */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n  /** Pre-fetched block data for data loaders */\n  resolvedData: ResolvedBlockData;\n  /** Site data for metadata generation */\n  site: SiteData;\n};\n\n/**\n * Result when path resolves to a content entry\n */\nexport type EntryContentResult = {\n  type: 'entry';\n  /** Raw entry data - render this however you want */\n  entry: ContentEntryData;\n  /** Template page for rendering the entry (if available) */\n  templatePage: PageProps['page'] | null;\n  /** Pre-fetched block data for template page data loaders */\n  resolvedData: ResolvedBlockData;\n  /** Data context for template blocks (includes entry content for bindings) */\n  dataContext: { contentEntry: Record<string, unknown> };\n  /** Site theme for styling (useful if rendering with SDK components) */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n  /** Site data for metadata generation */\n  site: SiteData;\n};\n\n/**\n * Discriminated union result from loadContent\n */\nexport type LoadContentResult = PageContentResult | EntryContentResult;\n\n/**\n * Type guard to check if result is a page\n */\nexport function isPageContent(result: LoadContentResult): result is PageContentResult {\n  return result.type === 'page';\n}\n\n/**\n * Type guard to check if result is an entry\n */\nexport function isEntryContent(result: LoadContentResult): result is EntryContentResult {\n  return result.type === 'entry';\n}\n\n/**\n * Server-side helper to fetch content by path.\n *\n * Returns a discriminated union - either page data (ready for `<Page>` component)\n * or raw entry data (for custom rendering).\n *\n * @example Dynamic routing with both pages and entries\n * ```tsx\n * import { loadContent, Page, isPageContent } from '@riverbankcms/sdk';\n *\n * export default async function DynamicRoute({ params }) {\n *   const content = await loadContent({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug?.join('/') || ''}`,\n *   });\n *\n *   if (isPageContent(content)) {\n *     return <Page {...content} />;\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 = await loadContent({ client, siteId, path });\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 *     default:\n *       return <GenericEntry entry={content.entry} />;\n *   }\n * }\n *\n * return <Page {...content} />;\n * ```\n *\n * @example Preview mode for draft content\n * ```tsx\n * const content = await loadContent({\n *   client,\n *   siteId,\n *   path,\n *   preview: true, // Fetches draft content for both pages and entries\n * });\n * ```\n */\nexport async function loadContent(params: LoadContentParams): Promise<LoadContentResult> {\n  const { client, siteId, path, preview = false } = params;\n\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  // 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      // Use draft content in preview mode, otherwise use published content\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    // Process template if available (uses first template from content type)\n    const { templatePage, resolvedData } = await processEntryTemplate(\n      contentResponse.templates as Template[] | undefined,\n      entry,\n      { siteId, preview },\n      client\n    );\n\n    return {\n      type: 'entry',\n      entry,\n      templatePage,\n      resolvedData,\n      dataContext: { contentEntry: entry.content },\n      theme: site.theme,\n      siteId,\n      site: site.site,\n    };\n  }\n\n  // Handle page response\n  const { page: pageData } = contentResponse;\n\n  // Convert API response blocks to PageOutline format with validation\n  const blocks = pageData.blocks.map((block) => validateAndConvertBlock(block, 'page'));\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  return {\n    type: 'page',\n    page: pageOutline,\n    theme: site.theme,\n    siteId,\n    resolvedData,\n    site: site.site,\n  };\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/**\n * Validates and converts a raw block from API response to PageOutline block format.\n * Used for both page blocks and template blocks to ensure consistent validation.\n */\nfunction validateAndConvertBlock(\n  block: unknown,\n  source: 'page' | 'template'\n): { id: string | null; kind: string; purpose: string; content?: Record<string, unknown> } {\n  if (!block || typeof block !== 'object') {\n    throw new Error(`Invalid block format in ${source} API response`);\n  }\n\n  const blockRecord = block as Record<string, unknown>;\n\n  // Template blocks use 'blockKind', page blocks use 'kind'\n  const kindField = source === 'template' ? 'blockKind' : 'kind';\n  const kindValue = blockRecord[kindField];\n\n  if (typeof blockRecord.id !== 'string' && blockRecord.id !== null) {\n    throw new Error(`Invalid block id in ${source}: expected string or null, got ${typeof blockRecord.id}`);\n  }\n  if (typeof kindValue !== 'string') {\n    throw new Error(`Invalid block ${kindField} in ${source}: expected string, got ${typeof kindValue}`);\n  }\n\n  // Template blocks derive purpose from scope, page blocks have explicit purpose\n  if (source === 'page') {\n    if (typeof blockRecord.purpose !== 'string') {\n      throw new Error(`Invalid block purpose in ${source}: expected string, got ${typeof blockRecord.purpose}`);\n    }\n    return {\n      id: blockRecord.id as string | null,\n      kind: kindValue,\n      purpose: blockRecord.purpose,\n    };\n  }\n\n  // Template block: derive purpose from scope, include content\n  const scope = blockRecord.scope as 'entry' | 'template' | undefined;\n  const content = (blockRecord.content as Record<string, unknown> | null) ?? {};\n\n  return {\n    id: blockRecord.id as string | null,\n    kind: kindValue,\n    purpose: scope === 'entry' ? 'entry-content' : 'template-layout',\n    content,\n  };\n}\n\n/** Template block structure from API response */\ntype TemplateBlock = {\n  id: string;\n  blockKind: string;\n  scope: 'entry' | 'template';\n  content: Record<string, unknown> | null;\n};\n\n/** Template structure from API response */\ntype Template = {\n  id: string;\n  name: string;\n  templateKey: string;\n  blocks: TemplateBlock[];\n};\n\n/**\n * Processes an entry's template into a PageOutline format and prefetches block data.\n * Returns null templatePage if no valid template with blocks is available.\n */\nasync function processEntryTemplate(\n  templates: Template[] | undefined,\n  entry: ContentEntryData,\n  context: { siteId: string; preview: boolean },\n  client: RiverbankClient\n): Promise<{ templatePage: PageProps['page'] | null; resolvedData: ResolvedBlockData }> {\n  const template = templates?.[0];\n\n  // Templates without blocks are treated as \"no template\" - the entry should be\n  // rendered with custom UI rather than an empty template page\n  if (!template || !template.blocks?.length) {\n    return { templatePage: null, resolvedData: {} };\n  }\n\n  // Convert template blocks to PageOutline format with validation\n  const blocks = template.blocks.map((block) => validateAndConvertBlock(block, 'template'));\n\n  const templatePage: PageProps['page'] = {\n    name: template.name || 'Entry Template',\n    path: entry.path || '/',\n    purpose: 'entry-template',\n    blocks,\n  };\n\n  // Prefetch block data for template\n  const resolvedData = await prefetchBlockData(\n    templatePage,\n    {\n      siteId: context.siteId,\n      pageId: template.id,\n      previewStage: context.preview ? 'preview' : 'published',\n    },\n    client\n  );\n\n  return { templatePage, resolvedData };\n}\n"],"mappings":"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","names":["resolvedData"]}
+{"version":3,"sources":["../../src/rendering/helpers/loadContent.ts"],"sourcesContent":["/**\n * Server-side helper to fetch content (page or entry) by path.\n *\n * Use this for dynamic routing where a path could resolve to either\n * a page or a content entry.\n */\n\nimport type { Theme } from '@riverbankcms/blocks';\nimport type { RiverbankClient, PageResponse, SiteResponse } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\nimport type { ResolvedBlockData } from '../../data/prefetchBlockData';\n\n/**\n * Site data included in content results for metadata generation.\n */\nexport type SiteData = SiteResponse['site'];\n\nexport type LoadContentParams = {\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 * Content entry data returned when a path resolves to an entry\n */\nexport type ContentEntryData = {\n  id: string;\n  /** Content type key (e.g., 'blog-post', 'product') */\n  type: string | null;\n  title: string;\n  slug: string | null;\n  path: string | null;\n  status: string;\n  publishAt: string | null;\n  /** The raw content fields - use these to render your own UI */\n  content: Record<string, unknown>;\n  metaTitle: string | null;\n  metaDescription: string | null;\n  createdAt: string;\n  updatedAt: string;\n};\n\n/**\n * Result when path resolves to a page\n */\nexport type PageContentResult = {\n  type: 'page';\n  /** Page outline ready for rendering with <Page> component */\n  page: PageProps['page'];\n  /** Site theme for styling */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n  /** Pre-fetched block data for data loaders */\n  resolvedData: ResolvedBlockData;\n  /** Site data for metadata generation */\n  site: SiteData;\n};\n\n/**\n * Result when path resolves to a content entry\n */\nexport type EntryContentResult = {\n  type: 'entry';\n  /** Raw entry data - render this however you want */\n  entry: ContentEntryData;\n  /** Template page for rendering the entry (if available) */\n  templatePage: PageProps['page'] | null;\n  /** Pre-fetched block data for template page data loaders */\n  resolvedData: ResolvedBlockData;\n  /** Data context for template blocks (includes entry content for bindings) */\n  dataContext: { contentEntry: Record<string, unknown> };\n  /** Site theme for styling (useful if rendering with SDK components) */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n  /** Site data for metadata generation */\n  site: SiteData;\n};\n\n/**\n * Discriminated union result from loadContent\n */\nexport type LoadContentResult = PageContentResult | EntryContentResult;\n\n/**\n * Type guard to check if result is a page\n */\nexport function isPageContent(result: LoadContentResult): result is PageContentResult {\n  return result.type === 'page';\n}\n\n/**\n * Type guard to check if result is an entry\n */\nexport function isEntryContent(result: LoadContentResult): result is EntryContentResult {\n  return result.type === 'entry';\n}\n\n/**\n * Server-side helper to fetch content by path.\n *\n * Returns a discriminated union - either page data (ready for `<Page>` component)\n * or raw entry data (for custom rendering).\n *\n * @example Dynamic routing with both pages and entries\n * ```tsx\n * import { loadContent, Page, isPageContent } from '@riverbankcms/sdk';\n *\n * export default async function DynamicRoute({ params }) {\n *   const content = await loadContent({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug?.join('/') || ''}`,\n *   });\n *\n *   if (isPageContent(content)) {\n *     return <Page {...content} />;\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 = await loadContent({ client, siteId, path });\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 *     default:\n *       return <GenericEntry entry={content.entry} />;\n *   }\n * }\n *\n * return <Page {...content} />;\n * ```\n *\n * @example Preview mode for draft content\n * ```tsx\n * const content = await loadContent({\n *   client,\n *   siteId,\n *   path,\n *   preview: true, // Fetches draft content for both pages and entries\n * });\n * ```\n */\nexport async function loadContent(params: LoadContentParams): Promise<LoadContentResult> {\n  const { client, siteId, path, preview = false } = params;\n\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  // 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      // Use draft content in preview mode, otherwise use published content\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    // Process template if available (uses first template from content type)\n    const { templatePage, resolvedData } = await processEntryTemplate(\n      contentResponse.templates as Template[] | undefined,\n      entry,\n      { siteId, preview },\n      client\n    );\n\n    return {\n      type: 'entry',\n      entry,\n      templatePage,\n      resolvedData,\n      dataContext: { contentEntry: entry.content },\n      theme: site.theme,\n      siteId,\n      site: site.site,\n    };\n  }\n\n  // Handle page response\n  const { page: pageData } = contentResponse;\n\n  // Convert API response blocks to PageOutline format with validation\n  const blocks = pageData.blocks.map((block) => validateAndConvertBlock(block, 'page'));\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  return {\n    type: 'page',\n    page: pageOutline,\n    theme: site.theme,\n    siteId,\n    resolvedData,\n    site: site.site,\n  };\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/**\n * Validates and converts a raw block from API response to PageOutline block format.\n * Used for both page blocks and template blocks to ensure consistent validation.\n */\nfunction validateAndConvertBlock(\n  block: unknown,\n  source: 'page' | 'template'\n): { id: string | null; kind: string; purpose: string; content?: Record<string, unknown> } {\n  if (!block || typeof block !== 'object') {\n    throw new Error(`Invalid block format in ${source} API response`);\n  }\n\n  const blockRecord = block as Record<string, unknown>;\n\n  // Template blocks use 'blockKind', page blocks use 'kind'\n  const kindField = source === 'template' ? 'blockKind' : 'kind';\n  const kindValue = blockRecord[kindField];\n\n  if (typeof blockRecord.id !== 'string' && blockRecord.id !== null) {\n    throw new Error(`Invalid block id in ${source}: expected string or null, got ${typeof blockRecord.id}`);\n  }\n  if (typeof kindValue !== 'string') {\n    throw new Error(`Invalid block ${kindField} in ${source}: expected string, got ${typeof kindValue}`);\n  }\n\n  // Template blocks derive purpose from scope, page blocks have explicit purpose\n  if (source === 'page') {\n    if (typeof blockRecord.purpose !== 'string') {\n      throw new Error(`Invalid block purpose in ${source}: expected string, got ${typeof blockRecord.purpose}`);\n    }\n    // Include content for page blocks - required for data loader binding resolution\n    const content = (blockRecord.content as Record<string, unknown> | null) ?? {};\n    return {\n      id: blockRecord.id as string | null,\n      kind: kindValue,\n      purpose: blockRecord.purpose,\n      content,\n    };\n  }\n\n  // Template block: derive purpose from scope, include content\n  const scope = blockRecord.scope as 'entry' | 'template' | undefined;\n  const content = (blockRecord.content as Record<string, unknown> | null) ?? {};\n\n  return {\n    id: blockRecord.id as string | null,\n    kind: kindValue,\n    purpose: scope === 'entry' ? 'entry-content' : 'template-layout',\n    content,\n  };\n}\n\n/** Template block structure from API response */\ntype TemplateBlock = {\n  id: string;\n  blockKind: string;\n  scope: 'entry' | 'template';\n  content: Record<string, unknown> | null;\n};\n\n/** Template structure from API response */\ntype Template = {\n  id: string;\n  name: string;\n  templateKey: string;\n  blocks: TemplateBlock[];\n};\n\n/**\n * Processes an entry's template into a PageOutline format and prefetches block data.\n * Returns null templatePage if no valid template with blocks is available.\n */\nasync function processEntryTemplate(\n  templates: Template[] | undefined,\n  entry: ContentEntryData,\n  context: { siteId: string; preview: boolean },\n  client: RiverbankClient\n): Promise<{ templatePage: PageProps['page'] | null; resolvedData: ResolvedBlockData }> {\n  const template = templates?.[0];\n\n  // Templates without blocks are treated as \"no template\" - the entry should be\n  // rendered with custom UI rather than an empty template page\n  if (!template || !template.blocks?.length) {\n    return { templatePage: null, resolvedData: {} };\n  }\n\n  // Convert template blocks to PageOutline format with validation\n  const blocks = template.blocks.map((block) => validateAndConvertBlock(block, 'template'));\n\n  const templatePage: PageProps['page'] = {\n    name: template.name || 'Entry Template',\n    path: entry.path || '/',\n    purpose: 'entry-template',\n    blocks,\n  };\n\n  // Prefetch block data for template\n  const resolvedData = await prefetchBlockData(\n    templatePage,\n    {\n      siteId: context.siteId,\n      pageId: template.id,\n      previewStage: context.preview ? 'preview' : 'published',\n    },\n    client\n  );\n\n  return { templatePage, resolvedData };\n}\n"],"mappings":";;;;;AAkGO,SAAS,cAAc,QAAwD;AACpF,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,eAAe,QAAyD;AACtF,SAAO,OAAO,SAAS;AACzB;AA6DA,eAAsB,YAAY,QAAuD;AACvF,QAAM,EAAE,QAAQ,QAAQ,MAAM,UAAU,MAAM,IAAI;AAGlD,QAAM,CAAC,MAAM,eAAe,IAAI,MAAM,QAAQ,IAAI;AAAA,IAChD,OAAO,QAAQ,EAAE,IAAI,OAAO,CAAC;AAAA,IAC7B,OAAO,QAAQ,EAAE,QAAQ,MAAM,QAAQ,CAAC;AAAA,EAC1C,CAAC;AAGD,MAAI,gBAAgB,eAAe,GAAG;AACpC,UAAM,YAAY,gBAAgB;AAElC,UAAM,QAA0B;AAAA,MAC9B,IAAI,UAAU;AAAA,MACd,MAAM,UAAU;AAAA,MAChB,OAAO,UAAU;AAAA,MACjB,MAAM,UAAU;AAAA,MAChB,MAAM,UAAU;AAAA,MAChB,QAAQ,UAAU;AAAA,MAClB,WAAW,UAAU;AAAA;AAAA,MAErB,SAAS,UACJ,UAAU,gBAAgB,UAAU,UACrC,UAAU;AAAA,MACd,WAAW,UACN,UAAU,kBAAkB,UAAU,YACvC,UAAU;AAAA,MACd,iBAAiB,UACZ,UAAU,wBAAwB,UAAU,kBAC7C,UAAU;AAAA,MACd,WAAW,UAAU;AAAA,MACrB,WAAW,UAAU;AAAA,IACvB;AAGA,UAAM,EAAE,cAAc,cAAAA,cAAa,IAAI,MAAM;AAAA,MAC3C,gBAAgB;AAAA,MAChB;AAAA,MACA,EAAE,QAAQ,QAAQ;AAAA,MAClB;AAAA,IACF;AAEA,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA,cAAAA;AAAA,MACA,aAAa,EAAE,cAAc,MAAM,QAAQ;AAAA,MAC3C,OAAO,KAAK;AAAA,MACZ;AAAA,MACA,MAAM,KAAK;AAAA,IACb;AAAA,EACF;AAGA,QAAM,EAAE,MAAM,SAAS,IAAI;AAG3B,QAAM,SAAS,SAAS,OAAO,IAAI,CAAC,UAAU,wBAAwB,OAAO,MAAM,CAAC;AAEpF,QAAM,cAAc;AAAA,IAClB,MAAM,SAAS;AAAA,IACf,MAAM,SAAS;AAAA,IACf,SAAS,SAAS;AAAA,IAClB;AAAA,EACF;AAGA,QAAM,eAAe,MAAM;AAAA,IACzB;AAAA,IACA;AAAA,MACE;AAAA,MACA,QAAQ,SAAS;AAAA,MACjB,cAAc,UAAU,YAAY;AAAA,IACtC;AAAA,IACA;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,IACN,OAAO,KAAK;AAAA,IACZ;AAAA,IACA;AAAA,IACA,MAAM,KAAK;AAAA,EACb;AACF;AAKA,SAAS,gBAAgB,UAA8E;AACrG,SAAO,UAAU,YAAY,SAAS,SAAS;AACjD;AAMA,SAAS,wBACP,OACA,QACyF;AACzF,MAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,UAAM,IAAI,MAAM,2BAA2B,MAAM,eAAe;AAAA,EAClE;AAEA,QAAM,cAAc;AAGpB,QAAM,YAAY,WAAW,aAAa,cAAc;AACxD,QAAM,YAAY,YAAY,SAAS;AAEvC,MAAI,OAAO,YAAY,OAAO,YAAY,YAAY,OAAO,MAAM;AACjE,UAAM,IAAI,MAAM,uBAAuB,MAAM,kCAAkC,OAAO,YAAY,EAAE,EAAE;AAAA,EACxG;AACA,MAAI,OAAO,cAAc,UAAU;AACjC,UAAM,IAAI,MAAM,iBAAiB,SAAS,OAAO,MAAM,0BAA0B,OAAO,SAAS,EAAE;AAAA,EACrG;AAGA,MAAI,WAAW,QAAQ;AACrB,QAAI,OAAO,YAAY,YAAY,UAAU;AAC3C,YAAM,IAAI,MAAM,4BAA4B,MAAM,0BAA0B,OAAO,YAAY,OAAO,EAAE;AAAA,IAC1G;AAEA,UAAMC,WAAW,YAAY,WAA8C,CAAC;AAC5E,WAAO;AAAA,MACL,IAAI,YAAY;AAAA,MAChB,MAAM;AAAA,MACN,SAAS,YAAY;AAAA,MACrB,SAAAA;AAAA,IACF;AAAA,EACF;AAGA,QAAM,QAAQ,YAAY;AAC1B,QAAM,UAAW,YAAY,WAA8C,CAAC;AAE5E,SAAO;AAAA,IACL,IAAI,YAAY;AAAA,IAChB,MAAM;AAAA,IACN,SAAS,UAAU,UAAU,kBAAkB;AAAA,IAC/C;AAAA,EACF;AACF;AAsBA,eAAe,qBACb,WACA,OACA,SACA,QACsF;AACtF,QAAM,WAAW,YAAY,CAAC;AAI9B,MAAI,CAAC,YAAY,CAAC,SAAS,QAAQ,QAAQ;AACzC,WAAO,EAAE,cAAc,MAAM,cAAc,CAAC,EAAE;AAAA,EAChD;AAGA,QAAM,SAAS,SAAS,OAAO,IAAI,CAAC,UAAU,wBAAwB,OAAO,UAAU,CAAC;AAExF,QAAM,eAAkC;AAAA,IACtC,MAAM,SAAS,QAAQ;AAAA,IACvB,MAAM,MAAM,QAAQ;AAAA,IACpB,SAAS;AAAA,IACT;AAAA,EACF;AAGA,QAAM,eAAe,MAAM;AAAA,IACzB;AAAA,IACA;AAAA,MACE,QAAQ,QAAQ;AAAA,MAChB,QAAQ,SAAS;AAAA,MACjB,cAAc,QAAQ,UAAU,YAAY;AAAA,IAC9C;AAAA,IACA;AAAA,EACF;AAEA,SAAO,EAAE,cAAc,aAAa;AACtC;","names":["resolvedData","content"]}

package/dist/server/{chunk-JWRNMNWI.js → chunk-EIJ27EZQ.js}

@@ -95,10 +95,12 @@ function validateAndConvertBlock(block, source) {
     if (typeof blockRecord.purpose !== "string") {
       throw new Error(`Invalid block purpose in ${source}: expected string, got ${typeof blockRecord.purpose}`);
     }
+    const content2 = _nullishCoalesce(blockRecord.content, () => ( {}));
     return {
       id: blockRecord.id,
       kind: kindValue,
-      purpose: blockRecord.purpose
+      purpose: blockRecord.purpose,
+      content: content2
     };
   }
   const scope = blockRecord.scope;
@@ -139,4 +141,4 @@ async function processEntryTemplate(templates, entry, context, client) {
 
 
 exports.isPageContent = isPageContent; exports.isEntryContent = isEntryContent; exports.loadContent = loadContent;
-//# sourceMappingURL=chunk-JWRNMNWI.js.map
+//# sourceMappingURL=chunk-EIJ27EZQ.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-EIJ27EZQ.js","../../src/rendering/helpers/loadContent.ts"],"names":["resolvedData","content"],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-EIJ27EZQ.js","sourcesContent":[null,"/**\n * Server-side helper to fetch content (page or entry) by path.\n *\n * Use this for dynamic routing where a path could resolve to either\n * a page or a content entry.\n */\n\nimport type { Theme } from '@riverbankcms/blocks';\nimport type { RiverbankClient, PageResponse, SiteResponse } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\nimport type { ResolvedBlockData } from '../../data/prefetchBlockData';\n\n/**\n * Site data included in content results for metadata generation.\n */\nexport type SiteData = SiteResponse['site'];\n\nexport type LoadContentParams = {\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 * Content entry data returned when a path resolves to an entry\n */\nexport type ContentEntryData = {\n  id: string;\n  /** Content type key (e.g., 'blog-post', 'product') */\n  type: string | null;\n  title: string;\n  slug: string | null;\n  path: string | null;\n  status: string;\n  publishAt: string | null;\n  /** The raw content fields - use these to render your own UI */\n  content: Record<string, unknown>;\n  metaTitle: string | null;\n  metaDescription: string | null;\n  createdAt: string;\n  updatedAt: string;\n};\n\n/**\n * Result when path resolves to a page\n */\nexport type PageContentResult = {\n  type: 'page';\n  /** Page outline ready for rendering with <Page> component */\n  page: PageProps['page'];\n  /** Site theme for styling */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n  /** Pre-fetched block data for data loaders */\n  resolvedData: ResolvedBlockData;\n  /** Site data for metadata generation */\n  site: SiteData;\n};\n\n/**\n * Result when path resolves to a content entry\n */\nexport type EntryContentResult = {\n  type: 'entry';\n  /** Raw entry data - render this however you want */\n  entry: ContentEntryData;\n  /** Template page for rendering the entry (if available) */\n  templatePage: PageProps['page'] | null;\n  /** Pre-fetched block data for template page data loaders */\n  resolvedData: ResolvedBlockData;\n  /** Data context for template blocks (includes entry content for bindings) */\n  dataContext: { contentEntry: Record<string, unknown> };\n  /** Site theme for styling (useful if rendering with SDK components) */\n  theme: Theme;\n  /** Site ID */\n  siteId: string;\n  /** Site data for metadata generation */\n  site: SiteData;\n};\n\n/**\n * Discriminated union result from loadContent\n */\nexport type LoadContentResult = PageContentResult | EntryContentResult;\n\n/**\n * Type guard to check if result is a page\n */\nexport function isPageContent(result: LoadContentResult): result is PageContentResult {\n  return result.type === 'page';\n}\n\n/**\n * Type guard to check if result is an entry\n */\nexport function isEntryContent(result: LoadContentResult): result is EntryContentResult {\n  return result.type === 'entry';\n}\n\n/**\n * Server-side helper to fetch content by path.\n *\n * Returns a discriminated union - either page data (ready for `<Page>` component)\n * or raw entry data (for custom rendering).\n *\n * @example Dynamic routing with both pages and entries\n * ```tsx\n * import { loadContent, Page, isPageContent } from '@riverbankcms/sdk';\n *\n * export default async function DynamicRoute({ params }) {\n *   const content = await loadContent({\n *     client,\n *     siteId: 'site-123',\n *     path: `/${params.slug?.join('/') || ''}`,\n *   });\n *\n *   if (isPageContent(content)) {\n *     return <Page {...content} />;\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 = await loadContent({ client, siteId, path });\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 *     default:\n *       return <GenericEntry entry={content.entry} />;\n *   }\n * }\n *\n * return <Page {...content} />;\n * ```\n *\n * @example Preview mode for draft content\n * ```tsx\n * const content = await loadContent({\n *   client,\n *   siteId,\n *   path,\n *   preview: true, // Fetches draft content for both pages and entries\n * });\n * ```\n */\nexport async function loadContent(params: LoadContentParams): Promise<LoadContentResult> {\n  const { client, siteId, path, preview = false } = params;\n\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  // 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      // Use draft content in preview mode, otherwise use published content\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    // Process template if available (uses first template from content type)\n    const { templatePage, resolvedData } = await processEntryTemplate(\n      contentResponse.templates as Template[] | undefined,\n      entry,\n      { siteId, preview },\n      client\n    );\n\n    return {\n      type: 'entry',\n      entry,\n      templatePage,\n      resolvedData,\n      dataContext: { contentEntry: entry.content },\n      theme: site.theme,\n      siteId,\n      site: site.site,\n    };\n  }\n\n  // Handle page response\n  const { page: pageData } = contentResponse;\n\n  // Convert API response blocks to PageOutline format with validation\n  const blocks = pageData.blocks.map((block) => validateAndConvertBlock(block, 'page'));\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  return {\n    type: 'page',\n    page: pageOutline,\n    theme: site.theme,\n    siteId,\n    resolvedData,\n    site: site.site,\n  };\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/**\n * Validates and converts a raw block from API response to PageOutline block format.\n * Used for both page blocks and template blocks to ensure consistent validation.\n */\nfunction validateAndConvertBlock(\n  block: unknown,\n  source: 'page' | 'template'\n): { id: string | null; kind: string; purpose: string; content?: Record<string, unknown> } {\n  if (!block || typeof block !== 'object') {\n    throw new Error(`Invalid block format in ${source} API response`);\n  }\n\n  const blockRecord = block as Record<string, unknown>;\n\n  // Template blocks use 'blockKind', page blocks use 'kind'\n  const kindField = source === 'template' ? 'blockKind' : 'kind';\n  const kindValue = blockRecord[kindField];\n\n  if (typeof blockRecord.id !== 'string' && blockRecord.id !== null) {\n    throw new Error(`Invalid block id in ${source}: expected string or null, got ${typeof blockRecord.id}`);\n  }\n  if (typeof kindValue !== 'string') {\n    throw new Error(`Invalid block ${kindField} in ${source}: expected string, got ${typeof kindValue}`);\n  }\n\n  // Template blocks derive purpose from scope, page blocks have explicit purpose\n  if (source === 'page') {\n    if (typeof blockRecord.purpose !== 'string') {\n      throw new Error(`Invalid block purpose in ${source}: expected string, got ${typeof blockRecord.purpose}`);\n    }\n    // Include content for page blocks - required for data loader binding resolution\n    const content = (blockRecord.content as Record<string, unknown> | null) ?? {};\n    return {\n      id: blockRecord.id as string | null,\n      kind: kindValue,\n      purpose: blockRecord.purpose,\n      content,\n    };\n  }\n\n  // Template block: derive purpose from scope, include content\n  const scope = blockRecord.scope as 'entry' | 'template' | undefined;\n  const content = (blockRecord.content as Record<string, unknown> | null) ?? {};\n\n  return {\n    id: blockRecord.id as string | null,\n    kind: kindValue,\n    purpose: scope === 'entry' ? 'entry-content' : 'template-layout',\n    content,\n  };\n}\n\n/** Template block structure from API response */\ntype TemplateBlock = {\n  id: string;\n  blockKind: string;\n  scope: 'entry' | 'template';\n  content: Record<string, unknown> | null;\n};\n\n/** Template structure from API response */\ntype Template = {\n  id: string;\n  name: string;\n  templateKey: string;\n  blocks: TemplateBlock[];\n};\n\n/**\n * Processes an entry's template into a PageOutline format and prefetches block data.\n * Returns null templatePage if no valid template with blocks is available.\n */\nasync function processEntryTemplate(\n  templates: Template[] | undefined,\n  entry: ContentEntryData,\n  context: { siteId: string; preview: boolean },\n  client: RiverbankClient\n): Promise<{ templatePage: PageProps['page'] | null; resolvedData: ResolvedBlockData }> {\n  const template = templates?.[0];\n\n  // Templates without blocks are treated as \"no template\" - the entry should be\n  // rendered with custom UI rather than an empty template page\n  if (!template || !template.blocks?.length) {\n    return { templatePage: null, resolvedData: {} };\n  }\n\n  // Convert template blocks to PageOutline format with validation\n  const blocks = template.blocks.map((block) => validateAndConvertBlock(block, 'template'));\n\n  const templatePage: PageProps['page'] = {\n    name: template.name || 'Entry Template',\n    path: entry.path || '/',\n    purpose: 'entry-template',\n    blocks,\n  };\n\n  // Prefetch block data for template\n  const resolvedData = await prefetchBlockData(\n    templatePage,\n    {\n      siteId: context.siteId,\n      pageId: template.id,\n      previewStage: context.preview ? 'preview' : 'published',\n    },\n    client\n  );\n\n  return { templatePage, resolvedData };\n}\n"]}

package/dist/server/{chunk-6Z4MQG47.js → chunk-KH3EXBJM.js}

@@ -2331,7 +2331,7 @@ var SimpleCache = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.7.4";
+var SDK_VERSION = "0.7.5";
 
 // src/client/error.ts
 var RiverbankApiError = class _RiverbankApiError extends Error {
@@ -2424,6 +2424,54 @@ var RiverbankApiError = class _RiverbankApiError extends Error {
   isServerError() {
     return this.code.startsWith("server:");
   }
+  /**
+   * Returns a human-readable string representation of the error.
+   * Includes all key details for debugging.
+   *
+   * @example
+   * "RiverbankApiError: Content keys cannot access preview content | Code: auth:forbidden | Status: 401 | RequestId: req-abc123"
+   */
+  toString() {
+    const parts = [`RiverbankApiError: ${this.message}`];
+    if (this.code) parts.push(`Code: ${this.code}`);
+    if (this.status) parts.push(`Status: ${this.status}`);
+    if (this.requestId) parts.push(`RequestId: ${this.requestId}`);
+    return parts.join(" | ");
+  }
+  /**
+   * Custom Node.js inspect output for better console.log display.
+   * This ensures that console.log(error) shows all relevant details
+   * instead of just "[Object]" for nested properties.
+   */
+  [Symbol.for("nodejs.util.inspect.custom")]() {
+    return this.toDetailedString();
+  }
+  /**
+   * Returns a detailed multi-line string for debugging.
+   * Used by the Node.js inspect symbol for console output.
+   */
+  toDetailedString() {
+    const lines = [
+      `RiverbankApiError: ${this.message}`,
+      `  Code: ${this.code}`,
+      `  Status: ${this.status}`,
+      `  RequestId: ${this.requestId}`,
+      `  Timestamp: ${this.timestamp}`
+    ];
+    if (this.isRetryable) {
+      lines.push(`  Retryable: true`);
+      if (this.retryAfterMs) {
+        lines.push(`  RetryAfter: ${this.retryAfterMs}ms`);
+      }
+    }
+    if (this.fieldErrors && this.fieldErrors.length > 0) {
+      lines.push("  FieldErrors:");
+      this.fieldErrors.forEach((fe) => {
+        lines.push(`    - ${fe.field}: ${fe.message}`);
+      });
+    }
+    return lines.join("\n");
+  }
 };
 
 // src/client/resilience.ts
@@ -2581,7 +2629,19 @@ async function fetchWithTimeoutAndRetry(fetcher, config) {
   }
   throw lastError;
 }
+function isAbortError(error) {
+  if (typeof DOMException !== "undefined" && error instanceof DOMException && error.name === "AbortError") {
+    return true;
+  }
+  if (error instanceof Error && error.name === "AbortError") {
+    return true;
+  }
+  return false;
+}
 function shouldRetryError(error, customRetryOn) {
+  if (isAbortError(error)) {
+    return false;
+  }
   if (customRetryOn) {
     const statusCode = error instanceof RiverbankApiError ? error.status : void 0;
     return customRetryOn(error, statusCode);
@@ -2625,7 +2685,7 @@ var DEFAULT_SERVER_TIMEOUT_MS = 8e3;
 function generateRequestId2() {
   return `req-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
 }
-function isAbortError(error) {
+function isAbortError2(error) {
   if (error instanceof DOMException && error.name === "AbortError") {
     return true;
   }
@@ -2663,7 +2723,7 @@ function getNetworkErrorCode(error) {
   return "network:connection_error";
 }
 function convertToTypedError(error) {
-  if (isAbortError(error)) {
+  if (isAbortError2(error)) {
     throw error;
   }
   if (error instanceof ApiEnvelopeError) {
@@ -3049,4 +3109,4 @@ function createRiverbankClient(config) {
 
 
 exports.API_ENDPOINTS = API_ENDPOINTS; exports.buildEndpointURL = buildEndpointURL; exports.SDK_VERSION = SDK_VERSION; exports.PREBUILD_PAGE_SIZE = PREBUILD_PAGE_SIZE; exports.DEFAULT_PREBUILD_DIR = DEFAULT_PREBUILD_DIR; exports.init_constants = init_constants; exports.canUsePrebuild = canUsePrebuild; exports.PrebuildLoader = PrebuildLoader; exports.createPrebuildLoader = createPrebuildLoader; exports.init_loader = init_loader; exports.createRiverbankClient = createRiverbankClient;
-//# sourceMappingURL=chunk-6Z4MQG47.js.map
+//# sourceMappingURL=chunk-KH3EXBJM.js.map