@riverbankcms/sdk 0.4.2 → 0.5.0

package/dist/server/navigation.d.mts

@@ -1,33 +1,115 @@
-import { N as NavigationMenuWithItems } from './types-CdrJqlKx.mjs';
-export { L as LinkPayload, a as NavigationItemRecord } from './types-CdrJqlKx.mjs';
+import { N as NavigationMenuWithItems } from './types-DuzJZKJI.mjs';
+export { L as LinkPayload, a as NavigationItemRecord } from './types-DuzJZKJI.mjs';
+import { R as RouteMap } from './core-DsNWrl3o.mjs';
+import './schema-Z6-afHJG.mjs';
 import '@riverbankcms/ai';
-import './schema-Bpy9N5ZI.mjs';
 import 'zod';
+import './link-DjxLyC82.mjs';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
 
 /**
  * Navigation helper utilities for SDK sites.
  *
- * Provides simple helpers to transform CMS navigation data into
- * render-ready NavItem arrays.
+ * Provides helpers to transform CMS navigation data into render-ready structures.
+ * Supports both simple NavItem arrays and full MenuViewModels for block rendering.
  *
- * @example
+ * @example Simple usage
  * ```ts
- * import { getPrimaryNavItems, getNavItemsBySlug } from '@riverbankcms/sdk/navigation';
+ * import { getPrimaryNavItems } from '@riverbankcms/sdk/navigation';
  *
- * // Get header navigation (primary menu)
  * const headerNav = getPrimaryNavItems(siteData.navigation);
+ * // [{ href: '/', label: 'Home', isExternal: false }, ...]
+ * ```
  *
- * // Get footer navigation by slug
- * const footerNav = getNavItemsBySlug(siteData.navigation, 'footer');
+ * @example Block rendering usage
+ * ```ts
+ * import { buildMenuViewModel, buildLogoViewModel } from '@riverbankcms/sdk/navigation';
+ *
+ * const menu = buildMenuViewModel(siteData.navigation);
+ * const logo = buildLogoViewModel(siteData.layout.logo, siteData.site.title);
  *
- * // Result: [{ href: '/', label: 'Home', isExternal: false }, ...]
+ * renderBlock(siteHeaderManifest, layout.header, {
+ *   viewModelOverrides: { menu, content: { logo } },
+ * });
  * ```
  *
  * @packageDocumentation
  */
 
+/**
+ * Link value types matching @riverbankcms/blocks
+ */
+type InternalLinkValue = {
+    kind: 'internal';
+    routeId: string;
+    entityId: string;
+    entityType: 'page' | 'content';
+    href: string;
+    title: string;
+    typeLabel: string;
+    contentTypeKey?: string | null;
+    contentTypeName?: string | null;
+    updatedAt?: string | null;
+};
+type ExternalLinkValue = {
+    kind: 'external';
+    href: string;
+};
+type CustomLinkValue = {
+    kind: 'url';
+    href: string;
+};
+type LinkValue = InternalLinkValue | ExternalLinkValue | CustomLinkValue;
+/**
+ * Menu link view model for block rendering
+ */
+type MenuLinkViewModel = {
+    id: string;
+    label: string;
+    link: LinkValue | null;
+    target: string | null;
+    rel: string | null;
+    active?: boolean;
+};
+/**
+ * CTA link view model (extends MenuLinkViewModel with variant)
+ */
+type MenuCtaViewModel = MenuLinkViewModel & {
+    variant: string;
+};
+/**
+ * Complete menu view model for header/footer blocks
+ */
+type MenuViewModel = {
+    items: MenuLinkViewModel[];
+    ctaItem: MenuCtaViewModel | null;
+};
+/**
+ * Logo source data from site layout
+ */
+type LogoSource = {
+    url: string | null;
+    alt: string | null;
+    assetId?: string | null;
+    width?: number | null;
+    height?: number | null;
+    storagePath?: string | null;
+    storageBucket?: string | null;
+} | null;
+/**
+ * Logo view model for block rendering
+ */
+type LogoViewModel = {
+    type: 'image';
+    src: string;
+    alt: string;
+    assetId?: string;
+    width?: number | null;
+    height?: number | null;
+    storagePath?: string;
+    storageBucket?: string;
+} | null;
 /**
  * A simplified navigation item structure for component rendering.
  */
@@ -39,6 +121,53 @@ type NavItem = {
     /** Whether link should open in new tab (external links) */
     isExternal: boolean;
 };
+/**
+ * Simple nav link with pre-resolved href for block rendering.
+ */
+type SimpleNavLink = {
+    id: string;
+    label: string;
+    href: string;
+    isExternal: boolean;
+};
+/**
+ * Simple menu view model with pre-resolved hrefs.
+ * Use this instead of MenuViewModel for cleaner data flow.
+ */
+type SimpleMenuViewModel = {
+    items: SimpleNavLink[];
+    ctaItem: SimpleNavLink | null;
+};
+/**
+ * Simple logo data for block rendering.
+ */
+type SimpleLogo = {
+    type: 'image';
+    src: string;
+    alt: string;
+    width?: number;
+    height?: number;
+} | null;
+/**
+ * Get the primary navigation menu object.
+ * Returns menu marked as isPrimary, or first menu if none marked.
+ *
+ * @example
+ * ```ts
+ * const menu = getPrimaryNavigation(siteData.navigation);
+ * console.log(menu?.title); // "Main Navigation"
+ * ```
+ */
+declare function getPrimaryNavigation(navigation: NavigationMenuWithItems[]): NavigationMenuWithItems | null;
+/**
+ * Get a navigation menu by name/slug.
+ *
+ * @example
+ * ```ts
+ * const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');
+ * ```
+ */
+declare function getNavigationBySlug(navigation: NavigationMenuWithItems[], slug: string): NavigationMenuWithItems | null;
 /**
  * Get nav items from the primary menu (marked isPrimary, or first menu).
  * Returns empty array if no navigation configured.
@@ -62,39 +191,80 @@ declare function getPrimaryNavItems(navigation: NavigationMenuWithItems[]): NavI
  */
 declare function getNavItemsBySlug(navigation: NavigationMenuWithItems[], slug: string): NavItem[];
 /**
- * Get the primary navigation menu object.
- * Returns menu marked as isPrimary, or first menu if none marked.
+ * Transform a menu into simple NavItem array.
+ */
+declare function transformToNavItems(menu: NavigationMenuWithItems | null): NavItem[];
+/**
+ * Build a MenuViewModel from navigation data for block rendering.
+ * Extracts CTA item separately and preserves full link data.
  *
  * @example
  * ```ts
- * const menu = getPrimaryNavigation(siteData.navigation);
- * console.log(menu?.title); // "Main Navigation"
- * console.log(menu?.slug);  // "main"
+ * const menuViewModel = buildMenuViewModel(siteData.navigation);
+ *
+ * renderBlock(siteHeaderManifest, layout.header, {
+ *   viewModelOverrides: { menu: menuViewModel },
+ * });
  * ```
  */
-declare function getPrimaryNavigation(navigation: NavigationMenuWithItems[]): NavigationMenuWithItems | null;
+declare function buildMenuViewModel(navigation: NavigationMenuWithItems[]): MenuViewModel;
 /**
- * Get a navigation menu by name.
+ * Build a LogoViewModel from site layout data.
+ *
+ * @param logo - Logo source from siteData.layout.logo
+ * @param fallbackTitle - Site title to use as alt text fallback
  *
  * @example
  * ```ts
- * const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');
+ * const logoViewModel = buildLogoViewModel(siteData.layout.logo, siteData.site.title);
+ *
+ * renderBlock(siteHeaderManifest, layout.header, {
+ *   viewModelOverrides: { content: { logo: logoViewModel } },
+ * });
  * ```
  */
-declare function getNavigationBySlug(navigation: NavigationMenuWithItems[], slug: string): NavigationMenuWithItems | null;
+declare function buildLogoViewModel(logo: LogoSource, fallbackTitle: string | null | undefined): LogoViewModel;
+/**
+ * Build a SimpleMenuViewModel from navigation data with pre-resolved hrefs.
+ * Use this instead of buildMenuViewModel for cleaner data flow.
+ *
+ * @param navigation - Navigation menus from site data
+ * @param routes - Route map for resolving internal links
+ *
+ * @example
+ * ```ts
+ * const menu = buildSimpleMenu(siteData.navigation, siteData.routes);
+ * // { items: [{ id, label, href: '/', isExternal: false }], cta: null }
+ * ```
+ */
+declare function buildSimpleMenu(navigation: NavigationMenuWithItems[], routes: RouteMap): SimpleMenuViewModel;
 /**
- * Transform a menu into NavItem array.
- * - Sorts by orderIndex
- * - Resolves link hrefs
- * - Identifies external links
- * - Filters out items without valid hrefs
+ * Build a SimpleLogo from site layout data.
+ *
+ * @param logo - Logo data from site layout
+ * @param fallbackAlt - Fallback alt text (usually site title)
  *
  * @example
  * ```ts
- * const menu = getNavigationBySlug(siteData.navigation, 'main');
- * const items = transformNavItems(menu);
+ * const logo = buildSimpleLogo(siteData.layout.logo, siteData.site.title);
+ * // { src: 'https://...', alt: 'Site Name', width: 200, height: 50 }
  * ```
  */
-declare function transformNavItems(menu: NavigationMenuWithItems | null): NavItem[];
+declare function buildSimpleLogo(logo: {
+    url?: string | null;
+    alt?: string | null;
+    width?: number | null;
+    height?: number | null;
+} | null, fallbackAlt: string | null | undefined): SimpleLogo;
+/**
+ * @deprecated Use `transformToNavItems` instead.
+ * This alias is maintained for backwards compatibility only.
+ */
+declare const transformNavItems: typeof transformToNavItems;
+/**
+ * @deprecated Use `getPrimaryNavigation` instead.
+ * This alias is maintained for backwards compatibility only.
+ */
+declare const selectPrimaryMenu: typeof getPrimaryNavigation;
 
-export { type NavItem, NavigationMenuWithItems, getNavItemsBySlug, getNavigationBySlug, getPrimaryNavItems, getPrimaryNavigation, transformNavItems };
+export { type CustomLinkValue, type ExternalLinkValue, type InternalLinkValue, type LinkValue, type LogoSource, type LogoViewModel, type MenuCtaViewModel, type MenuLinkViewModel, type MenuViewModel, type NavItem, NavigationMenuWithItems, type SimpleLogo, type SimpleMenuViewModel, type SimpleNavLink, buildLogoViewModel, buildMenuViewModel, buildSimpleLogo, buildSimpleMenu, getNavItemsBySlug, getNavigationBySlug, getPrimaryNavItems, getPrimaryNavigation, selectPrimaryMenu, transformNavItems, transformToNavItems };

package/dist/server/navigation.d.ts

@@ -1,33 +1,115 @@
-import { N as NavigationMenuWithItems } from './types-BiRZnxDx.js';
-export { L as LinkPayload, a as NavigationItemRecord } from './types-BiRZnxDx.js';
+import { N as NavigationMenuWithItems } from './types-C28kMfa1.js';
+export { L as LinkPayload, a as NavigationItemRecord } from './types-C28kMfa1.js';
+import { R as RouteMap } from './core-DsNWrl3o.js';
+import './schema-Z6-afHJG.js';
 import '@riverbankcms/ai';
-import './schema-Bpy9N5ZI.js';
 import 'zod';
+import './link-DjxLyC82.js';
 import '@riverbankcms/media-storage-supabase';
 import '@riverbankcms/db';
 
 /**
  * Navigation helper utilities for SDK sites.
  *
- * Provides simple helpers to transform CMS navigation data into
- * render-ready NavItem arrays.
+ * Provides helpers to transform CMS navigation data into render-ready structures.
+ * Supports both simple NavItem arrays and full MenuViewModels for block rendering.
  *
- * @example
+ * @example Simple usage
  * ```ts
- * import { getPrimaryNavItems, getNavItemsBySlug } from '@riverbankcms/sdk/navigation';
+ * import { getPrimaryNavItems } from '@riverbankcms/sdk/navigation';
  *
- * // Get header navigation (primary menu)
  * const headerNav = getPrimaryNavItems(siteData.navigation);
+ * // [{ href: '/', label: 'Home', isExternal: false }, ...]
+ * ```
  *
- * // Get footer navigation by slug
- * const footerNav = getNavItemsBySlug(siteData.navigation, 'footer');
+ * @example Block rendering usage
+ * ```ts
+ * import { buildMenuViewModel, buildLogoViewModel } from '@riverbankcms/sdk/navigation';
+ *
+ * const menu = buildMenuViewModel(siteData.navigation);
+ * const logo = buildLogoViewModel(siteData.layout.logo, siteData.site.title);
  *
- * // Result: [{ href: '/', label: 'Home', isExternal: false }, ...]
+ * renderBlock(siteHeaderManifest, layout.header, {
+ *   viewModelOverrides: { menu, content: { logo } },
+ * });
  * ```
  *
  * @packageDocumentation
  */
 
+/**
+ * Link value types matching @riverbankcms/blocks
+ */
+type InternalLinkValue = {
+    kind: 'internal';
+    routeId: string;
+    entityId: string;
+    entityType: 'page' | 'content';
+    href: string;
+    title: string;
+    typeLabel: string;
+    contentTypeKey?: string | null;
+    contentTypeName?: string | null;
+    updatedAt?: string | null;
+};
+type ExternalLinkValue = {
+    kind: 'external';
+    href: string;
+};
+type CustomLinkValue = {
+    kind: 'url';
+    href: string;
+};
+type LinkValue = InternalLinkValue | ExternalLinkValue | CustomLinkValue;
+/**
+ * Menu link view model for block rendering
+ */
+type MenuLinkViewModel = {
+    id: string;
+    label: string;
+    link: LinkValue | null;
+    target: string | null;
+    rel: string | null;
+    active?: boolean;
+};
+/**
+ * CTA link view model (extends MenuLinkViewModel with variant)
+ */
+type MenuCtaViewModel = MenuLinkViewModel & {
+    variant: string;
+};
+/**
+ * Complete menu view model for header/footer blocks
+ */
+type MenuViewModel = {
+    items: MenuLinkViewModel[];
+    ctaItem: MenuCtaViewModel | null;
+};
+/**
+ * Logo source data from site layout
+ */
+type LogoSource = {
+    url: string | null;
+    alt: string | null;
+    assetId?: string | null;
+    width?: number | null;
+    height?: number | null;
+    storagePath?: string | null;
+    storageBucket?: string | null;
+} | null;
+/**
+ * Logo view model for block rendering
+ */
+type LogoViewModel = {
+    type: 'image';
+    src: string;
+    alt: string;
+    assetId?: string;
+    width?: number | null;
+    height?: number | null;
+    storagePath?: string;
+    storageBucket?: string;
+} | null;
 /**
  * A simplified navigation item structure for component rendering.
  */
@@ -39,6 +121,53 @@ type NavItem = {
     /** Whether link should open in new tab (external links) */
     isExternal: boolean;
 };
+/**
+ * Simple nav link with pre-resolved href for block rendering.
+ */
+type SimpleNavLink = {
+    id: string;
+    label: string;
+    href: string;
+    isExternal: boolean;
+};
+/**
+ * Simple menu view model with pre-resolved hrefs.
+ * Use this instead of MenuViewModel for cleaner data flow.
+ */
+type SimpleMenuViewModel = {
+    items: SimpleNavLink[];
+    ctaItem: SimpleNavLink | null;
+};
+/**
+ * Simple logo data for block rendering.
+ */
+type SimpleLogo = {
+    type: 'image';
+    src: string;
+    alt: string;
+    width?: number;
+    height?: number;
+} | null;
+/**
+ * Get the primary navigation menu object.
+ * Returns menu marked as isPrimary, or first menu if none marked.
+ *
+ * @example
+ * ```ts
+ * const menu = getPrimaryNavigation(siteData.navigation);
+ * console.log(menu?.title); // "Main Navigation"
+ * ```
+ */
+declare function getPrimaryNavigation(navigation: NavigationMenuWithItems[]): NavigationMenuWithItems | null;
+/**
+ * Get a navigation menu by name/slug.
+ *
+ * @example
+ * ```ts
+ * const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');
+ * ```
+ */
+declare function getNavigationBySlug(navigation: NavigationMenuWithItems[], slug: string): NavigationMenuWithItems | null;
 /**
  * Get nav items from the primary menu (marked isPrimary, or first menu).
  * Returns empty array if no navigation configured.
@@ -62,39 +191,80 @@ declare function getPrimaryNavItems(navigation: NavigationMenuWithItems[]): NavI
  */
 declare function getNavItemsBySlug(navigation: NavigationMenuWithItems[], slug: string): NavItem[];
 /**
- * Get the primary navigation menu object.
- * Returns menu marked as isPrimary, or first menu if none marked.
+ * Transform a menu into simple NavItem array.
+ */
+declare function transformToNavItems(menu: NavigationMenuWithItems | null): NavItem[];
+/**
+ * Build a MenuViewModel from navigation data for block rendering.
+ * Extracts CTA item separately and preserves full link data.
  *
  * @example
  * ```ts
- * const menu = getPrimaryNavigation(siteData.navigation);
- * console.log(menu?.title); // "Main Navigation"
- * console.log(menu?.slug);  // "main"
+ * const menuViewModel = buildMenuViewModel(siteData.navigation);
+ *
+ * renderBlock(siteHeaderManifest, layout.header, {
+ *   viewModelOverrides: { menu: menuViewModel },
+ * });
  * ```
  */
-declare function getPrimaryNavigation(navigation: NavigationMenuWithItems[]): NavigationMenuWithItems | null;
+declare function buildMenuViewModel(navigation: NavigationMenuWithItems[]): MenuViewModel;
 /**
- * Get a navigation menu by name.
+ * Build a LogoViewModel from site layout data.
+ *
+ * @param logo - Logo source from siteData.layout.logo
+ * @param fallbackTitle - Site title to use as alt text fallback
  *
  * @example
  * ```ts
- * const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');
+ * const logoViewModel = buildLogoViewModel(siteData.layout.logo, siteData.site.title);
+ *
+ * renderBlock(siteHeaderManifest, layout.header, {
+ *   viewModelOverrides: { content: { logo: logoViewModel } },
+ * });
  * ```
  */
-declare function getNavigationBySlug(navigation: NavigationMenuWithItems[], slug: string): NavigationMenuWithItems | null;
+declare function buildLogoViewModel(logo: LogoSource, fallbackTitle: string | null | undefined): LogoViewModel;
+/**
+ * Build a SimpleMenuViewModel from navigation data with pre-resolved hrefs.
+ * Use this instead of buildMenuViewModel for cleaner data flow.
+ *
+ * @param navigation - Navigation menus from site data
+ * @param routes - Route map for resolving internal links
+ *
+ * @example
+ * ```ts
+ * const menu = buildSimpleMenu(siteData.navigation, siteData.routes);
+ * // { items: [{ id, label, href: '/', isExternal: false }], cta: null }
+ * ```
+ */
+declare function buildSimpleMenu(navigation: NavigationMenuWithItems[], routes: RouteMap): SimpleMenuViewModel;
 /**
- * Transform a menu into NavItem array.
- * - Sorts by orderIndex
- * - Resolves link hrefs
- * - Identifies external links
- * - Filters out items without valid hrefs
+ * Build a SimpleLogo from site layout data.
+ *
+ * @param logo - Logo data from site layout
+ * @param fallbackAlt - Fallback alt text (usually site title)
  *
  * @example
  * ```ts
- * const menu = getNavigationBySlug(siteData.navigation, 'main');
- * const items = transformNavItems(menu);
+ * const logo = buildSimpleLogo(siteData.layout.logo, siteData.site.title);
+ * // { src: 'https://...', alt: 'Site Name', width: 200, height: 50 }
  * ```
  */
-declare function transformNavItems(menu: NavigationMenuWithItems | null): NavItem[];
+declare function buildSimpleLogo(logo: {
+    url?: string | null;
+    alt?: string | null;
+    width?: number | null;
+    height?: number | null;
+} | null, fallbackAlt: string | null | undefined): SimpleLogo;
+/**
+ * @deprecated Use `transformToNavItems` instead.
+ * This alias is maintained for backwards compatibility only.
+ */
+declare const transformNavItems: typeof transformToNavItems;
+/**
+ * @deprecated Use `getPrimaryNavigation` instead.
+ * This alias is maintained for backwards compatibility only.
+ */
+declare const selectPrimaryMenu: typeof getPrimaryNavigation;
 
-export { type NavItem, NavigationMenuWithItems, getNavItemsBySlug, getNavigationBySlug, getPrimaryNavItems, getPrimaryNavigation, transformNavItems };
+export { type CustomLinkValue, type ExternalLinkValue, type InternalLinkValue, type LinkValue, type LogoSource, type LogoViewModel, type MenuCtaViewModel, type MenuLinkViewModel, type MenuViewModel, type NavItem, NavigationMenuWithItems, type SimpleLogo, type SimpleMenuViewModel, type SimpleNavLink, buildLogoViewModel, buildMenuViewModel, buildSimpleLogo, buildSimpleMenu, getNavItemsBySlug, getNavigationBySlug, getPrimaryNavItems, getPrimaryNavigation, selectPrimaryMenu, transformNavItems, transformToNavItems };

package/dist/server/navigation.js

@@ -1,44 +1,28 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }require('./chunk-DGUM43GV.js');
-
-// src/navigation/index.ts
-function getPrimaryNavItems(navigation) {
-  return transformNavItems(getPrimaryNavigation(navigation));
-}
-function getNavItemsBySlug(navigation, slug) {
-  return transformNavItems(getNavigationBySlug(navigation, slug));
-}
-function getPrimaryNavigation(navigation) {
-  if (!navigation || navigation.length === 0) return null;
-  return _nullishCoalesce(navigation.find((menu) => menu.isPrimary), () => ( navigation[0]));
-}
-function getNavigationBySlug(navigation, slug) {
-  if (!navigation || navigation.length === 0) return null;
-  return _nullishCoalesce(navigation.find((menu) => menu.name === slug), () => ( null));
-}
-function transformNavItems(menu) {
-  if (!_optionalChain([menu, 'optionalAccess', _ => _.items]) || menu.items.length === 0) return [];
-  const items = menu.items;
-  return items.slice().sort((a, b) => (_nullishCoalesce(a.orderIndex, () => ( 0))) - (_nullishCoalesce(b.orderIndex, () => ( 0)))).map((item) => ({
-    label: item.label,
-    href: resolveItemHref(item),
-    isExternal: isExternalLink(item)
-  })).filter((item) => Boolean(item.href));
-}
-function resolveItemHref(item) {
-  const link = item.url;
-  if (!link || typeof link !== "object" || !("href" in link)) return "";
-  return link.href;
-}
-function isExternalLink(item) {
-  const link = item.url;
-  if (!link || typeof link !== "object" || !("kind" in link)) return false;
-  return link.kind === "external";
-}
-
-
-
-
-
-
-exports.getNavItemsBySlug = getNavItemsBySlug; exports.getNavigationBySlug = getNavigationBySlug; exports.getPrimaryNavItems = getPrimaryNavItems; exports.getPrimaryNavigation = getPrimaryNavigation; exports.transformNavItems = transformNavItems;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+var _chunk5STV4MWDjs = require('./chunk-5STV4MWD.js');
+require('./chunk-DGUM43GV.js');
+
+
+
+
+
+
+
+
+
+
+
+
+exports.buildLogoViewModel = _chunk5STV4MWDjs.buildLogoViewModel; exports.buildMenuViewModel = _chunk5STV4MWDjs.buildMenuViewModel; exports.buildSimpleLogo = _chunk5STV4MWDjs.buildSimpleLogo; exports.buildSimpleMenu = _chunk5STV4MWDjs.buildSimpleMenu; exports.getNavItemsBySlug = _chunk5STV4MWDjs.getNavItemsBySlug; exports.getNavigationBySlug = _chunk5STV4MWDjs.getNavigationBySlug; exports.getPrimaryNavItems = _chunk5STV4MWDjs.getPrimaryNavItems; exports.getPrimaryNavigation = _chunk5STV4MWDjs.getPrimaryNavigation; exports.selectPrimaryMenu = _chunk5STV4MWDjs.selectPrimaryMenu; exports.transformNavItems = _chunk5STV4MWDjs.transformNavItems; exports.transformToNavItems = _chunk5STV4MWDjs.transformToNavItems;
 //# sourceMappingURL=navigation.js.map

package/dist/server/navigation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/navigation.js","../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,gtBAA4B;AAC5B;AACA;ACgDO,SAAS,kBAAA,CAAmB,UAAA,EAAkD;AACnF,EAAA,OAAO,iBAAA,CAAkB,oBAAA,CAAqB,UAAU,CAAC,CAAA;AAC3D;AAYO,SAAS,iBAAA,CAAkB,UAAA,EAAuC,IAAA,EAAyB;AAChG,EAAA,OAAO,iBAAA,CAAkB,mBAAA,CAAoB,UAAA,EAAY,IAAI,CAAC,CAAA;AAChE;AAiBO,SAAS,oBAAA,CACd,UAAA,EACgC;AAChC,EAAA,GAAA,CAAI,CAAC,WAAA,GAAc,UAAA,CAAW,OAAA,IAAW,CAAA,EAAG,OAAO,IAAA;AACnD,EAAA,wBAAO,UAAA,CAAW,IAAA,CAAK,CAAC,IAAA,EAAA,GAAS,IAAA,CAAK,SAAS,CAAA,UAAK,UAAA,CAAW,CAAC,GAAA;AAClE;AAUO,SAAS,mBAAA,CACd,UAAA,EACA,IAAA,EACgC;AAChC,EAAA,GAAA,CAAI,CAAC,WAAA,GAAc,UAAA,CAAW,OAAA,IAAW,CAAA,EAAG,OAAO,IAAA;AAEnD,EAAA,wBAAO,UAAA,CAAW,IAAA,CAAK,CAAC,IAAA,EAAA,GAAS,IAAA,CAAK,KAAA,IAAS,IAAI,CAAA,UAAK,MAAA;AAC1D;AAeO,SAAS,iBAAA,CAAkB,IAAA,EAAiD;AACjF,EAAA,GAAA,CAAI,iBAAC,IAAA,2BAAM,QAAA,GAAS,IAAA,CAAK,KAAA,CAAM,OAAA,IAAW,CAAA,EAAG,OAAO,CAAC,CAAA;AAErD,EAAA,MAAM,MAAA,EAAgC,IAAA,CAAK,KAAA;AAE3C,EAAA,OAAO,KAAA,CACJ,KAAA,CAAM,CAAA,CACN,IAAA,CAAK,CAAC,CAAA,EAAyB,CAAA,EAAA,GAAA,kBAA6B,CAAA,CAAE,UAAA,UAAc,GAAA,EAAA,EAAA,kBAAM,CAAA,CAAE,UAAA,UAAc,GAAA,CAAE,CAAA,CACpG,GAAA,CAAI,CAAC,IAAA,EAAA,GAAA,CAAgC;AAAA,IACpC,KAAA,EAAO,IAAA,CAAK,KAAA;AAAA,IACZ,IAAA,EAAM,eAAA,CAAgB,IAAI,CAAA;AAAA,IAC1B,UAAA,EAAY,cAAA,CAAe,IAAI;AAAA,EACjC,CAAA,CAAE,CAAA,CACD,MAAA,CAAO,CAAC,IAAA,EAAA,GAA0B,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAC,CAAA;AACzD;AAWA,SAAS,eAAA,CAAgB,IAAA,EAAoC;AAE3D,EAAA,MAAM,KAAA,EAAO,IAAA,CAAK,GAAA;AAClB,EAAA,GAAA,CAAI,CAAC,KAAA,GAAQ,OAAO,KAAA,IAAS,SAAA,GAAY,CAAA,CAAE,OAAA,GAAU,IAAA,CAAA,EAAO,OAAO,EAAA;AACnE,EAAA,OAAO,IAAA,CAAK,IAAA;AACd;AAMA,SAAS,cAAA,CAAe,IAAA,EAAqC;AAC3D,EAAA,MAAM,KAAA,EAAO,IAAA,CAAK,GAAA;AAClB,EAAA,GAAA,CAAI,CAAC,KAAA,GAAQ,OAAO,KAAA,IAAS,SAAA,GAAY,CAAA,CAAE,OAAA,GAAU,IAAA,CAAA,EAAO,OAAO,KAAA;AACnE,EAAA,OAAO,IAAA,CAAK,KAAA,IAAS,UAAA;AACvB;AD5HA;AACE;AACA;AACA;AACA;AACA;AACF,sPAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/navigation.js","sourcesContent":[null,"/**\n * Navigation helper utilities for SDK sites.\n *\n * Provides simple helpers to transform CMS navigation data into\n * render-ready NavItem arrays.\n *\n * @example\n * ```ts\n * import { getPrimaryNavItems, getNavItemsBySlug } from '@riverbankcms/sdk/navigation';\n *\n * // Get header navigation (primary menu)\n * const headerNav = getPrimaryNavItems(siteData.navigation);\n *\n * // Get footer navigation by slug\n * const footerNav = getNavItemsBySlug(siteData.navigation, 'footer');\n *\n * // Result: [{ href: '/', label: 'Home', isExternal: false }, ...]\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '@riverbankcms/api';\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// Primary API: Simple one-liner helpers\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 transformNavItems(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 transformNavItems(getNavigationBySlug(navigation, slug));\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Building blocks for advanced use cases\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 * console.log(menu?.slug);  // \"main\"\n * ```\n */\nexport function getPrimaryNavigation(\n  navigation: NavigationMenuWithItems[],\n): NavigationMenuWithItems | null {\n  if (!navigation || navigation.length === 0) return null;\n  return navigation.find((menu) => menu.isPrimary) ?? navigation[0];\n}\n\n/**\n * Get a navigation menu by name.\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  // Match by name (the database field) - function is named \"slug\" for API simplicity\n  return navigation.find((menu) => menu.name === slug) ?? null;\n}\n\n/**\n * Transform a menu into NavItem array.\n * - Sorts by orderIndex\n * - Resolves link hrefs\n * - Identifies external links\n * - Filters out items without valid hrefs\n *\n * @example\n * ```ts\n * const menu = getNavigationBySlug(siteData.navigation, 'main');\n * const items = transformNavItems(menu);\n * ```\n */\nexport function transformNavItems(menu: NavigationMenuWithItems | null): NavItem[] {\n  if (!menu?.items || menu.items.length === 0) return [];\n\n  const items: NavigationItemRecord[] = menu.items;\n\n  return items\n    .slice()\n    .sort((a: NavigationItemRecord, b: NavigationItemRecord) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0))\n    .map((item: NavigationItemRecord) => ({\n      label: item.label,\n      href: resolveItemHref(item),\n      isExternal: isExternalLink(item),\n    }))\n    .filter((item): item is NavItem => Boolean(item.href));\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Internal helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Extracts the href from a navigation item's url field.\n * The `url` field is a JSON column containing link data with { kind, href, ... } structure.\n * Gracefully returns empty string for malformed or missing link data.\n */\nfunction resolveItemHref(item: NavigationItemRecord): string {\n  // The database field is `url` (JSON) which gets camelized to `url`\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 * External links (kind: 'external') should typically open in a new tab.\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// Re-export types for convenience\nexport type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '@riverbankcms/api';\n"]}
+{"version":3,"sources":["/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/navigation.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,2sBAAC","file":"/Users/will/Projects/Business/cms/builder/packages/sdk/dist/server/navigation.js"}