@riverbankcms/sdk 0.138.0 → 0.139.0

package/dist/server/navigation.mjs

@@ -78,36 +78,26 @@ function isNavDropdown(item) {
 	return item.kind === "dropdown";
 }
 /**
-* Get the primary navigation menu object.
-* Returns menu marked as isPrimary, or first menu if none marked.
+* Get the fixed main navigation menu object.
+* Returns null when the runtime payload is incomplete.
 *
 * @example
 * ```ts
 * const menu = getPrimaryNavigation(siteData.navigation);
-* console.log(menu?.name); // "main"
+* console.log(menu?.location); // "main"
 * ```
 */
 function getPrimaryNavigation(navigation) {
 	if (!navigation || navigation.length === 0) return null;
-	const primaryMenus = navigation.filter((menu) => menu.isPrimary);
-	if (primaryMenus.length > 1) console.warn(`[riverbank/sdk] Multiple primary navigation menus detected (${primaryMenus.length}); using first flagged menu by input order.`);
-	const flaggedPrimary = primaryMenus[0];
-	if (flaggedPrimary) return flaggedPrimary;
-	if (navigation.length === 1) return navigation[0] ?? null;
-	return [...navigation].sort((a, b) => {
-		const createdAtCompare = (a.createdAt ?? "").localeCompare(b.createdAt ?? "");
-		if (createdAtCompare !== 0) return createdAtCompare;
-		return a.id.localeCompare(b.id);
-	})[0] ?? null;
+	return navigation.find((menu) => menu.location === "main") ?? null;
 }
 /**
-* Get the footer navigation menu object.
-* Returns menu marked as isFooter, or null if none marked.
+* Get the fixed footer navigation menu object.
 *
 * @example
 * ```ts
 * const menu = getFooterNavigation(siteData.navigation);
-* console.log(menu?.name); // "Footer menu"
+* console.log(menu?.location); // "footer"
 * ```
 */
 function getFooterNavigation(navigation) {
@@ -115,24 +105,20 @@ function getFooterNavigation(navigation) {
 }
 function getFooterNavigationByRole(navigation, role) {
 	if (!navigation || navigation.length === 0) return null;
-	const footerMenus = navigation.filter((menu) => menu.footerRole === role || role === "main" && menu.footerRole == null && menu.isFooter);
-	if (footerMenus.length > 1) console.warn(`[riverbank/sdk] Multiple footer navigation menus detected (${footerMenus.length}); using first flagged menu by input order.`);
-	return footerMenus[0] ?? null;
+	const canonicalLocation = role === "main" ? "footer" : "legal";
+	return navigation.find((menu) => menu.location === canonicalLocation) ?? null;
 }
 /**
-* Get a navigation menu by name/slug.
-*
-* @example
-* ```ts
-* const footerMenu = getNavigationBySlug(siteData.navigation, 'footer');
-* ```
+* Select one of the three fixed navigation destinations.
+* A canonical payload has exactly one menu for each location; returning null
+* keeps malformed or incomplete payloads visible to the caller rather than
+* borrowing a different location's links.
 */
-function getNavigationBySlug(navigation, slug) {
-	if (!navigation || navigation.length === 0) return null;
-	return navigation.find((menu) => menu.name === slug) ?? null;
+function getNavigationByLocation(navigation, location) {
+	return navigation?.find((menu) => menu.location === location) ?? null;
 }
 /**
-* Get nav items from the primary menu (marked isPrimary, or first menu).
+* Get nav items from the fixed main menu.
 * Returns nested structure supporting both links and dropdowns.
 * For canonical links (`kind: 'page' | 'entry'`), pass `routes` + identifier maps in options.
 *
@@ -154,23 +140,6 @@ function getPrimaryNavItems(navigation, options) {
 	return transformToNavItems(getPrimaryNavigation(navigation), options);
 }
 /**
-* Get nav items from a specific menu by slug.
-* Returns nested structure supporting both links and dropdowns.
-* For canonical links (`kind: 'page' | 'entry'`), pass `routes` + identifier maps in options.
-*
-* @example
-* ```ts
-* const footerNav = getNavItemsBySlug(siteData.navigation, 'footer', {
-*   routes: siteData.routes,
-*   pagesByIdentifier: siteData.pagesByIdentifier,
-*   entriesByIdentifier: siteData.entriesByIdentifier,
-* });
-* ```
-*/
-function getNavItemsBySlug(navigation, slug, options) {
-	return transformToNavItems(getNavigationBySlug(navigation, slug), options);
-}
-/**
 * Transform a menu into NavItem array.
 * Builds nested structure from flat items, supporting dropdowns with children.
 *
@@ -662,4 +631,4 @@ function buildLogo(logo, fallbackAlt) {
 	return result;
 }
 //#endregion
-export { buildFooterMenu, buildFooterMenuForRole, buildLogo, buildLogoViewModel, buildMenu, buildMenuViewModel, getFooterNavigation, getFooterNavigationByRole, getNavItemsBySlug, getNavigationBySlug, getPrimaryNavItems, getPrimaryNavigation, isNavDropdown, isNavLink, resolveNavigationLinkHref, transformToNavItems };
+export { buildFooterMenu, buildFooterMenuForRole, buildLogo, buildLogoViewModel, buildMenu, buildMenuViewModel, getFooterNavigation, getFooterNavigationByRole, getNavigationByLocation, getPrimaryNavItems, getPrimaryNavigation, isNavDropdown, isNavLink, resolveNavigationLinkHref, transformToNavItems };