@fern-api/fern-api-dev 3.50.0-7-g31382f58716 → 3.50.1-1-g33bdaf2e4df

package/cli.cjs

@@ -1430941,7 +1430941,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.50.0-7-g31382f58716",
+          version: "3.50.1-1-g33bdaf2e4df",
           usingAccessToken: true
         }
       });
@@ -1431040,7 +1431040,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.50.0-7-g31382f58716",
+        version: "3.50.1-1-g33bdaf2e4df",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -1510475,7 +1510475,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "3.50.0-7-g31382f58716";
+    return "3.50.1-1-g33bdaf2e4df";
   }
   getCliName() {
     if (false) {
@@ -1596900,7 +1596900,10 @@ function mergeAndFilterChildren({ left: left3, right: right3, findEndpointById,
     stringifyEndpointPathParts: stringifyEndpointPathParts3,
     disableEndpointPairs,
     apiDefinitionId
-  }).filter((child) => child.type === "apiPackage" ? child.children.length > 0 : true);
+  }).filter((child) => (
+    // Keep apiPackage if it has children OR if it has an overviewPageId (e.g., tag description page)
+    child.type === "apiPackage" ? child.children.length > 0 || child.overviewPageId != null : true
+  ));
 }
 
 // ../docs-resolver/lib/utils/toRelativeFilepath.js
@@ -1596995,12 +1596998,19 @@ var ApiReferenceNodeConverter = class {
   get() {
     const pointsTo = navigation_exports2.V1.followRedirects(this.#children);
     const changelogNodeConverter = new ChangelogNodeConverter(this.markdownFilesToFullSlugs, this.markdownFilesToNoIndex, this.markdownFilesToTags, this.workspace?.changelog?.files.map((file2) => file2.absoluteFilepath), this.docsWorkspace, this.#idgen).orUndefined();
+    let overviewPageId = this.#overviewPageId;
+    if (overviewPageId == null) {
+      const apiPackageWithOverview = this.#children.find((child) => child.type === "apiPackage" && child.overviewPageId != null);
+      if (apiPackageWithOverview != null) {
+        overviewPageId = apiPackageWithOverview.overviewPageId;
+      }
+    }
     return {
       id: this.#idgen.get(this.apiDefinitionId),
       type: "apiReference",
       title: this.apiSection.title,
       apiDefinitionId: this.apiDefinitionId,
-      overviewPageId: this.#overviewPageId,
+      overviewPageId,
       paginated: this.apiSection.paginated,
       slug: this.#slug.get(),
       icon: this.resolveIconFileId(this.apiSection.icon),
@@ -1597042,9 +1597052,10 @@ var ApiReferenceNodeConverter = class {
     const relativeFilePath = `tag-${subpackageName}.md`;
     const virtualAbsolutePath = AbsoluteFilePath2.of(`/${relativeFilePath}`);
     const pageId = navigation_exports2.V1.PageId(relativeFilePath);
+    const escapedDescription = tagInfo.description.replace(/\{/g, "\\{").replace(/\}/g, "\\}").replace(/</g, "&lt;").replace(/>/g, "&gt;");
     const markdownContent = `# ${titleCase4(tagInfo.id.replace(/[_-]/g, " "))}
 
-${tagInfo.description}`;
+${escapedDescription}`;
     this.#tagDescriptionContent.set(virtualAbsolutePath, markdownContent);
     this.markdownFilesToNoIndex.set(virtualAbsolutePath, false);
     this.markdownFilesToTags.set(virtualAbsolutePath, [subpackageName]);
@@ -1597482,7 +1597493,13 @@ ${tagInfo.description}`;
       }
       const slug = isSubpackage3(subpackage) ? parentSlug.apply(subpackage) : parentSlug;
       const subpackageChildren = this.#convertApiDefinitionPackageId(subpackageId, slug, parentAvailability);
-      if (subpackageChildren.length > 0) {
+      const tagDescriptionPageId = this.createTagDescriptionPageId(subpackage);
+      const subpackageHolder = this.#holder.subpackages.get(APIV1Read_exports.SubpackageId(subpackageId));
+      const hasVisitedEndpoints = subpackageHolder ? Array.from(subpackageHolder.endpoints.values()).some((endpoint3) => {
+        const endpointId = this.#holder.getEndpointId(endpoint3);
+        return endpointId != null && this.#visitedEndpoints.has(endpointId);
+      }) : false;
+      if (subpackageChildren.length > 0 || tagDescriptionPageId != null && hasVisitedEndpoints) {
         additionalChildren.push({
           id: navigation_exports2.V1.NodeId(`${this.apiDefinitionId}:${subpackageId}`),
           type: "apiPackage",
@@ -1597491,7 +1597508,7 @@ ${tagInfo.description}`;
           slug: slug.get(),
           icon: void 0,
           hidden: this.hideChildren,
-          overviewPageId: this.createTagDescriptionPageId(subpackage),
+          overviewPageId: tagDescriptionPageId,
           availability: parentAvailability,
           apiDefinitionId: this.apiDefinitionId,
           pointsTo: void 0,
@@ -1602621,7 +1602638,10 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
           loadAiExamples: true
         });
         if (openApiIr.tags.tagsById) {
-          openApiTags = Object.fromEntries(Object.entries(openApiIr.tags.tagsById).filter(([_15, tag]) => tag.description && tag.description.trim().length > 0).map(([tagId, tag]) => [tagId, { id: String(tag.id), description: tag.description }]));
+          openApiTags = Object.fromEntries(Object.entries(openApiIr.tags.tagsById).filter(([_15, tag]) => tag.description && tag.description.trim().length > 0).map(([tagId, tag]) => [
+            camelCase_default(tagId),
+            { id: String(tag.id), description: tag.description }
+          ]));
         }
       } catch (error49) {
         this.taskContext.logger.warn("Failed to extract OpenAPI tags for tag description pages", String(error49));
@@ -1602800,7 +1602820,7 @@ The generated documentation will replace this placeholder page with complete API
   }
   async toSectionNode({ prefix: prefix2, item, parentSlug, hideChildren, parentAvailability }) {
     const relativeFilePath = this.toRelativeFilepath(item.overviewAbsolutePath);
-    const pageId = relativeFilePath ? navigation_exports2.PageId(relativeFilePath) : void 0;
+    let pageId = relativeFilePath ? navigation_exports2.PageId(relativeFilePath) : void 0;
     const id2 = this.#idgen.get(pageId ?? `${prefix2}/section`);
     const slug = parentSlug.apply({
       urlSlug: item.slug ?? kebabCase_default(item.title),
@@ -1602809,6 +1602829,19 @@ The generated documentation will replace this placeholder page with complete API
     });
     const noindex = item.overviewAbsolutePath != null ? this.markdownFilesToNoIndex.get(item.overviewAbsolutePath) : void 0;
     const hiddenSection = hideChildren || item.hidden;
+    const children2 = await Promise.all(item.contents.map((child) => this.toNavigationChild({
+      prefix: id2,
+      item: child,
+      parentSlug: slug,
+      hideChildren: hiddenSection,
+      parentAvailability: item.availability ?? parentAvailability
+    })));
+    if (pageId == null) {
+      const flattenedApiRef = children2.find((child) => child.type === "apiReference" && child.hideTitle === true && child.overviewPageId != null);
+      if (flattenedApiRef != null) {
+        pageId = flattenedApiRef.overviewPageId;
+      }
+    }
     return {
       id: id2,
       type: "section",
@@ -1602820,13 +1602853,7 @@ The generated documentation will replace this placeholder page with complete API
       hidden: hiddenSection,
       viewers: item.viewers,
       orphaned: item.orphaned,
-      children: await Promise.all(item.contents.map((child) => this.toNavigationChild({
-        prefix: id2,
-        item: child,
-        parentSlug: slug,
-        hideChildren: hiddenSection,
-        parentAvailability: item.availability ?? parentAvailability
-      }))),
+      children: children2,
       authed: void 0,
       pointsTo: void 0,
       noindex,
@@ -1611546,7 +1611573,7 @@ var import_path40 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "3.50.0-7-g31382f58716";
+  const version7 = "3.50.1-1-g33bdaf2e4df";
   return `cli@${version7}`;
 }
 var DebugLogger = class {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.50.0-7-g31382f58716",
+  "version": "3.50.1-1-g33bdaf2e4df",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",