@riverbankcms/sdk 0.6.0 → 0.7.0

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/navigation/index.ts"],"sourcesContent":["/**\n * Navigation helper utilities for SDK sites.\n *\n * Provides helpers to transform CMS navigation data into render-ready structures.\n * Supports both simple NavItem arrays and full MenuViewModels for block rendering.\n *\n * @example Simple usage\n * ```ts\n * import { getPrimaryNavItems } from '@riverbankcms/sdk/navigation';\n *\n * const headerNav = getPrimaryNavItems(siteData.navigation);\n * // [{ href: '/', label: 'Home', isExternal: false }, ...]\n * ```\n *\n * @example Block rendering usage\n * ```ts\n * import { buildMenuViewModel, buildLogoViewModel } from '@riverbankcms/sdk/navigation';\n *\n * const menu = buildMenuViewModel(siteData.navigation);\n * const logo = buildLogoViewModel(siteData.layout.logo, siteData.site.title);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { menu, content: { logo } },\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '@riverbankcms/api';\nimport type { RouteMap } from '@riverbankcms/blocks';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types for block rendering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Link value types matching @riverbankcms/blocks\n */\nexport type InternalLinkValue = {\n  kind: 'internal';\n  routeId: string;\n  entityId: string;\n  entityType: 'page' | 'content';\n  href: string;\n  title: string;\n  typeLabel: string;\n  contentTypeKey?: string | null;\n  contentTypeName?: string | null;\n  updatedAt?: string | null;\n};\n\nexport type ExternalLinkValue = {\n  kind: 'external';\n  href: string;\n};\n\nexport type CustomLinkValue = {\n  kind: 'url';\n  href: string;\n};\n\nexport type LinkValue = InternalLinkValue | ExternalLinkValue | CustomLinkValue;\n\n/**\n * Menu link view model for block rendering\n */\nexport type MenuLinkViewModel = {\n  id: string;\n  label: string;\n  link: LinkValue | null;\n  target: string | null;\n  rel: string | null;\n  active?: boolean;\n};\n\n/**\n * CTA link view model (extends MenuLinkViewModel with variant)\n */\nexport type MenuCtaViewModel = MenuLinkViewModel & {\n  variant: string;\n};\n\n/**\n * Complete menu view model for header/footer blocks\n */\nexport type MenuViewModel = {\n  items: MenuLinkViewModel[];\n  ctaItem: MenuCtaViewModel | null;\n};\n\n/**\n * Logo source data from site layout\n */\nexport type LogoSource = {\n  url: string | null;\n  alt: string | null;\n  assetId?: string | null;\n  width?: number | null;\n  height?: number | null;\n  storagePath?: string | null;\n  storageBucket?: string | null;\n} | null;\n\n/**\n * Logo view model for block rendering\n */\nexport type LogoViewModel = {\n  type: 'image';\n  src: string;\n  alt: string;\n  assetId?: string;\n  width?: number | null;\n  height?: number | null;\n  storagePath?: string;\n  storageBucket?: string;\n} | null;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple NavItem type for basic usage\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * A simplified navigation item structure for component rendering.\n */\nexport type NavItem = {\n  /** The URL to navigate to */\n  href: string;\n  /** Display text for the navigation link */\n  label: string;\n  /** Whether link should open in new tab (external links) */\n  isExternal: boolean;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Nested Navigation Types (with dropdown support)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * A navigation link item with a direct URL.\n * Use `kind` discriminator for type-safe narrowing.\n *\n * @example\n * ```ts\n * if (item.kind === 'link') {\n *   console.log(item.href);  // TypeScript knows href exists\n * }\n * ```\n */\nexport type NavLink = {\n  /** Discriminator for type narrowing */\n  kind: 'link';\n  /** Unique identifier from CMS */\n  id: string;\n  /** Display text for the navigation link */\n  label: string;\n  /** The URL to navigate to */\n  href: string;\n  /** Whether link should open in new tab (external links) */\n  isExternal: boolean;\n};\n\n/**\n * A dropdown container holding child navigation items.\n * Clicking reveals children instead of navigating.\n * Max 1 level of nesting (children are always NavLink, not NavDropdown).\n */\nexport type NavDropdown = {\n  /** Discriminator for type narrowing */\n  kind: 'dropdown';\n  /** Unique identifier from CMS */\n  id: string;\n  /** Display text for the dropdown trigger */\n  label: string;\n  /** Child navigation links */\n  children: NavLink[];\n};\n\n/**\n * Unified navigation item supporting both links and dropdowns.\n * Use `kind` property for type-safe discrimination.\n *\n * @example\n * ```ts\n * const items = getNestedPrimaryNavItems(navigation);\n * items.forEach(item => {\n *   if (item.kind === 'link') {\n *     console.log(item.href);\n *   } else {\n *     console.log(item.children.length);\n *   }\n * });\n * ```\n */\nexport type NestedNavItem = NavLink | NavDropdown;\n\n/**\n * Type guard to check if a navigation item is a link.\n */\nexport function isNavLink(item: NestedNavItem): item is NavLink {\n  return item.kind === 'link';\n}\n\n/**\n * Type guard to check if a navigation item is a dropdown.\n */\nexport function isNavDropdown(item: NestedNavItem): item is NavDropdown {\n  return item.kind === 'dropdown';\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple types for block rendering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Simple nav link with pre-resolved href for block rendering.\n */\nexport type SimpleNavLink = {\n  id: string;\n  label: string;\n  href: string;\n  isExternal: boolean;\n};\n\n/**\n * Simple menu view model with pre-resolved hrefs.\n * Use this instead of MenuViewModel for cleaner data flow.\n */\nexport type SimpleMenuViewModel = {\n  items: SimpleNavLink[];\n  ctaItem: SimpleNavLink | null;\n};\n\n/**\n * Simple nested nav link with pre-resolved href.\n */\nexport type SimpleNestedNavLink = {\n  kind: 'link';\n  id: string;\n  label: string;\n  href: string;\n  isExternal: boolean;\n};\n\n/**\n * Simple nested dropdown with pre-resolved children.\n */\nexport type SimpleNestedNavDropdown = {\n  kind: 'dropdown';\n  id: string;\n  label: string;\n  children: SimpleNestedNavLink[];\n};\n\n/**\n * Unified simple nested navigation item.\n */\nexport type SimpleNestedNavItem = SimpleNestedNavLink | SimpleNestedNavDropdown;\n\n/**\n * Simple menu view model with nested navigation support.\n */\nexport type SimpleNestedMenuViewModel = {\n  items: SimpleNestedNavItem[];\n  ctaItem: SimpleNestedNavLink | null;\n};\n\n/**\n * Simple logo data for block rendering.\n */\nexport type SimpleLogo = {\n  type: 'image';\n  src: string;\n  alt: string;\n  width?: number;\n  height?: number;\n} | null;\n\n// RouteMap type is imported from @riverbankcms/blocks for consistency\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Menu selection helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get the primary navigation menu object.\n * Returns menu marked as isPrimary, or first menu if none marked.\n *\n * @example\n * ```ts\n * const menu = getPrimaryNavigation(siteData.navigation);\n * console.log(menu?.title); // \"Main Navigation\"\n * ```\n */\nexport function getPrimaryNavigation(\n  navigation: NavigationMenuWithItems[],\n): NavigationMenuWithItems | null {\n  if (!navigation || navigation.length === 0) return null;\n  // navigation.length > 0 is guaranteed above, so [0] exists\n  return navigation.find((menu) => menu.isPrimary) ?? navigation[0] ?? null;\n}\n\n/**\n * Get a navigation menu by name/slug.\n *\n * @example\n * ```ts\n * const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');\n * ```\n */\nexport function getNavigationBySlug(\n  navigation: NavigationMenuWithItems[],\n  slug: string,\n): NavigationMenuWithItems | null {\n  if (!navigation || navigation.length === 0) return null;\n  return navigation.find((menu) => menu.name === slug) ?? null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple NavItem[] transformations\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get nav items from the primary menu (marked isPrimary, or first menu).\n * Returns empty array if no navigation configured.\n *\n * @example\n * ```ts\n * const headerNav = getPrimaryNavItems(siteData.navigation);\n * // [{ href: '/', label: 'Home', isExternal: false }, ...]\n * ```\n */\nexport function getPrimaryNavItems(navigation: NavigationMenuWithItems[]): NavItem[] {\n  return transformToNavItems(getPrimaryNavigation(navigation));\n}\n\n/**\n * Get nav items from a specific menu by slug.\n * Useful for footer nav, secondary nav, etc.\n * Returns empty array if menu not found.\n *\n * @example\n * ```ts\n * const footerNav = getNavItemsBySlug(siteData.navigation, 'footer');\n * ```\n */\nexport function getNavItemsBySlug(navigation: NavigationMenuWithItems[], slug: string): NavItem[] {\n  return transformToNavItems(getNavigationBySlug(navigation, slug));\n}\n\n/**\n * Transform a menu into simple NavItem array.\n */\nexport function transformToNavItems(menu: NavigationMenuWithItems | null): NavItem[] {\n  if (!menu?.items || menu.items.length === 0) return [];\n\n  return menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0))\n    .map((item) => ({\n      label: item.label,\n      href: extractHref(item),\n      isExternal: isExternalLink(item),\n    }))\n    .filter((item): item is NavItem => Boolean(item.href));\n}\n\n/**\n * Transform a menu into nested NestedNavItem array.\n * Builds tree structure from flat items, supporting dropdowns with children.\n *\n * @example\n * ```ts\n * const nav = transformToNestedNavItems(menu);\n * // [\n * //   { kind: 'link', href: '/', label: 'Home', ... },\n * //   { kind: 'dropdown', label: 'Services', children: [...] },\n * // ]\n * ```\n */\nexport function transformToNestedNavItems(\n  menu: NavigationMenuWithItems | null\n): NestedNavItem[] {\n  if (!menu?.items || menu.items.length === 0) return [];\n\n  const toNavLink = (item: NavigationItemRecord): NavLink | null => {\n    const href = extractHref(item);\n    if (!href) return null;\n    return {\n      kind: 'link',\n      id: item.id,\n      label: item.label,\n      href,\n      isExternal: isExternalLink(item),\n    };\n  };\n\n  const { items } = buildNestedStructure<NavLink, NavDropdown, NavLink>(\n    menu.items,\n    {\n      toLink: toNavLink,\n      createDropdown: (id, label, children) => ({\n        kind: 'dropdown',\n        id,\n        label,\n        children,\n      }),\n      extractCta: false,\n    }\n  );\n\n  return items;\n}\n\n/**\n * Get nested nav items from the primary menu.\n * Supports dropdowns with children for complex navigation structures.\n *\n * @example\n * ```ts\n * const nav = getNestedPrimaryNavItems(siteData.navigation);\n * nav.forEach(item => {\n *   if (item.kind === 'dropdown') {\n *     console.log(`${item.label} has ${item.children.length} children`);\n *   }\n * });\n * ```\n */\nexport function getNestedPrimaryNavItems(\n  navigation: NavigationMenuWithItems[]\n): NestedNavItem[] {\n  return transformToNestedNavItems(getPrimaryNavigation(navigation));\n}\n\n/**\n * Get nested nav items from a specific menu by slug.\n *\n * @example\n * ```ts\n * const footerNav = getNestedNavItemsBySlug(siteData.navigation, 'footer');\n * ```\n */\nexport function getNestedNavItemsBySlug(\n  navigation: NavigationMenuWithItems[],\n  slug: string\n): NestedNavItem[] {\n  return transformToNestedNavItems(getNavigationBySlug(navigation, slug));\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Full MenuViewModel for block rendering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a MenuViewModel from navigation data for block rendering.\n * Extracts CTA item separately and preserves full link data.\n *\n * @example\n * ```ts\n * const menuViewModel = buildMenuViewModel(siteData.navigation);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { menu: menuViewModel },\n * });\n * ```\n */\nexport function buildMenuViewModel(navigation: NavigationMenuWithItems[]): MenuViewModel {\n  const menu = getPrimaryNavigation(navigation);\n\n  if (!menu) {\n    return { items: [], ctaItem: null };\n  }\n\n  const flatItems = menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));\n\n  const items: MenuLinkViewModel[] = [];\n  let ctaItem: MenuCtaViewModel | null = null;\n\n  for (const item of flatItems) {\n    const viewItem: MenuLinkViewModel = {\n      id: item.id,\n      label: item.label,\n      link: convertToLinkValue(item),\n      target: null,\n      rel: null,\n      active: false,\n    };\n\n    // Extract first CTA item separately\n    if (!ctaItem && Boolean(item.isCta)) {\n      ctaItem = { ...viewItem, variant: 'primary' };\n      continue;\n    }\n\n    items.push(viewItem);\n  }\n\n  return { items, ctaItem };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Logo view model helper\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a LogoViewModel from site layout data.\n *\n * @param logo - Logo source from siteData.layout.logo\n * @param fallbackTitle - Site title to use as alt text fallback\n *\n * @example\n * ```ts\n * const logoViewModel = buildLogoViewModel(siteData.layout.logo, siteData.site.title);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { content: { logo: logoViewModel } },\n * });\n * ```\n */\nexport function buildLogoViewModel(\n  logo: LogoSource,\n  fallbackTitle: string | null | undefined,\n): LogoViewModel {\n  if (!logo) {\n    return null;\n  }\n\n  // Logo must have storagePath (for direct Supabase URL) or explicit url\n  if (!logo.url && !logo.storagePath) {\n    return null;\n  }\n\n  const alt = logo.alt && logo.alt.trim().length > 0 ? logo.alt : fallbackTitle ?? 'Site logo';\n\n  return {\n    type: 'image',\n    src: logo.url ?? '', // Empty when using storagePath - MediaNode builds direct URL\n    alt,\n    assetId: logo.assetId ?? undefined,\n    width: logo.width ?? undefined,\n    height: logo.height ?? undefined,\n    storagePath: logo.storagePath ?? undefined,\n    storageBucket: logo.storageBucket ?? undefined,\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Internal helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Extracts the href from a navigation item's url field.\n */\nfunction extractHref(item: NavigationItemRecord): string {\n  const link = item.url as LinkPayload | null | undefined;\n  if (!link || typeof link !== 'object' || !('href' in link)) return '';\n  return link.href;\n}\n\n/**\n * Determines if a navigation item's link is external.\n */\nfunction isExternalLink(item: NavigationItemRecord): boolean {\n  const link = item.url as LinkPayload | null | undefined;\n  if (!link || typeof link !== 'object' || !('kind' in link)) return false;\n  return link.kind === 'external';\n}\n\n/**\n * Build a map of children items by parent ID.\n * Also warns about deeply nested items (grandchildren) which CMS shouldn't allow.\n * @internal\n */\nfunction buildChildrenByParentId(\n  items: NavigationItemRecord[]\n): Map<string, NavigationItemRecord[]> {\n  const childrenByParentId = new Map<string, NavigationItemRecord[]>();\n  const itemsById = new Map<string, NavigationItemRecord>();\n\n  // First pass: index items by ID\n  for (const item of items) {\n    itemsById.set(item.id, item);\n  }\n\n  // Second pass: build children map and warn about deep nesting\n  for (const item of items) {\n    if (item.parentId) {\n      // Check if parent is itself a child (deep nesting)\n      const parent = itemsById.get(item.parentId);\n      if (parent?.parentId && typeof process !== 'undefined' && process.env.NODE_ENV !== 'production') {\n        console.warn(\n          `[SDK Navigation] Deeply nested item detected: \"${item.label}\" (id: ${item.id}). ` +\n          `Only 1 level of nesting is supported. This item will be ignored.`\n        );\n        continue; // Skip deeply nested items\n      }\n\n      const siblings = childrenByParentId.get(item.parentId) ?? [];\n      siblings.push(item);\n      childrenByParentId.set(item.parentId, siblings);\n    }\n  }\n\n  return childrenByParentId;\n}\n\n/**\n * Generic nested structure builder.\n * Extracts shared logic between transformToNestedNavItems and buildSimpleNestedMenu.\n * @internal\n */\nfunction buildNestedStructure<TLink, TDropdown, TCta extends TLink>(\n  items: NavigationItemRecord[],\n  options: {\n    /** Convert a navigation item record to a link type */\n    toLink: (item: NavigationItemRecord) => TLink | null;\n    /** Create a dropdown from id, label, and children */\n    createDropdown: (id: string, label: string, children: TLink[]) => TDropdown;\n    /** Extract CTA from items (return null to skip CTA extraction) */\n    extractCta?: boolean;\n  }\n): { items: (TLink | TDropdown)[]; ctaItem: TCta | null } {\n  const childrenByParentId = buildChildrenByParentId(items);\n\n  // Process root items (no parentId) sorted by orderIndex\n  const rootItems = items\n    .filter((item) => !item.parentId)\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));\n\n  const result: (TLink | TDropdown)[] = [];\n  let ctaItem: TCta | null = null;\n\n  for (const item of rootItems) {\n    // Handle CTA extraction (CTAs are always links, not dropdowns)\n    if (options.extractCta && !ctaItem && Boolean(item.isCta) && item.urlType !== 'dropdown') {\n      const link = options.toLink(item);\n      if (link) {\n        ctaItem = link as TCta;\n        continue;\n      }\n    }\n\n    if (item.urlType === 'dropdown') {\n      // It's a dropdown - gather its children\n      const childRecords = childrenByParentId.get(item.id) ?? [];\n      const children = childRecords\n        .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0))\n        .map(options.toLink)\n        .filter((child): child is TLink => child !== null);\n\n      // Only include dropdown if it has children\n      if (children.length > 0) {\n        result.push(options.createDropdown(item.id, item.label, children));\n      }\n    } else {\n      // It's a regular link\n      const link = options.toLink(item);\n      if (link) {\n        result.push(link);\n      }\n    }\n  }\n\n  return { items: result, ctaItem };\n}\n\n/**\n * Convert navigation item to LinkValue for block rendering.\n */\nfunction convertToLinkValue(item: NavigationItemRecord): LinkValue | null {\n  const payload = item.url as Record<string, unknown> | null;\n  if (!payload) return null;\n\n  const kind = typeof payload.kind === 'string' ? payload.kind : null;\n\n  if (kind === 'external' || kind === 'url') {\n    const href = typeof payload.href === 'string' ? payload.href : null;\n    return href ? { kind, href } as ExternalLinkValue | CustomLinkValue : null;\n  }\n\n  if (kind === 'internal') {\n    const routeId = typeof payload.routeId === 'string' ? payload.routeId : null;\n    const entityId = typeof payload.entityId === 'string' ? payload.entityId : null;\n    const entityType = payload.entityType === 'page' || payload.entityType === 'content'\n      ? payload.entityType\n      : null;\n    const href = typeof payload.href === 'string' ? payload.href : null;\n    const title = typeof payload.title === 'string' ? payload.title : null;\n    const typeLabel = typeof payload.typeLabel === 'string' ? payload.typeLabel : null;\n\n    if (!routeId || !entityId || !entityType || !href || !title || !typeLabel) {\n      return null;\n    }\n\n    return {\n      kind: 'internal',\n      routeId,\n      entityId,\n      entityType,\n      href,\n      title,\n      typeLabel,\n      contentTypeKey: typeof payload.contentTypeKey === 'string' ? payload.contentTypeKey : null,\n      contentTypeName: typeof payload.contentTypeName === 'string' ? payload.contentTypeName : null,\n      updatedAt: typeof payload.updatedAt === 'string' ? payload.updatedAt : null,\n    };\n  }\n\n  return null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple pre-resolved menu/logo helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a SimpleMenuViewModel from navigation data with pre-resolved hrefs.\n * Use this instead of buildMenuViewModel for cleaner data flow.\n *\n * @param navigation - Navigation menus from site data\n * @param routes - Route map for resolving internal links\n *\n * @example\n * ```ts\n * const menu = buildSimpleMenu(siteData.navigation, siteData.routes);\n * // { items: [{ id, label, href: '/', isExternal: false }], cta: null }\n * ```\n */\nexport function buildSimpleMenu(\n  navigation: NavigationMenuWithItems[],\n  routes: RouteMap,\n): SimpleMenuViewModel {\n  const menu = getPrimaryNavigation(navigation);\n\n  if (!menu) {\n    return { items: [], ctaItem: null };\n  }\n\n  const flatItems = menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));\n\n  const items: SimpleNavLink[] = [];\n  let ctaItem: SimpleNavLink | null = null;\n\n  for (const item of flatItems) {\n    const link = item.url as LinkPayload | null;\n    const href = resolveHref(link, routes);\n\n    if (!href) continue;\n\n    const navLink: SimpleNavLink = {\n      id: item.id,\n      label: item.label,\n      href,\n      isExternal: link?.kind === 'external',\n    };\n\n    // Extract first CTA item separately\n    if (!ctaItem && Boolean(item.isCta)) {\n      ctaItem = navLink;\n      continue;\n    }\n\n    items.push(navLink);\n  }\n\n  return { items, ctaItem };\n}\n\n/**\n * Build a SimpleNestedMenuViewModel with pre-resolved hrefs.\n * Supports dropdown containers with nested children.\n *\n * @example\n * ```ts\n * const menu = buildSimpleNestedMenu(siteData.navigation, siteData.routes);\n * menu.items.forEach(item => {\n *   if (item.kind === 'dropdown') {\n *     console.log(item.children);\n *   }\n * });\n * ```\n */\nexport function buildSimpleNestedMenu(\n  navigation: NavigationMenuWithItems[],\n  routes: RouteMap,\n): SimpleNestedMenuViewModel {\n  const menu = getPrimaryNavigation(navigation);\n\n  if (!menu) {\n    return { items: [], ctaItem: null };\n  }\n\n  const toSimpleLink = (item: NavigationItemRecord): SimpleNestedNavLink | null => {\n    const link = item.url as LinkPayload | null;\n    const href = resolveHref(link, routes);\n    if (!href) return null;\n\n    return {\n      kind: 'link',\n      id: item.id,\n      label: item.label,\n      href,\n      isExternal: link?.kind === 'external',\n    };\n  };\n\n  return buildNestedStructure<SimpleNestedNavLink, SimpleNestedNavDropdown, SimpleNestedNavLink>(\n    menu.items,\n    {\n      toLink: toSimpleLink,\n      createDropdown: (id, label, children) => ({\n        kind: 'dropdown',\n        id,\n        label,\n        children,\n      }),\n      extractCta: true,\n    }\n  );\n}\n\n/**\n * Resolve href from a link payload using route map.\n * @internal\n */\nfunction resolveHref(link: LinkPayload | null, routes: RouteMap): string | null {\n  if (!link) return null;\n\n  // External or custom URL links - use href directly\n  if (link.kind === 'external' || link.kind === 'url') {\n    return link.href || null;\n  }\n\n  // Internal link - resolve from route map\n  if (link.kind === 'internal' && link.routeId) {\n    const route = routes[link.routeId];\n    if (route) {\n      if (typeof route === 'string') {\n        return route;\n      }\n      // Try path first, then href, then draftPath\n      return route.path ?? route.href ?? route.draftPath ?? link.href ?? null;\n    }\n    // Fall back to link.href if route not found\n    return link.href ?? null;\n  }\n\n  return null;\n}\n\n/**\n * Build a SimpleLogo from site layout data.\n *\n * @param logo - Logo data from site layout\n * @param fallbackAlt - Fallback alt text (usually site title)\n *\n * @example\n * ```ts\n * const logo = buildSimpleLogo(siteData.layout.logo, siteData.site.title);\n * // { src: 'https://...', alt: 'Site Name', width: 200, height: 50 }\n * ```\n */\nexport function buildSimpleLogo(\n  logo: { url?: string | null; alt?: string | null; width?: number | null; height?: number | null } | null,\n  fallbackAlt: string | null | undefined,\n): SimpleLogo {\n  if (!logo || !logo.url) {\n    return null;\n  }\n\n  const alt = logo.alt && logo.alt.trim().length > 0 ? logo.alt : (fallbackAlt ?? 'Site logo');\n\n  const result: NonNullable<SimpleLogo> = {\n    type: 'image',\n    src: logo.url,\n    alt,\n  };\n\n  if (logo.width != null) {\n    result.width = logo.width;\n  }\n  if (logo.height != null) {\n    result.height = logo.height;\n  }\n\n  return result;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Deprecated aliases (for backwards compatibility during migration)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * @deprecated Use `transformToNavItems` instead.\n * This alias is maintained for backwards compatibility only.\n */\nexport const transformNavItems = transformToNavItems;\n\n/**\n * @deprecated Use `getPrimaryNavigation` instead.\n * This alias is maintained for backwards compatibility only.\n */\nexport const selectPrimaryMenu = getPrimaryNavigation;\n\n// Re-export types for convenience\nexport type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '@riverbankcms/api';\n"],"mappings":"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","names":[]}

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

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-SSS7CCRR.js","../../src/navigation/index.ts"],"names":[],"mappings":"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","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/chunk-SSS7CCRR.js","sourcesContent":[null,"/**\n * Navigation helper utilities for SDK sites.\n *\n * Provides helpers to transform CMS navigation data into render-ready structures.\n * Supports both simple NavItem arrays and full MenuViewModels for block rendering.\n *\n * @example Simple usage\n * ```ts\n * import { getPrimaryNavItems } from '@riverbankcms/sdk/navigation';\n *\n * const headerNav = getPrimaryNavItems(siteData.navigation);\n * // [{ href: '/', label: 'Home', isExternal: false }, ...]\n * ```\n *\n * @example Block rendering usage\n * ```ts\n * import { buildMenuViewModel, buildLogoViewModel } from '@riverbankcms/sdk/navigation';\n *\n * const menu = buildMenuViewModel(siteData.navigation);\n * const logo = buildLogoViewModel(siteData.layout.logo, siteData.site.title);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { menu, content: { logo } },\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '@riverbankcms/api';\nimport type { RouteMap } from '@riverbankcms/blocks';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types for block rendering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Link value types matching @riverbankcms/blocks\n */\nexport type InternalLinkValue = {\n  kind: 'internal';\n  routeId: string;\n  entityId: string;\n  entityType: 'page' | 'content';\n  href: string;\n  title: string;\n  typeLabel: string;\n  contentTypeKey?: string | null;\n  contentTypeName?: string | null;\n  updatedAt?: string | null;\n};\n\nexport type ExternalLinkValue = {\n  kind: 'external';\n  href: string;\n};\n\nexport type CustomLinkValue = {\n  kind: 'url';\n  href: string;\n};\n\nexport type LinkValue = InternalLinkValue | ExternalLinkValue | CustomLinkValue;\n\n/**\n * Menu link view model for block rendering\n */\nexport type MenuLinkViewModel = {\n  id: string;\n  label: string;\n  link: LinkValue | null;\n  target: string | null;\n  rel: string | null;\n  active?: boolean;\n};\n\n/**\n * CTA link view model (extends MenuLinkViewModel with variant)\n */\nexport type MenuCtaViewModel = MenuLinkViewModel & {\n  variant: string;\n};\n\n/**\n * Complete menu view model for header/footer blocks\n */\nexport type MenuViewModel = {\n  items: MenuLinkViewModel[];\n  ctaItem: MenuCtaViewModel | null;\n};\n\n/**\n * Logo source data from site layout\n */\nexport type LogoSource = {\n  url: string | null;\n  alt: string | null;\n  assetId?: string | null;\n  width?: number | null;\n  height?: number | null;\n  storagePath?: string | null;\n  storageBucket?: string | null;\n} | null;\n\n/**\n * Logo view model for block rendering\n */\nexport type LogoViewModel = {\n  type: 'image';\n  src: string;\n  alt: string;\n  assetId?: string;\n  width?: number | null;\n  height?: number | null;\n  storagePath?: string;\n  storageBucket?: string;\n} | null;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple NavItem type for basic usage\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * A simplified navigation item structure for component rendering.\n */\nexport type NavItem = {\n  /** The URL to navigate to */\n  href: string;\n  /** Display text for the navigation link */\n  label: string;\n  /** Whether link should open in new tab (external links) */\n  isExternal: boolean;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Nested Navigation Types (with dropdown support)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * A navigation link item with a direct URL.\n * Use `kind` discriminator for type-safe narrowing.\n *\n * @example\n * ```ts\n * if (item.kind === 'link') {\n *   console.log(item.href);  // TypeScript knows href exists\n * }\n * ```\n */\nexport type NavLink = {\n  /** Discriminator for type narrowing */\n  kind: 'link';\n  /** Unique identifier from CMS */\n  id: string;\n  /** Display text for the navigation link */\n  label: string;\n  /** The URL to navigate to */\n  href: string;\n  /** Whether link should open in new tab (external links) */\n  isExternal: boolean;\n};\n\n/**\n * A dropdown container holding child navigation items.\n * Clicking reveals children instead of navigating.\n * Max 1 level of nesting (children are always NavLink, not NavDropdown).\n */\nexport type NavDropdown = {\n  /** Discriminator for type narrowing */\n  kind: 'dropdown';\n  /** Unique identifier from CMS */\n  id: string;\n  /** Display text for the dropdown trigger */\n  label: string;\n  /** Child navigation links */\n  children: NavLink[];\n};\n\n/**\n * Unified navigation item supporting both links and dropdowns.\n * Use `kind` property for type-safe discrimination.\n *\n * @example\n * ```ts\n * const items = getNestedPrimaryNavItems(navigation);\n * items.forEach(item => {\n *   if (item.kind === 'link') {\n *     console.log(item.href);\n *   } else {\n *     console.log(item.children.length);\n *   }\n * });\n * ```\n */\nexport type NestedNavItem = NavLink | NavDropdown;\n\n/**\n * Type guard to check if a navigation item is a link.\n */\nexport function isNavLink(item: NestedNavItem): item is NavLink {\n  return item.kind === 'link';\n}\n\n/**\n * Type guard to check if a navigation item is a dropdown.\n */\nexport function isNavDropdown(item: NestedNavItem): item is NavDropdown {\n  return item.kind === 'dropdown';\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple types for block rendering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Simple nav link with pre-resolved href for block rendering.\n */\nexport type SimpleNavLink = {\n  id: string;\n  label: string;\n  href: string;\n  isExternal: boolean;\n};\n\n/**\n * Simple menu view model with pre-resolved hrefs.\n * Use this instead of MenuViewModel for cleaner data flow.\n */\nexport type SimpleMenuViewModel = {\n  items: SimpleNavLink[];\n  ctaItem: SimpleNavLink | null;\n};\n\n/**\n * Simple nested nav link with pre-resolved href.\n */\nexport type SimpleNestedNavLink = {\n  kind: 'link';\n  id: string;\n  label: string;\n  href: string;\n  isExternal: boolean;\n};\n\n/**\n * Simple nested dropdown with pre-resolved children.\n */\nexport type SimpleNestedNavDropdown = {\n  kind: 'dropdown';\n  id: string;\n  label: string;\n  children: SimpleNestedNavLink[];\n};\n\n/**\n * Unified simple nested navigation item.\n */\nexport type SimpleNestedNavItem = SimpleNestedNavLink | SimpleNestedNavDropdown;\n\n/**\n * Simple menu view model with nested navigation support.\n */\nexport type SimpleNestedMenuViewModel = {\n  items: SimpleNestedNavItem[];\n  ctaItem: SimpleNestedNavLink | null;\n};\n\n/**\n * Simple logo data for block rendering.\n */\nexport type SimpleLogo = {\n  type: 'image';\n  src: string;\n  alt: string;\n  width?: number;\n  height?: number;\n} | null;\n\n// RouteMap type is imported from @riverbankcms/blocks for consistency\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Menu selection helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get the primary navigation menu object.\n * Returns menu marked as isPrimary, or first menu if none marked.\n *\n * @example\n * ```ts\n * const menu = getPrimaryNavigation(siteData.navigation);\n * console.log(menu?.title); // \"Main Navigation\"\n * ```\n */\nexport function getPrimaryNavigation(\n  navigation: NavigationMenuWithItems[],\n): NavigationMenuWithItems | null {\n  if (!navigation || navigation.length === 0) return null;\n  // navigation.length > 0 is guaranteed above, so [0] exists\n  return navigation.find((menu) => menu.isPrimary) ?? navigation[0] ?? null;\n}\n\n/**\n * Get a navigation menu by name/slug.\n *\n * @example\n * ```ts\n * const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');\n * ```\n */\nexport function getNavigationBySlug(\n  navigation: NavigationMenuWithItems[],\n  slug: string,\n): NavigationMenuWithItems | null {\n  if (!navigation || navigation.length === 0) return null;\n  return navigation.find((menu) => menu.name === slug) ?? null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple NavItem[] transformations\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get nav items from the primary menu (marked isPrimary, or first menu).\n * Returns empty array if no navigation configured.\n *\n * @example\n * ```ts\n * const headerNav = getPrimaryNavItems(siteData.navigation);\n * // [{ href: '/', label: 'Home', isExternal: false }, ...]\n * ```\n */\nexport function getPrimaryNavItems(navigation: NavigationMenuWithItems[]): NavItem[] {\n  return transformToNavItems(getPrimaryNavigation(navigation));\n}\n\n/**\n * Get nav items from a specific menu by slug.\n * Useful for footer nav, secondary nav, etc.\n * Returns empty array if menu not found.\n *\n * @example\n * ```ts\n * const footerNav = getNavItemsBySlug(siteData.navigation, 'footer');\n * ```\n */\nexport function getNavItemsBySlug(navigation: NavigationMenuWithItems[], slug: string): NavItem[] {\n  return transformToNavItems(getNavigationBySlug(navigation, slug));\n}\n\n/**\n * Transform a menu into simple NavItem array.\n */\nexport function transformToNavItems(menu: NavigationMenuWithItems | null): NavItem[] {\n  if (!menu?.items || menu.items.length === 0) return [];\n\n  return menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0))\n    .map((item) => ({\n      label: item.label,\n      href: extractHref(item),\n      isExternal: isExternalLink(item),\n    }))\n    .filter((item): item is NavItem => Boolean(item.href));\n}\n\n/**\n * Transform a menu into nested NestedNavItem array.\n * Builds tree structure from flat items, supporting dropdowns with children.\n *\n * @example\n * ```ts\n * const nav = transformToNestedNavItems(menu);\n * // [\n * //   { kind: 'link', href: '/', label: 'Home', ... },\n * //   { kind: 'dropdown', label: 'Services', children: [...] },\n * // ]\n * ```\n */\nexport function transformToNestedNavItems(\n  menu: NavigationMenuWithItems | null\n): NestedNavItem[] {\n  if (!menu?.items || menu.items.length === 0) return [];\n\n  const toNavLink = (item: NavigationItemRecord): NavLink | null => {\n    const href = extractHref(item);\n    if (!href) return null;\n    return {\n      kind: 'link',\n      id: item.id,\n      label: item.label,\n      href,\n      isExternal: isExternalLink(item),\n    };\n  };\n\n  const { items } = buildNestedStructure<NavLink, NavDropdown, NavLink>(\n    menu.items,\n    {\n      toLink: toNavLink,\n      createDropdown: (id, label, children) => ({\n        kind: 'dropdown',\n        id,\n        label,\n        children,\n      }),\n      extractCta: false,\n    }\n  );\n\n  return items;\n}\n\n/**\n * Get nested nav items from the primary menu.\n * Supports dropdowns with children for complex navigation structures.\n *\n * @example\n * ```ts\n * const nav = getNestedPrimaryNavItems(siteData.navigation);\n * nav.forEach(item => {\n *   if (item.kind === 'dropdown') {\n *     console.log(`${item.label} has ${item.children.length} children`);\n *   }\n * });\n * ```\n */\nexport function getNestedPrimaryNavItems(\n  navigation: NavigationMenuWithItems[]\n): NestedNavItem[] {\n  return transformToNestedNavItems(getPrimaryNavigation(navigation));\n}\n\n/**\n * Get nested nav items from a specific menu by slug.\n *\n * @example\n * ```ts\n * const footerNav = getNestedNavItemsBySlug(siteData.navigation, 'footer');\n * ```\n */\nexport function getNestedNavItemsBySlug(\n  navigation: NavigationMenuWithItems[],\n  slug: string\n): NestedNavItem[] {\n  return transformToNestedNavItems(getNavigationBySlug(navigation, slug));\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Full MenuViewModel for block rendering\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a MenuViewModel from navigation data for block rendering.\n * Extracts CTA item separately and preserves full link data.\n *\n * @example\n * ```ts\n * const menuViewModel = buildMenuViewModel(siteData.navigation);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { menu: menuViewModel },\n * });\n * ```\n */\nexport function buildMenuViewModel(navigation: NavigationMenuWithItems[]): MenuViewModel {\n  const menu = getPrimaryNavigation(navigation);\n\n  if (!menu) {\n    return { items: [], ctaItem: null };\n  }\n\n  const flatItems = menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));\n\n  const items: MenuLinkViewModel[] = [];\n  let ctaItem: MenuCtaViewModel | null = null;\n\n  for (const item of flatItems) {\n    const viewItem: MenuLinkViewModel = {\n      id: item.id,\n      label: item.label,\n      link: convertToLinkValue(item),\n      target: null,\n      rel: null,\n      active: false,\n    };\n\n    // Extract first CTA item separately\n    if (!ctaItem && Boolean(item.isCta)) {\n      ctaItem = { ...viewItem, variant: 'primary' };\n      continue;\n    }\n\n    items.push(viewItem);\n  }\n\n  return { items, ctaItem };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Logo view model helper\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a LogoViewModel from site layout data.\n *\n * @param logo - Logo source from siteData.layout.logo\n * @param fallbackTitle - Site title to use as alt text fallback\n *\n * @example\n * ```ts\n * const logoViewModel = buildLogoViewModel(siteData.layout.logo, siteData.site.title);\n *\n * renderBlock(siteHeaderManifest, layout.header, {\n *   viewModelOverrides: { content: { logo: logoViewModel } },\n * });\n * ```\n */\nexport function buildLogoViewModel(\n  logo: LogoSource,\n  fallbackTitle: string | null | undefined,\n): LogoViewModel {\n  if (!logo) {\n    return null;\n  }\n\n  // Logo must have storagePath (for direct Supabase URL) or explicit url\n  if (!logo.url && !logo.storagePath) {\n    return null;\n  }\n\n  const alt = logo.alt && logo.alt.trim().length > 0 ? logo.alt : fallbackTitle ?? 'Site logo';\n\n  return {\n    type: 'image',\n    src: logo.url ?? '', // Empty when using storagePath - MediaNode builds direct URL\n    alt,\n    assetId: logo.assetId ?? undefined,\n    width: logo.width ?? undefined,\n    height: logo.height ?? undefined,\n    storagePath: logo.storagePath ?? undefined,\n    storageBucket: logo.storageBucket ?? undefined,\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Internal helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Extracts the href from a navigation item's url field.\n */\nfunction extractHref(item: NavigationItemRecord): string {\n  const link = item.url as LinkPayload | null | undefined;\n  if (!link || typeof link !== 'object' || !('href' in link)) return '';\n  return link.href;\n}\n\n/**\n * Determines if a navigation item's link is external.\n */\nfunction isExternalLink(item: NavigationItemRecord): boolean {\n  const link = item.url as LinkPayload | null | undefined;\n  if (!link || typeof link !== 'object' || !('kind' in link)) return false;\n  return link.kind === 'external';\n}\n\n/**\n * Build a map of children items by parent ID.\n * Also warns about deeply nested items (grandchildren) which CMS shouldn't allow.\n * @internal\n */\nfunction buildChildrenByParentId(\n  items: NavigationItemRecord[]\n): Map<string, NavigationItemRecord[]> {\n  const childrenByParentId = new Map<string, NavigationItemRecord[]>();\n  const itemsById = new Map<string, NavigationItemRecord>();\n\n  // First pass: index items by ID\n  for (const item of items) {\n    itemsById.set(item.id, item);\n  }\n\n  // Second pass: build children map and warn about deep nesting\n  for (const item of items) {\n    if (item.parentId) {\n      // Check if parent is itself a child (deep nesting)\n      const parent = itemsById.get(item.parentId);\n      if (parent?.parentId && typeof process !== 'undefined' && process.env.NODE_ENV !== 'production') {\n        console.warn(\n          `[SDK Navigation] Deeply nested item detected: \"${item.label}\" (id: ${item.id}). ` +\n          `Only 1 level of nesting is supported. This item will be ignored.`\n        );\n        continue; // Skip deeply nested items\n      }\n\n      const siblings = childrenByParentId.get(item.parentId) ?? [];\n      siblings.push(item);\n      childrenByParentId.set(item.parentId, siblings);\n    }\n  }\n\n  return childrenByParentId;\n}\n\n/**\n * Generic nested structure builder.\n * Extracts shared logic between transformToNestedNavItems and buildSimpleNestedMenu.\n * @internal\n */\nfunction buildNestedStructure<TLink, TDropdown, TCta extends TLink>(\n  items: NavigationItemRecord[],\n  options: {\n    /** Convert a navigation item record to a link type */\n    toLink: (item: NavigationItemRecord) => TLink | null;\n    /** Create a dropdown from id, label, and children */\n    createDropdown: (id: string, label: string, children: TLink[]) => TDropdown;\n    /** Extract CTA from items (return null to skip CTA extraction) */\n    extractCta?: boolean;\n  }\n): { items: (TLink | TDropdown)[]; ctaItem: TCta | null } {\n  const childrenByParentId = buildChildrenByParentId(items);\n\n  // Process root items (no parentId) sorted by orderIndex\n  const rootItems = items\n    .filter((item) => !item.parentId)\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));\n\n  const result: (TLink | TDropdown)[] = [];\n  let ctaItem: TCta | null = null;\n\n  for (const item of rootItems) {\n    // Handle CTA extraction (CTAs are always links, not dropdowns)\n    if (options.extractCta && !ctaItem && Boolean(item.isCta) && item.urlType !== 'dropdown') {\n      const link = options.toLink(item);\n      if (link) {\n        ctaItem = link as TCta;\n        continue;\n      }\n    }\n\n    if (item.urlType === 'dropdown') {\n      // It's a dropdown - gather its children\n      const childRecords = childrenByParentId.get(item.id) ?? [];\n      const children = childRecords\n        .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0))\n        .map(options.toLink)\n        .filter((child): child is TLink => child !== null);\n\n      // Only include dropdown if it has children\n      if (children.length > 0) {\n        result.push(options.createDropdown(item.id, item.label, children));\n      }\n    } else {\n      // It's a regular link\n      const link = options.toLink(item);\n      if (link) {\n        result.push(link);\n      }\n    }\n  }\n\n  return { items: result, ctaItem };\n}\n\n/**\n * Convert navigation item to LinkValue for block rendering.\n */\nfunction convertToLinkValue(item: NavigationItemRecord): LinkValue | null {\n  const payload = item.url as Record<string, unknown> | null;\n  if (!payload) return null;\n\n  const kind = typeof payload.kind === 'string' ? payload.kind : null;\n\n  if (kind === 'external' || kind === 'url') {\n    const href = typeof payload.href === 'string' ? payload.href : null;\n    return href ? { kind, href } as ExternalLinkValue | CustomLinkValue : null;\n  }\n\n  if (kind === 'internal') {\n    const routeId = typeof payload.routeId === 'string' ? payload.routeId : null;\n    const entityId = typeof payload.entityId === 'string' ? payload.entityId : null;\n    const entityType = payload.entityType === 'page' || payload.entityType === 'content'\n      ? payload.entityType\n      : null;\n    const href = typeof payload.href === 'string' ? payload.href : null;\n    const title = typeof payload.title === 'string' ? payload.title : null;\n    const typeLabel = typeof payload.typeLabel === 'string' ? payload.typeLabel : null;\n\n    if (!routeId || !entityId || !entityType || !href || !title || !typeLabel) {\n      return null;\n    }\n\n    return {\n      kind: 'internal',\n      routeId,\n      entityId,\n      entityType,\n      href,\n      title,\n      typeLabel,\n      contentTypeKey: typeof payload.contentTypeKey === 'string' ? payload.contentTypeKey : null,\n      contentTypeName: typeof payload.contentTypeName === 'string' ? payload.contentTypeName : null,\n      updatedAt: typeof payload.updatedAt === 'string' ? payload.updatedAt : null,\n    };\n  }\n\n  return null;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Simple pre-resolved menu/logo helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a SimpleMenuViewModel from navigation data with pre-resolved hrefs.\n * Use this instead of buildMenuViewModel for cleaner data flow.\n *\n * @param navigation - Navigation menus from site data\n * @param routes - Route map for resolving internal links\n *\n * @example\n * ```ts\n * const menu = buildSimpleMenu(siteData.navigation, siteData.routes);\n * // { items: [{ id, label, href: '/', isExternal: false }], cta: null }\n * ```\n */\nexport function buildSimpleMenu(\n  navigation: NavigationMenuWithItems[],\n  routes: RouteMap,\n): SimpleMenuViewModel {\n  const menu = getPrimaryNavigation(navigation);\n\n  if (!menu) {\n    return { items: [], ctaItem: null };\n  }\n\n  const flatItems = menu.items\n    .filter((item) => !item.parentId && item.urlType !== 'dropdown')\n    .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));\n\n  const items: SimpleNavLink[] = [];\n  let ctaItem: SimpleNavLink | null = null;\n\n  for (const item of flatItems) {\n    const link = item.url as LinkPayload | null;\n    const href = resolveHref(link, routes);\n\n    if (!href) continue;\n\n    const navLink: SimpleNavLink = {\n      id: item.id,\n      label: item.label,\n      href,\n      isExternal: link?.kind === 'external',\n    };\n\n    // Extract first CTA item separately\n    if (!ctaItem && Boolean(item.isCta)) {\n      ctaItem = navLink;\n      continue;\n    }\n\n    items.push(navLink);\n  }\n\n  return { items, ctaItem };\n}\n\n/**\n * Build a SimpleNestedMenuViewModel with pre-resolved hrefs.\n * Supports dropdown containers with nested children.\n *\n * @example\n * ```ts\n * const menu = buildSimpleNestedMenu(siteData.navigation, siteData.routes);\n * menu.items.forEach(item => {\n *   if (item.kind === 'dropdown') {\n *     console.log(item.children);\n *   }\n * });\n * ```\n */\nexport function buildSimpleNestedMenu(\n  navigation: NavigationMenuWithItems[],\n  routes: RouteMap,\n): SimpleNestedMenuViewModel {\n  const menu = getPrimaryNavigation(navigation);\n\n  if (!menu) {\n    return { items: [], ctaItem: null };\n  }\n\n  const toSimpleLink = (item: NavigationItemRecord): SimpleNestedNavLink | null => {\n    const link = item.url as LinkPayload | null;\n    const href = resolveHref(link, routes);\n    if (!href) return null;\n\n    return {\n      kind: 'link',\n      id: item.id,\n      label: item.label,\n      href,\n      isExternal: link?.kind === 'external',\n    };\n  };\n\n  return buildNestedStructure<SimpleNestedNavLink, SimpleNestedNavDropdown, SimpleNestedNavLink>(\n    menu.items,\n    {\n      toLink: toSimpleLink,\n      createDropdown: (id, label, children) => ({\n        kind: 'dropdown',\n        id,\n        label,\n        children,\n      }),\n      extractCta: true,\n    }\n  );\n}\n\n/**\n * Resolve href from a link payload using route map.\n * @internal\n */\nfunction resolveHref(link: LinkPayload | null, routes: RouteMap): string | null {\n  if (!link) return null;\n\n  // External or custom URL links - use href directly\n  if (link.kind === 'external' || link.kind === 'url') {\n    return link.href || null;\n  }\n\n  // Internal link - resolve from route map\n  if (link.kind === 'internal' && link.routeId) {\n    const route = routes[link.routeId];\n    if (route) {\n      if (typeof route === 'string') {\n        return route;\n      }\n      // Try path first, then href, then draftPath\n      return route.path ?? route.href ?? route.draftPath ?? link.href ?? null;\n    }\n    // Fall back to link.href if route not found\n    return link.href ?? null;\n  }\n\n  return null;\n}\n\n/**\n * Build a SimpleLogo from site layout data.\n *\n * @param logo - Logo data from site layout\n * @param fallbackAlt - Fallback alt text (usually site title)\n *\n * @example\n * ```ts\n * const logo = buildSimpleLogo(siteData.layout.logo, siteData.site.title);\n * // { src: 'https://...', alt: 'Site Name', width: 200, height: 50 }\n * ```\n */\nexport function buildSimpleLogo(\n  logo: { url?: string | null; alt?: string | null; width?: number | null; height?: number | null } | null,\n  fallbackAlt: string | null | undefined,\n): SimpleLogo {\n  if (!logo || !logo.url) {\n    return null;\n  }\n\n  const alt = logo.alt && logo.alt.trim().length > 0 ? logo.alt : (fallbackAlt ?? 'Site logo');\n\n  const result: NonNullable<SimpleLogo> = {\n    type: 'image',\n    src: logo.url,\n    alt,\n  };\n\n  if (logo.width != null) {\n    result.width = logo.width;\n  }\n  if (logo.height != null) {\n    result.height = logo.height;\n  }\n\n  return result;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Deprecated aliases (for backwards compatibility during migration)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * @deprecated Use `transformToNavItems` instead.\n * This alias is maintained for backwards compatibility only.\n */\nexport const transformNavItems = transformToNavItems;\n\n/**\n * @deprecated Use `getPrimaryNavigation` instead.\n * This alias is maintained for backwards compatibility only.\n */\nexport const selectPrimaryMenu = getPrimaryNavigation;\n\n// Re-export types for convenience\nexport type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '@riverbankcms/api';\n"]}

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

@@ -1 +0,0 @@
-{"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 } from '../../client/types';\nimport type { PageProps } from '../components/Page';\nimport { prefetchBlockData } from '../../data/prefetchBlockData';\nimport type { ResolvedBlockData } from '../../data/prefetchBlockData';\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};\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};\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    };\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  };\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"]}