@fern-api/fdr-sdk 1.2.23-c9e3b5b30f → 1.2.23-f333a93cab

package/dist/js/navigation/ledger-root-builder.js

@@ -707,6 +707,25 @@ function toViewers(viewers) {
   }
   return viewers.map((v) => RoleId(v));
 }
+function mergeVariantViewers(seg) {
+  const segViewers = metaStrArr(seg.metadata, "viewers");
+  const variantViewers = seg.variant?.viewers;
+  if ((segViewers == null || segViewers.length === 0) && (variantViewers == null || variantViewers.length === 0)) {
+    return void 0;
+  }
+  const merged = /* @__PURE__ */ new Set();
+  if (segViewers != null) {
+    for (const v of segViewers) {
+      merged.add(v);
+    }
+  }
+  if (variantViewers != null) {
+    for (const v of variantViewers) {
+      merged.add(v);
+    }
+  }
+  return merged.size > 0 ? [...merged].map((v) => RoleId(v)) : void 0;
+}
 function detailSlug(detail) {
   return metaStr(detail.metadata, "slug") ?? "";
 }
@@ -904,7 +923,7 @@ function sectionNode(ctx, scoped, sectionChildren) {
     slug,
     icon: metaStr(seg.metadata, "icon"),
     hidden: seg.hidden,
-    viewers: toViewers(metaStrArr(seg.metadata, "viewers"))
+    viewers: mergeVariantViewers(seg)
   });
   return {
     type: "section",
@@ -919,23 +938,108 @@ function sectionNode(ctx, scoped, sectionChildren) {
     children: [...leafChildren, ...sectionChildren]
   };
 }
-function collectDescendantApiNav(root, scopeSegs) {
-  const rootSection = root.seg.section;
-  const prefix = rootSection === "" ? "" : `${rootSection}/`;
-  const routes = [...root.nav];
-  for (const s of scopeSegs) {
-    if (s === root) {
+function directChildApiPackages(parentSection, scopeSegs) {
+  const sectionPaths = new Set(scopeSegs.map((s) => s.seg.section));
+  return scopeSegs.filter((s) => {
+    if (metaStr(s.seg.metadata, "type") !== "apiPackage") {
+      return false;
+    }
+    const parent = parentSectionPath(s.seg.section);
+    if (parent === parentSection) {
+      return true;
+    }
+    if (!sectionPaths.has(parent)) {
+      return nearestExistingAncestor(s.seg.section, sectionPaths) === parentSection;
+    }
+    return false;
+  }).sort((a, b) => a.seg.sortOrder - b.seg.sortOrder);
+}
+function buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId) {
+  const { seg, nav } = scoped;
+  const rawLeafNodes = nav.map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, apiDefinitionId)).filter((node) => node != null);
+  const leafNodes = mergeEndpointPairs(ctx, rawLeafNodes, nav);
+  const childPackages = directChildApiPackages(seg.section, scopeSegs);
+  const packageNodes = childPackages.map(
+    (child) => apiPackageChildNode(ctx, child, scopeSegs, apiDefinitionId)
+  );
+  return [...leafNodes, ...packageNodes];
+}
+function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId) {
+  const { seg, nav } = scoped;
+  const overview = overviewRoute(nav);
+  const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : void 0;
+  const apiDefinitionId = metaStr(seg.metadata, "apiDefinitionId") ?? parentApiDefinitionId;
+  const slug = ctx.contentSlug(overview?.fullPath ?? nav[0]?.fullPath ?? seg.section);
+  const children = buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId);
+  return {
+    type: "apiPackage",
+    ...withMetadataDefaults({
+      id: ctx.nodeId(`api-pkg:${slug}`),
+      title: metaStr(seg.metadata, "title") ?? "",
+      slug,
+      icon: metaStr(seg.metadata, "icon"),
+      hidden: seg.hidden,
+      viewers: toViewers(metaStrArr(seg.metadata, "viewers"))
+    }),
+    apiDefinitionId: ApiDefinitionId(apiDefinitionId),
+    availability: metaStr(seg.metadata, "availability"),
+    overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
+    noindex: void 0,
+    pointsTo: void 0,
+    children,
+    playground: void 0
+  };
+}
+function mergeEndpointPairs(ctx, leafNodes, allNav) {
+  const endpointIdToPairKey = /* @__PURE__ */ new Map();
+  for (const route of allNav) {
+    if (route.type !== "rest") {
       continue;
     }
-    const type = metaStr(s.seg.metadata, "type");
-    if (type !== "apiPackage") {
+    const pairKey = metaStr(route.metadata, "endpointPairKey");
+    const endpointId = metaStr(route.metadata, "endpointId");
+    if (pairKey != null && endpointId != null) {
+      endpointIdToPairKey.set(endpointId, pairKey);
+    }
+  }
+  if (endpointIdToPairKey.size === 0) {
+    return leafNodes;
+  }
+  const result = [];
+  const mergedPairKeys = /* @__PURE__ */ new Map();
+  for (const node of leafNodes) {
+    if (node.type !== "endpoint") {
+      result.push(node);
+      continue;
+    }
+    const pairKey = endpointIdToPairKey.get(String(node.endpointId));
+    if (pairKey == null) {
+      result.push(node);
       continue;
     }
-    if (s.seg.section === rootSection || s.seg.section.startsWith(prefix)) {
-      routes.push(...s.nav);
+    const existingIdx = mergedPairKeys.get(pairKey);
+    if (existingIdx == null) {
+      mergedPairKeys.set(pairKey, result.length);
+      result.push(node);
+    } else {
+      const first = result[existingIdx];
+      if (first == null || first.type !== "endpoint") {
+        result.push(node);
+        continue;
+      }
+      const stream = node.isResponseStream ? node : first;
+      const nonStream = node.isResponseStream ? first : node;
+      const pairNode = {
+        id: ctx.nodeId(`endpoint-pair:${pairKey}`),
+        type: "endpointPair",
+        collapsed: void 0,
+        stream,
+        nonStream
+      };
+      result[existingIdx] = pairNode;
     }
   }
-  return routes;
+  return result;
 }
 function apiReferenceNode(ctx, scoped, scopeSegs) {
   const { seg, nav } = scoped;
@@ -943,8 +1047,7 @@ function apiReferenceNode(ctx, scoped, scopeSegs) {
   const overviewPageId = overview != null ? metaStr(overview.metadata, "pageId") : void 0;
   const apiDefinitionId = metaStr(seg.metadata, "apiDefinitionId") ?? "";
   const slug = ctx.contentSlug(overview?.fullPath ?? nav[0]?.fullPath ?? seg.section);
-  const allNav = collectDescendantApiNav(scoped, scopeSegs);
-  const children = allNav.map((route) => apiLeafNodeFromNavRouteInternal(ctx, route, apiDefinitionId)).filter((node) => node != null);
+  const children = buildApiChildren(ctx, scoped, scopeSegs, apiDefinitionId);
   return {
     type: "apiReference",
     ...withMetadataDefaults({
@@ -953,7 +1056,7 @@ function apiReferenceNode(ctx, scoped, scopeSegs) {
       slug,
       icon: metaStr(seg.metadata, "icon"),
       hidden: seg.hidden,
-      viewers: toViewers(metaStrArr(seg.metadata, "viewers"))
+      viewers: mergeVariantViewers(seg)
     }),
     apiDefinitionId: ApiDefinitionId(apiDefinitionId),
     availability: void 0,
@@ -1036,7 +1139,7 @@ function changelogNode(ctx, scoped) {
       slug: baseSlug,
       icon: metaStr(seg.metadata, "icon"),
       hidden: seg.hidden,
-      viewers: toViewers(metaStrArr(seg.metadata, "viewers"))
+      viewers: mergeVariantViewers(seg)
     }),
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: void 0,