@riverbankcms/sdk 0.7.4 → 0.8.0

package/dist/server/{Layout-qWLdVm5-.d.mts → Layout-D4J009eS.d.mts}

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { buildMenu, buildLogo } from './navigation.mjs';
-import { S as SiteResponse, R as RiverbankClient } from './types-C-LShyIg.mjs';
+import { S as SiteResponse, R as RiverbankClient } from './types-BRQ_6yOc.mjs';
 
 type HeaderData = {
     menu: ReturnType<typeof buildMenu>;

package/dist/server/{Layout-Yluyb6sK.d.ts → Layout-l2v4Qa6E.d.ts}

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { buildMenu, buildLogo } from './navigation.js';
-import { S as SiteResponse, R as RiverbankClient } from './types-BRQyLrQU.js';
+import { S as SiteResponse, R as RiverbankClient } from './types-D0rPF8l5.js';
 
 type HeaderData = {
     menu: ReturnType<typeof buildMenu>;

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":"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","names":["resolvedData","content"]}

package/dist/server/{chunk-JNU7ZS2V.mjs → chunk-65A5HAUZ.mjs}

@@ -1268,6 +1268,15 @@ var ENDPOINT_DEFINITIONS = {
     auth: "user",
     responseKind: "json"
   },
+  // Public routable content for SDK SSG
+  getPublicRoutableContent: {
+    path: "/public/sites/{siteId}/routable-content",
+    method: "GET",
+    revalidate: 60,
+    tags: ["site-{siteId}", "routable-content-{siteId}"],
+    auth: "public",
+    responseKind: "json"
+  },
   // Generic public content preview (preferred)
   getPublishedEntryPreview: {
     path: "/public/content/{siteId}/{type}/{slug}/preview",
@@ -2331,13 +2340,16 @@ var SimpleCache = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.7.4";
+var SDK_VERSION = "0.8.0";
 
 // src/client/error.ts
 var RiverbankApiError = class _RiverbankApiError extends Error {
   constructor(apiError) {
     super(apiError.message);
     this.name = "RiverbankApiError";
+    if ("cause" in apiError && apiError.cause) {
+      this.cause = apiError.cause;
+    }
     this.code = apiError.code;
     this.requestId = apiError.requestId;
     this.status = apiError.status;
@@ -2424,6 +2436,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
@@ -2438,13 +2498,75 @@ var DEFAULT_CIRCUIT_BREAKER_CONFIG = {
   resetTimeoutMs: 3e4,
   halfOpenMaxRequests: 2
 };
+var PERMANENT_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ECONNREFUSED",
+  // Server is not running / port not listening
+  "ENOTFOUND",
+  // DNS lookup failed - hostname doesn't exist
+  "EAI_AGAIN"
+  // DNS lookup timeout (usually permanent for invalid hosts)
+]);
+var TRANSIENT_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ECONNRESET",
+  // Connection was reset mid-request (server dropped it)
+  "EPIPE",
+  // Broken pipe (connection closed while writing)
+  "ETIMEDOUT",
+  // Connection timed out (could be temporary congestion)
+  "ESOCKETTIMEDOUT"
+  // Socket timeout
+]);
+var NODE_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
+  // Permanent
+  "ECONNREFUSED",
+  "ENOTFOUND",
+  "EAI_AGAIN",
+  // Transient
+  "ECONNRESET",
+  "EPIPE",
+  "ETIMEDOUT",
+  "ESOCKETTIMEDOUT"
+]);
+function isNodeNetworkErrorCode(code) {
+  return !code.includes(":") && NODE_NETWORK_ERROR_CODES.has(code);
+}
+function getErrorCodeFromCause(error) {
+  let current = error;
+  while (current) {
+    const nodeError = current;
+    if (nodeError.code && typeof nodeError.code === "string") {
+      if (isNodeNetworkErrorCode(nodeError.code)) {
+        return nodeError.code;
+      }
+    }
+    const errorWithCause = current;
+    current = errorWithCause.cause;
+  }
+  return void 0;
+}
 function isTransientError(error) {
   if (error instanceof RiverbankApiError) {
+    const errorCode = getErrorCodeFromCause(error);
+    if (errorCode && PERMANENT_NETWORK_ERROR_CODES.has(errorCode)) {
+      return false;
+    }
     if (error.status === 0) return true;
     if (error.status === 429) return true;
     if (error.status >= 500) return true;
     return false;
   }
+  if (error instanceof TypeError) {
+    const errorCode = getErrorCodeFromCause(error);
+    if (errorCode) {
+      if (PERMANENT_NETWORK_ERROR_CODES.has(errorCode)) {
+        return false;
+      }
+      if (TRANSIENT_NETWORK_ERROR_CODES.has(errorCode)) {
+        return true;
+      }
+    }
+    return true;
+  }
   return true;
 }
 function calculateBackoff(attempt, config) {
@@ -2581,7 +2703,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 +2759,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 +2797,7 @@ function getNetworkErrorCode(error) {
   return "network:connection_error";
 }
 function convertToTypedError(error) {
-  if (isAbortError(error)) {
+  if (isAbortError2(error)) {
     throw error;
   }
   if (error instanceof ApiEnvelopeError) {
@@ -2693,12 +2827,23 @@ function convertToTypedError(error) {
       message: networkError.message || "Network request failed",
       requestId: `local-${Date.now()}`,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      status: 0
+      status: 0,
       // No HTTP response received
+      cause: networkError
+      // Preserve original error for retry/circuit breaker classification
     });
   }
   throw error;
 }
+function detectKeyType(apiKey) {
+  if (apiKey.startsWith("bld_live_sk_") || apiKey.startsWith("bld_test_sk_")) {
+    return "content";
+  }
+  if (apiKey.startsWith("bld_preview_sk_")) {
+    return "preview";
+  }
+  return "unknown";
+}
 function createRiverbankClient(config) {
   if (!config.baseUrl) {
     throw new Error(
@@ -2729,6 +2874,7 @@ function createRiverbankClient(config) {
     resetTimeoutMs: config.resilience?.circuitBreaker?.resetTimeoutMs ?? DEFAULT_CIRCUIT_BREAKER_CONFIG.resetTimeoutMs,
     halfOpenMaxRequests: config.resilience?.circuitBreaker?.halfOpenMaxRequests ?? DEFAULT_CIRCUIT_BREAKER_CONFIG.halfOpenMaxRequests
   };
+  const keyType = detectKeyType(config.apiKey);
   const apiClient = createBearerAPIClient(config.apiKey, config.baseUrl);
   const cache = new SimpleCache({
     maxSize: cacheMaxSize,
@@ -3024,9 +3170,26 @@ function createRiverbankClient(config) {
         });
       }, { signal });
     },
+    async getAllPublishedRoutes(params) {
+      const { siteId, signal } = params;
+      if (!siteId) {
+        throw new Error("getAllPublishedRoutes() requires siteId");
+      }
+      const cacheKey = `routable-content:${siteId}:published`;
+      return resilientFetch(cacheKey, async (sig) => {
+        return await apiClient({
+          endpoint: "getPublicRoutableContent",
+          params: { siteId, publishedOnly: "true" },
+          options: { signal: sig }
+        });
+      }, { signal });
+    },
     clearCache() {
       cache.clear();
     },
+    getKeyType() {
+      return keyType;
+    },
     getLastEmittedStatus() {
       return lastStatus;
     },
@@ -3049,4 +3212,4 @@ export {
   init_loader,
   createRiverbankClient
 };
-//# sourceMappingURL=chunk-JNU7ZS2V.mjs.map
+//# sourceMappingURL=chunk-65A5HAUZ.mjs.map