@fern-api/fern-api-dev 3.50.2 → 3.50.3

package/cli.cjs

@@ -1430941,7 +1430941,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.50.2",
+          version: "3.50.3",
           usingAccessToken: true
         }
       });
@@ -1431040,7 +1431040,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.50.2",
+        version: "3.50.3",
         ...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.2";
+    return "3.50.3";
   }
   getCliName() {
     if (false) {
@@ -1601813,7 +1601813,8 @@ var DocsDefinitionResolver = class {
   uploadFiles;
   registerApi;
   targetAudiences;
-  constructor({ domain: domain3, docsWorkspace, ossWorkspaces, apiWorkspaces, taskContext, editThisPage, uploadFiles: uploadFiles2 = defaultUploadFiles, registerApi: registerApi2 = defaultRegisterApi, targetAudiences }) {
+  pythonDocsSectionHandler;
+  constructor({ domain: domain3, docsWorkspace, ossWorkspaces, apiWorkspaces, taskContext, editThisPage, uploadFiles: uploadFiles2 = defaultUploadFiles, registerApi: registerApi2 = defaultRegisterApi, targetAudiences, pythonDocsSectionHandler }) {
     this.domain = domain3;
     this.docsWorkspace = docsWorkspace;
     this.ossWorkspaces = ossWorkspaces;
@@ -1601823,6 +1601824,7 @@ var DocsDefinitionResolver = class {
     this.uploadFiles = uploadFiles2;
     this.registerApi = registerApi2;
     this.targetAudiences = targetAudiences;
+    this.pythonDocsSectionHandler = pythonDocsSectionHandler;
   }
   #idgen = NodeIdGenerator2.init();
   /**
@@ -1602512,7 +1602514,8 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
   }
   async toSidebarRootNode(prefix2, items, parentSlug) {
     const id2 = this.#idgen.get(`${prefix2}/root`);
-    const children2 = await Promise.all(items.map((item) => this.toNavigationChild({ prefix: id2, item, parentSlug })));
+    const childrenWithNulls = await Promise.all(items.map((item) => this.toNavigationChild({ prefix: id2, item, parentSlug })));
+    const children2 = childrenWithNulls.filter((child) => child != null);
     const grouped = [];
     children2.forEach((child) => {
       if (child.type === "apiReference") {
@@ -1602563,7 +1602566,8 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       urlSlug: item.slug ?? kebabCase_default(item.title),
       skipUrlSlug: item.skipUrlSlug
     });
-    const children2 = await Promise.all(item.layout.map((item2) => this.toVariantChild(item2, id2, variantSlug)));
+    const childrenWithNulls = await Promise.all(item.layout.map((item2) => this.toVariantChild(item2, id2, variantSlug)));
+    const children2 = childrenWithNulls.filter((child) => child != null);
     return {
       type: "variant",
       id: id2,
@@ -1602590,8 +1602594,9 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       section: async (value) => this.toSectionNode({ prefix: prefix2, item: value, parentSlug }),
       link: async (value) => this.toLinkNode(value),
       changelog: async (value) => this.toChangelogNode(value, parentSlug),
-      // Library sections are handled by FDR during registration, returning placeholder
-      pythonDocsSection: async (value) => this.toPythonDocsSectionPlaceholder(value, parentSlug)
+      // Library sections are handled by FDR during registration
+      // If handler provided (dev mode), create placeholder; otherwise skip (FDR adds generated docs)
+      pythonDocsSection: async (value) => this.handlePythonDocsSection(value, parentSlug)
     });
   }
   async toNavigationChild({ prefix: prefix2, item, parentSlug, hideChildren, parentAvailability }) {
@@ -1602601,8 +1602606,9 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       section: async (value) => this.toSectionNode({ prefix: prefix2, item: value, parentSlug, hideChildren, parentAvailability }),
       link: async (value) => this.toLinkNode(value),
       changelog: async (value) => this.toChangelogNode(value, parentSlug, hideChildren),
-      // Library sections are handled by FDR during registration, returning placeholder
-      pythonDocsSection: async (value) => this.toPythonDocsSectionPlaceholder(value, parentSlug)
+      // Library sections are handled by FDR during registration
+      // If handler provided (dev mode), create placeholder; otherwise skip (FDR adds generated docs)
+      pythonDocsSection: async (value) => this.handlePythonDocsSection(value, parentSlug)
     });
   }
   async toApiSectionNode({ item, parentSlug, hideChildren, parentAvailability }) {
@@ -1602723,77 +1602729,19 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
     };
   }
   /**
-   * Python docs sections are handled by FDR during finishDocsRegister.
-   * The CLI starts the generation job, polls for completion, and passes the jobId to FDR.
-   * FDR then merges the generated Python docs into the navigation.
-   *
-   * In dev mode (fern docs dev), this placeholder returns a visible page with helpful content
-   * explaining that Python library docs are only generated during `fern generate --docs`.
-   *
-   * In production mode, FDR replaces/augments this with the actual generated documentation.
+   * Handles pythonDocsSection navigation items by delegating to the handler if provided.
+   * If no handler is provided, returns null (skips the section - FDR adds generated docs during publish).
    */
-  toPythonDocsSectionPlaceholder(item, parentSlug) {
-    const title5 = item.title ?? "Python Reference";
-    const urlSlug = item.slug ?? "python-docs";
-    const slug = parentSlug.apply({ urlSlug });
-    const syntheticPageId = `__python-docs-placeholder-${urlSlug}__.mdx`;
-    const pageId = navigation_exports2.PageId(syntheticPageId);
-    const placeholderMarkdown = `---
-title: ${title5}
----
-
-<Warning>
-Python library documentation is not yet supported with \`fern docs dev\`. This feature will be added in a future release. To view the generated documentation, run \`fern generate --docs --preview\`.
-</Warning>
-
-## About Python Library Docs
-
-When you publish your documentation using \`fern generate --docs\`, Fern will:
-
-1. Clone and analyze your Python repository from: \`${item.githubUrl}\`
-2. Parse the Python source code to extract docstrings and type information
-3. Generate comprehensive API reference documentation
-4. Integrate the generated docs into your documentation site
-
-## How to Generate
-
-To generate the full Python library documentation, run:
-
-\`\`\`bash
-fern generate --docs
-\`\`\`
-
-Or to preview without publishing:
-
-\`\`\`bash
-fern generate --docs --preview
-\`\`\`
-
-The generated documentation will replace this placeholder page with complete API reference content including:
-
-- Module and package documentation
-- Class and function references
-- Type annotations and signatures
-- Docstring content
-`;
-    this.parsedDocsConfig.pages[RelativeFilePath2.of(syntheticPageId)] = placeholderMarkdown;
-    const id2 = this.#idgen.get(pageId);
-    return {
-      id: id2,
-      type: "page",
-      slug: slug.get(),
-      title: title5,
-      icon: void 0,
-      hidden: false,
-      viewers: void 0,
-      orphaned: void 0,
-      pageId,
-      authed: void 0,
-      noindex: true,
-      // Don't index placeholder pages
-      featureFlags: void 0,
-      availability: void 0
-    };
+  handlePythonDocsSection(item, parentSlug) {
+    if (this.pythonDocsSectionHandler == null) {
+      return null;
+    }
+    return this.pythonDocsSectionHandler(item, parentSlug, {
+      addPage: (pageId, markdown) => {
+        this.parsedDocsConfig.pages[RelativeFilePath2.of(pageId)] = markdown;
+      },
+      generateId: (key) => this.#idgen.get(key)
+    });
   }
   async toPageNode({ item, parentSlug, hideChildren, parentAvailability }) {
     const pageId = navigation_exports2.PageId(this.toRelativeFilepath(item.absolutePath));
@@ -1602836,8 +1602784,9 @@ The generated documentation will replace this placeholder page with complete API
       hideChildren: hiddenSection,
       parentAvailability: item.availability ?? parentAvailability
     })));
+    const filteredChildren = children2.filter((child) => child != null);
     if (pageId == null) {
-      const flattenedApiRef = children2.find((child) => child.type === "apiReference" && child.hideTitle === true && child.overviewPageId != null);
+      const flattenedApiRef = filteredChildren.find((child) => child.type === "apiReference" && child.hideTitle === true && child.overviewPageId != null);
       if (flattenedApiRef != null) {
         pageId = flattenedApiRef.overviewPageId;
       }
@@ -1602853,7 +1602802,7 @@ The generated documentation will replace this placeholder page with complete API
       hidden: hiddenSection,
       viewers: item.viewers,
       orphaned: item.orphaned,
-      children: children2,
+      children: filteredChildren,
       authed: void 0,
       pointsTo: void 0,
       noindex,
@@ -1603129,6 +1603078,67 @@ function convertAvailability5(availability) {
       assertNever(availability);
   }
 }
+function createPythonDocsSectionPlaceholder(item, parentSlug, context2) {
+  const title5 = item.title ?? "Python Reference";
+  const urlSlug = item.slug ?? "python-docs";
+  const slug = parentSlug.apply({ urlSlug });
+  const syntheticPageId = `__python-docs-placeholder-${urlSlug}__.mdx`;
+  const pageId = navigation_exports2.PageId(syntheticPageId);
+  const placeholderMarkdown = `---
+title: ${title5}
+---
+
+<Warning>
+Python library documentation is not yet supported with \`fern docs dev\`. This feature will be added in a future release. To view the generated documentation, run \`fern generate --docs --preview\`.
+</Warning>
+
+## About Python Library Docs
+
+When you publish your documentation using \`fern generate --docs\`, Fern will:
+
+1. Clone and analyze your Python repository from: \`${item.githubUrl}\`
+2. Parse the Python source code to extract docstrings and type information
+3. Generate comprehensive API reference documentation
+4. Integrate the generated docs into your documentation site
+
+## How to Generate
+
+To generate the full Python library documentation, run:
+
+\`\`\`bash
+fern generate --docs
+\`\`\`
+
+Or to preview without publishing:
+
+\`\`\`bash
+fern generate --docs --preview
+\`\`\`
+
+The generated documentation will replace this placeholder page with complete API reference content including:
+
+- Module and package documentation
+- Class and function references
+- Type annotations and signatures
+- Docstring content
+`;
+  context2.addPage(syntheticPageId, placeholderMarkdown);
+  return {
+    id: context2.generateId(pageId),
+    type: "page",
+    slug: slug.get(),
+    title: title5,
+    icon: void 0,
+    hidden: false,
+    viewers: void 0,
+    orphaned: void 0,
+    pageId,
+    authed: void 0,
+    noindex: true,
+    featureFlags: void 0,
+    availability: void 0
+  };
+}
 
 // ../docs-resolver/lib/utils/filterOssWorkspaces.js
 async function filterOssWorkspaces(project) {
@@ -1611573,7 +1611583,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.2";
+  const version7 = "3.50.3";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -1613390,7 +1613400,8 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
       };
     }),
     registerApi: async (opts) => apiCollector.addReferencedAPI(opts),
-    targetAudiences: void 0
+    targetAudiences: void 0,
+    pythonDocsSectionHandler: createPythonDocsSectionPlaceholder
   });
   const writeDocsDefinition = await resolver2.resolve();
   const dbDocsDefinition = convertDocsDefinitionToDb({

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.50.2",
+  "version": "3.50.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",