@fern-api/fdr-sdk 1.2.42-6d01f91096 → 1.2.42-b174eece86

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

@@ -92,6 +92,17 @@ var VersionIdSchema = z.string();
 function VersionId(value) {
   return value;
 }
+var Availability = {
+  Alpha: "Alpha",
+  Stable: "Stable",
+  GenerallyAvailable: "GenerallyAvailable",
+  InDevelopment: "InDevelopment",
+  PreRelease: "PreRelease",
+  Deprecated: "Deprecated",
+  Beta: "Beta",
+  Preview: "Preview",
+  Legacy: "Legacy"
+};
 var SnippetsByEndpointMethodSchema = z.record(
   HttpMethodSchema,
   z.array(z.unknown())
@@ -845,6 +856,12 @@ function traverseDF(node, visit) {
   return dfs(node, visit, getChildren);
 }
 
+// src/navigation/utils/syntheticSectionPath.ts
+var SYNTHETIC_SEGMENT_RE = /^~\d+$/;
+function stripSyntheticSegments(section) {
+  return section.split("/").filter((part) => !SYNTHETIC_SEGMENT_RE.test(part)).join("/");
+}
+
 // src/navigation/ledger-root-builder.ts
 var STRUCTURAL_SEGMENT_TYPES = /* @__PURE__ */ new Set([
   "section",
@@ -882,6 +899,35 @@ function metaStr(metadata, key) {
   }
   return void 0;
 }
+var AVAILABILITY_LOOKUP = {
+  // V1 lowercase values (stored by docsPublishTransform from V1 navigation tree)
+  alpha: Availability.Alpha,
+  stable: Availability.Stable,
+  "generally-available": Availability.GenerallyAvailable,
+  "in-development": Availability.InDevelopment,
+  "pre-release": Availability.PreRelease,
+  deprecated: Availability.Deprecated,
+  beta: Availability.Beta,
+  preview: Availability.Preview,
+  legacy: Availability.Legacy,
+  // Latest PascalCase values (pass-through)
+  Alpha: Availability.Alpha,
+  Stable: Availability.Stable,
+  GenerallyAvailable: Availability.GenerallyAvailable,
+  InDevelopment: Availability.InDevelopment,
+  PreRelease: Availability.PreRelease,
+  Deprecated: Availability.Deprecated,
+  Beta: Availability.Beta,
+  Preview: Availability.Preview,
+  Legacy: Availability.Legacy
+};
+function metaAvailability(metadata) {
+  const raw = metaStr(metadata, "availability");
+  if (raw == null) {
+    return void 0;
+  }
+  return AVAILABILITY_LOOKUP[raw];
+}
 function metaBool(metadata, key) {
   if (metadata != null && typeof metadata === "object" && key in metadata) {
     const v = metadata[key];
@@ -999,7 +1045,7 @@ function artifactToNode(ctx, route) {
         }),
         pageId: PageId(pageId),
         noindex: metaBool(md, "noindex"),
-        availability: metaStr(md, "availability")
+        availability: metaAvailability(md)
       };
       return node;
     }
@@ -1064,7 +1110,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       endpointId: EndpointId(endpointId),
       apiDefinitionId,
       isResponseStream: metaBool(md, "isResponseStream"),
-      availability: metaStr(md, "availability"),
+      availability: metaAvailability(md),
       playground: void 0
     };
   }
@@ -1080,7 +1126,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       method,
       webhookId: WebhookId(webhookId),
       apiDefinitionId,
-      availability: metaStr(md, "availability")
+      availability: metaAvailability(md)
     };
   }
   if (route.type === "asyncapi") {
@@ -1093,7 +1139,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       ...meta,
       webSocketId: WebSocketId(webSocketId),
       apiDefinitionId,
-      availability: metaStr(md, "availability"),
+      availability: metaAvailability(md),
       playground: void 0
     };
   }
@@ -1109,7 +1155,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       method,
       grpcId: GrpcId(grpcId),
       apiDefinitionId,
-      availability: metaStr(md, "availability")
+      availability: metaAvailability(md)
     };
   }
   if (route.type === "graphql") {
@@ -1125,7 +1171,7 @@ function apiLeafNodeFromNavRouteInternal(ctx, route, segmentApiDefinitionId2) {
       graphqlOperationId: GraphQlOperationId(graphqlOperationId),
       graphqlOperationIds: void 0,
       apiDefinitionId,
-      availability: metaStr(md, "availability"),
+      availability: metaAvailability(md),
       playground: void 0
     };
   }
@@ -1238,7 +1284,8 @@ function structuralNodeSlug(ctx, overviewFullPath, section, scopePrefix) {
   if (overviewFullPath != null) {
     return ctx.contentSlug(overviewFullPath);
   }
-  return section !== "" ? slugjoin(scopePrefix, section) : scopePrefix;
+  const cleanSection = stripSyntheticSegments(section);
+  return cleanSection !== "" ? slugjoin(scopePrefix, cleanSection) : scopePrefix;
 }
 function stripLeadingScopePrefix(section, scopePrefix) {
   const prefix = scopePrefix;
@@ -1302,7 +1349,7 @@ function sectionNode(ctx, scoped, sectionChildren, scopePrefix) {
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
     collapsible: metaBool(seg.metadata, "collapsible") ?? (metaCollapsed(seg.metadata) === true ? true : void 0),
     collapsedByDefault: metaBool(seg.metadata, "collapsedByDefault") ?? (metaCollapsed(seg.metadata) === true ? true : void 0),
-    availability: metaStr(seg.metadata, "availability"),
+    availability: metaAvailability(seg.metadata),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
     children: mergeChildrenByPosition(ctx, nav, sectionChildren)
   };
@@ -1376,7 +1423,7 @@ function apiPackageChildNode(ctx, scoped, scopeSegs, parentApiDefinitionId, scop
       featureFlags: metaFeatureFlags(seg.metadata)
     }),
     apiDefinitionId: ApiDefinitionId(apiDefinitionId),
-    availability: metaStr(seg.metadata, "availability"),
+    availability: metaAvailability(seg.metadata),
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
     pointsTo: metaPointsTo != null ? pointsToSlug(metaPointsTo) : void 0,
@@ -1464,7 +1511,7 @@ function apiReferenceNode(ctx, scoped, scopeSegs, scopePrefix) {
       featureFlags: metaFeatureFlags(seg.metadata)
     }),
     apiDefinitionId: ApiDefinitionId(apiDefinitionId),
-    availability: metaStr(seg.metadata, "availability"),
+    availability: metaAvailability(seg.metadata),
     overviewPageId: overviewPageId != null ? PageId(overviewPageId) : void 0,
     noindex: metaBool(overview?.metadata, "noindex") ?? metaBool(seg.metadata, "noindex"),
     paginated: true,
@@ -1500,6 +1547,44 @@ function hasOwningApiReference(scoped, scopeSegs) {
     return metaStr(candidate.seg.metadata, "apiDefinitionId") === apiDefinitionId;
   });
 }
+function isNestedApiPackage(scoped, scopeSegs) {
+  if (metaStr(scoped.seg.metadata, "type") !== "apiPackage") {
+    return false;
+  }
+  const apiDefinitionId = metaStr(scoped.seg.metadata, "apiDefinitionId");
+  if (apiDefinitionId == null) {
+    return false;
+  }
+  const apiReferenceSections = new Set(
+    scopeSegs.filter(
+      (s) => metaStr(s.seg.metadata, "type") === "apiReference" && metaStr(s.seg.metadata, "apiDefinitionId") === apiDefinitionId
+    ).map((s) => s.seg.section)
+  );
+  if (apiReferenceSections.size === 0) {
+    return false;
+  }
+  const sectionPaths = new Set(scopeSegs.map((s) => s.seg.section));
+  const resolveParent = (section) => {
+    const parent = parentSectionPath(section);
+    if (parent === "" || sectionPaths.has(parent)) {
+      return parent;
+    }
+    return nearestExistingAncestor(section, sectionPaths);
+  };
+  let current = scoped.seg.section;
+  const seen = /* @__PURE__ */ new Set([current]);
+  for (; ; ) {
+    const parent = resolveParent(current);
+    if (apiReferenceSections.has(parent)) {
+      return true;
+    }
+    if (parent === "" || seen.has(parent)) {
+      return false;
+    }
+    seen.add(parent);
+    current = parent;
+  }
+}
 function changelogNode(ctx, scoped, scopePrefix) {
   const { seg, nav } = scoped;
   const overview = overviewRoute(nav);
@@ -1603,7 +1688,7 @@ function buildSectionTree(ctx, scopeSegs, parentPath, scopePrefix, changelogScop
     if (sec === "" || type === "tabRoot") {
       return false;
     }
-    if (hasOwningApiReference(s, scopeSegs)) {
+    if (hasOwningApiReference(s, scopeSegs) || isNestedApiPackage(s, scopeSegs)) {
       return false;
     }
     const parent = parentSectionPath(sec);
@@ -1677,7 +1762,7 @@ function buildSidebarRootChildren(ctx, scopeSegs, scopePrefix, changelogScopePre
   for (const s of ordered) {
     const type = metaStr(s.seg.metadata, "type");
     const sec = s.seg.section;
-    if (hasOwningApiReference(s, scopeSegs)) {
+    if (hasOwningApiReference(s, scopeSegs) || isNestedApiPackage(s, scopeSegs)) {
       continue;
     }
     if (type === "tabRoot" && metaBool(s.seg.metadata, "landingPage") === true) {