@fern-api/fern-api-dev 3.50.1 → 3.50.2-3-gbe65382b57d

package/cli.cjs

@@ -1430941,7 +1430941,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.50.1",
+          version: "3.50.2-3-gbe65382b57d",
           usingAccessToken: true
         }
       });
@@ -1431040,7 +1431040,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.50.1",
+        version: "3.50.2-3-gbe65382b57d",
         ...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.1";
+    return "3.50.2-3-gbe65382b57d";
   }
   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.1";
+  const version7 = "3.50.2-3-gbe65382b57d";
   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({
@@ -1646915,7 +1646926,7 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
     return context2.failAndThrow("Failed to publish docs.", "Docs registration ID is missing.");
   }
   let libraryDocsConfig;
-  const pythonDocsSection = extractPythonDocsSectionFromConfig(docsWorkspace.config);
+  const pythonDocsSection = await extractPythonDocsSectionFromConfig(docsWorkspace.config, docsWorkspace.absoluteFilePath);
   if (pythonDocsSection != null) {
     const githubUrl = pythonDocsSection.pythonDocs;
     context2.logger.info(`Generating Python documentation from ${githubUrl}...`);
@@ -1647458,13 +1647469,30 @@ function extractErrorDetails(error49) {
     rawError: error49
   };
 }
-function extractPythonDocsSectionFromConfig(config3) {
-  const navigation = config3.navigation;
-  if (navigation == null) {
-    return void 0;
-  }
+async function extractPythonDocsSectionFromConfig(config3, absolutePathToFernFolder) {
   const isPythonDocsConfig = (item) => {
-    return item != null && typeof item === "object" && "pythonDocs" in item && typeof item.pythonDocs === "string";
+    if (item == null || typeof item !== "object") {
+      return false;
+    }
+    const obj = item;
+    return typeof obj.pythonDocs === "string" || typeof obj["python-docs"] === "string";
+  };
+  const normalizePythonDocsConfig = (item) => {
+    if (item == null || typeof item !== "object") {
+      return void 0;
+    }
+    const obj = item;
+    if (typeof obj.pythonDocs === "string") {
+      return item;
+    }
+    if (typeof obj["python-docs"] === "string") {
+      return {
+        pythonDocs: obj["python-docs"],
+        title: typeof obj.title === "string" ? obj.title : void 0,
+        slug: typeof obj.slug === "string" ? obj.slug : void 0
+      };
+    }
+    return void 0;
   };
   const findPythonDocsSectionInItems = (items) => {
     if (items == null) {
@@ -1647472,7 +1647500,7 @@ function extractPythonDocsSectionFromConfig(config3) {
     }
     for (const item of items) {
       if (isPythonDocsConfig(item)) {
-        return item;
+        return normalizePythonDocsConfig(item);
       }
       if (item != null && typeof item === "object" && "section" in item) {
         const sectionItem = item;
@@ -1647495,37 +1647523,88 @@ function extractPythonDocsSectionFromConfig(config3) {
     }
     return void 0;
   };
-  const nav = navigation;
-  if (Array.isArray(nav)) {
-    return findPythonDocsSectionInItems(nav);
-  }
-  if (nav != null && typeof nav === "object") {
-    const navObj = nav;
-    if (Array.isArray(navObj.tabs)) {
-      for (const tab2 of navObj.tabs) {
-        if (tab2 != null && typeof tab2 === "object") {
-          const tabObj = tab2;
-          if (Array.isArray(tabObj.layout)) {
-            const found = findPythonDocsSectionInItems(tabObj.layout);
-            if (found) {
-              return found;
+  const findInNavigationConfig = (navigation) => {
+    if (navigation == null) {
+      return void 0;
+    }
+    if (Array.isArray(navigation)) {
+      return findPythonDocsSectionInItems(navigation);
+    }
+    if (navigation != null && typeof navigation === "object") {
+      const navObj = navigation;
+      if (Array.isArray(navObj.tabs)) {
+        for (const tab2 of navObj.tabs) {
+          if (tab2 != null && typeof tab2 === "object") {
+            const tabObj = tab2;
+            if (Array.isArray(tabObj.layout)) {
+              const found = findPythonDocsSectionInItems(tabObj.layout);
+              if (found) {
+                return found;
+              }
             }
           }
         }
       }
     }
-    if (Array.isArray(navObj.versions)) {
-      for (const version7 of navObj.versions) {
-        if (version7 != null && typeof version7 === "object") {
-          const versionObj = version7;
-          if (Array.isArray(versionObj.navigation)) {
-            const found = findPythonDocsSectionInItems(versionObj.navigation);
-            if (found) {
-              return found;
-            }
+    return void 0;
+  };
+  const searchVersionFile = async (versionPath) => {
+    try {
+      const absoluteFilepathToVersionFile = resolve5(absolutePathToFernFolder, RelativeFilePath2.of(versionPath));
+      const content5 = jsYaml.load((await (0, import_promises99.readFile)(absoluteFilepathToVersionFile)).toString());
+      if (content5 != null && typeof content5 === "object") {
+        const versionContent = content5;
+        return findInNavigationConfig(versionContent.navigation);
+      }
+    } catch {
+    }
+    return void 0;
+  };
+  const searchProductFile = async (productPath, productVersions) => {
+    try {
+      const absoluteFilepathToProductFile = resolve5(absolutePathToFernFolder, RelativeFilePath2.of(productPath));
+      const content5 = jsYaml.load((await (0, import_promises99.readFile)(absoluteFilepathToProductFile)).toString());
+      if (content5 != null && typeof content5 === "object") {
+        const productContent = content5;
+        const found = findInNavigationConfig(productContent.navigation);
+        if (found) {
+          return found;
+        }
+      }
+      if (productVersions != null && productVersions.length > 0) {
+        for (const version7 of productVersions) {
+          const found = await searchVersionFile(version7.path);
+          if (found) {
+            return found;
           }
         }
       }
+    } catch {
+    }
+    return void 0;
+  };
+  if (config3.navigation != null) {
+    const found = findInNavigationConfig(config3.navigation);
+    if (found) {
+      return found;
+    }
+  }
+  if (config3.versions != null && config3.versions.length > 0) {
+    for (const version7 of config3.versions) {
+      const found = await searchVersionFile(version7.path);
+      if (found) {
+        return found;
+      }
+    }
+  }
+  if (config3.products != null && config3.products.length > 0) {
+    for (const product of config3.products) {
+      if ("path" in product && product.path != null) {
+        const found = await searchProductFile(product.path, product.versions);
+        if (found) {
+          return found;
+        }
+      }
     }
   }
   return void 0;

package/package.json

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