@fern-api/fern-api-dev 3.50.2 → 3.51.0-1-g79714d0ea3a

package/cli.cjs

@@ -1430941,7 +1430941,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "3.50.2",
+          version: "3.51.0-1-g79714d0ea3a",
           usingAccessToken: true
         }
       });
@@ -1431040,7 +1431040,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "3.50.2",
+        version: "3.51.0-1-g79714d0ea3a",
         ...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.51.0-1-g79714d0ea3a";
   }
   getCliName() {
     if (false) {
@@ -1534814,6 +1534814,113 @@ function getFernPaginationExtension(document4, operation) {
   return convertPaginationExtension(pagination);
 }
 
+// ../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/converters/endpoint/getApplicationJsonSchema.js
+function getTextEventStreamObject(media2, context2) {
+  for (const contentType of Object.keys(media2)) {
+    if (contentType.includes("text/event-stream")) {
+      const mediaObject = media2[contentType];
+      if (mediaObject == null) {
+        continue;
+      }
+      const mediaObjectWithItemSchema = mediaObject;
+      const schema2 = mediaObject.schema ?? mediaObjectWithItemSchema.itemSchema;
+      return {
+        contentType,
+        schema: schema2 ?? {},
+        examples: getExamples2(mediaObject, context2)
+      };
+    }
+  }
+  return void 0;
+}
+function hasTextEventStreamWithItemSchema(media2) {
+  for (const contentType of Object.keys(media2)) {
+    if (contentType.includes("text/event-stream")) {
+      const mediaObject = media2[contentType];
+      if (mediaObject == null) {
+        continue;
+      }
+      const mediaObjectWithItemSchema = mediaObject;
+      if (mediaObjectWithItemSchema.itemSchema != null) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function isApplicationJsonMediaType(mediaType) {
+  return mediaType.includes("json") || mediaType === "*/*";
+}
+function findApplicationJsonRequest({ content: content5, context: context2 }) {
+  for (const [mediaType, mediaTypeObject] of Object.entries(content5)) {
+    const result = getApplicationJsonSchemaMediaObject({
+      mediaType,
+      mediaTypeObject,
+      context: context2
+    });
+    if (result != null) {
+      return [mediaType, mediaTypeObject];
+    }
+  }
+  return void 0;
+}
+function getApplicationJsonSchemaMediaObject({ mediaType, mediaTypeObject, context: context2 }) {
+  if (!isApplicationJsonMediaType(mediaType)) {
+    return void 0;
+  }
+  const schema2 = mediaTypeObject.schema;
+  return {
+    contentType: !mediaType.includes("*") ? mediaType : void 0,
+    schema: schema2 ?? {},
+    examples: getExamples2(mediaTypeObject, context2)
+  };
+}
+function getApplicationJsonSchemaMediaObjectFromContent({ content: content5, context: context2 }) {
+  const request6 = findApplicationJsonRequest({ content: content5, context: context2 });
+  if (!request6) {
+    return void 0;
+  }
+  const [mediaType, mediaTypeObject] = request6;
+  return getApplicationJsonSchemaMediaObject({ mediaType, mediaTypeObject, context: context2 });
+}
+function getSchemaMediaObject(media2, context2) {
+  for (const contentType of Object.keys(media2)) {
+    const mediaObject = media2[contentType];
+    if (mediaObject == null) {
+      continue;
+    }
+    const schema2 = mediaObject.schema;
+    return {
+      schema: schema2 ?? {},
+      examples: getExamples2(mediaObject, context2)
+    };
+  }
+  return void 0;
+}
+function getExamples2(mediaObject, context2) {
+  const fullExamples = [];
+  if (mediaObject.example != null) {
+    fullExamples.push({ name: void 0, value: mediaObject.example, description: void 0 });
+  }
+  const examples = getExtension(mediaObject, OpenAPIExtension.EXAMPLES);
+  if (examples != null && Object.keys(examples).length > 0) {
+    fullExamples.push(...Object.entries(examples).map(([name3, value]) => {
+      return { name: value.summary ?? name3, value: value.value, description: value.description };
+    }));
+  }
+  if (mediaObject.examples != null && Object.keys(mediaObject.examples).length > 0) {
+    fullExamples.push(...Object.entries(mediaObject.examples).map(([name3, example]) => {
+      const resolvedExample = isReferenceObject(example) ? context2.resolveExampleReference(example) : example;
+      return {
+        name: resolvedExample.summary ?? name3,
+        value: resolvedExample.value,
+        description: resolvedExample.description
+      };
+    }));
+  }
+  return fullExamples;
+}
+
 // ../api-importers/openapi/openapi-ir-parser/lib/schema/utils/getReferenceOccurrences.js
 function getReferenceOccurrences(document4) {
   const contentConflictsRemovedDocument = removeApplicationJsonAndMultipartConflictsFromDocument(document4);
@@ -1535538,97 +1535645,6 @@ function getExplodeForPathParameter(parameter) {
   return explode === false ? void 0 : explode;
 }
 
-// ../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/converters/endpoint/getApplicationJsonSchema.js
-function getTextEventStreamObject(media2, context2) {
-  for (const contentType of Object.keys(media2)) {
-    if (contentType.includes("text/event-stream")) {
-      const mediaObject = media2[contentType];
-      if (mediaObject == null) {
-        continue;
-      }
-      const schema2 = mediaObject.schema;
-      return {
-        contentType,
-        schema: schema2 ?? {},
-        examples: getExamples2(mediaObject, context2)
-      };
-    }
-  }
-  return void 0;
-}
-function isApplicationJsonMediaType(mediaType) {
-  return mediaType.includes("json") || mediaType === "*/*";
-}
-function findApplicationJsonRequest({ content: content5, context: context2 }) {
-  for (const [mediaType, mediaTypeObject] of Object.entries(content5)) {
-    const result = getApplicationJsonSchemaMediaObject({
-      mediaType,
-      mediaTypeObject,
-      context: context2
-    });
-    if (result != null) {
-      return [mediaType, mediaTypeObject];
-    }
-  }
-  return void 0;
-}
-function getApplicationJsonSchemaMediaObject({ mediaType, mediaTypeObject, context: context2 }) {
-  if (!isApplicationJsonMediaType(mediaType)) {
-    return void 0;
-  }
-  const schema2 = mediaTypeObject.schema;
-  return {
-    contentType: !mediaType.includes("*") ? mediaType : void 0,
-    schema: schema2 ?? {},
-    examples: getExamples2(mediaTypeObject, context2)
-  };
-}
-function getApplicationJsonSchemaMediaObjectFromContent({ content: content5, context: context2 }) {
-  const request6 = findApplicationJsonRequest({ content: content5, context: context2 });
-  if (!request6) {
-    return void 0;
-  }
-  const [mediaType, mediaTypeObject] = request6;
-  return getApplicationJsonSchemaMediaObject({ mediaType, mediaTypeObject, context: context2 });
-}
-function getSchemaMediaObject(media2, context2) {
-  for (const contentType of Object.keys(media2)) {
-    const mediaObject = media2[contentType];
-    if (mediaObject == null) {
-      continue;
-    }
-    const schema2 = mediaObject.schema;
-    return {
-      schema: schema2 ?? {},
-      examples: getExamples2(mediaObject, context2)
-    };
-  }
-  return void 0;
-}
-function getExamples2(mediaObject, context2) {
-  const fullExamples = [];
-  if (mediaObject.example != null) {
-    fullExamples.push({ name: void 0, value: mediaObject.example, description: void 0 });
-  }
-  const examples = getExtension(mediaObject, OpenAPIExtension.EXAMPLES);
-  if (examples != null && Object.keys(examples).length > 0) {
-    fullExamples.push(...Object.entries(examples).map(([name3, value]) => {
-      return { name: value.summary ?? name3, value: value.value, description: value.description };
-    }));
-  }
-  if (mediaObject.examples != null && Object.keys(mediaObject.examples).length > 0) {
-    fullExamples.push(...Object.entries(mediaObject.examples).map(([name3, example]) => {
-      const resolvedExample = isReferenceObject(example) ? context2.resolveExampleReference(example) : example;
-      return {
-        name: resolvedExample.summary ?? name3,
-        value: resolvedExample.value,
-        description: resolvedExample.description
-      };
-    }));
-  }
-  return fullExamples;
-}
-
 // ../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/converters/endpoint/convertRequest.js
 function findApplicationUrlFormEncodedRequest({ content: content5, context: context2 }) {
   for (const [mediaType, mediaTypeObject] of Object.entries(content5)) {
@@ -1536901,7 +1536917,13 @@ function convertOperation({ context: context2, pathItemContext, operation, conve
     });
     return { type: "webhook", value: webhooks2 };
   }
-  const streamingExtension = getFernStreamingExtension(operation);
+  let streamingExtension = getFernStreamingExtension(operation);
+  if (streamingExtension == null) {
+    const hasItemSchemaStreaming = checkOperationForItemSchemaStreaming({ operation, context: context2 });
+    if (hasItemSchemaStreaming) {
+      streamingExtension = { type: "stream", format: "sse" };
+    }
+  }
   if (streamingExtension != null) {
     const streamingOperation = convertStreamingOperation({
       context: context2,
@@ -1536971,6 +1536993,21 @@ function getBaseBreadcrumbs({ sdkMethodName, operation, httpMethod, path: path76
   }
   return baseBreadcrumbs;
 }
+function checkOperationForItemSchemaStreaming({ operation, context: context2 }) {
+  if (operation.responses == null) {
+    return false;
+  }
+  for (const response of Object.values(operation.responses)) {
+    const resolvedResponse = isReferenceObject(response) ? context2.resolveResponseReference(response) : response;
+    if (resolvedResponse.content == null) {
+      continue;
+    }
+    if (hasTextEventStreamWithItemSchema(resolvedResponse.content)) {
+      return true;
+    }
+  }
+  return false;
+}
 
 // ../api-importers/openapi/openapi-ir-parser/lib/openapi/v3/converters/convertPathItem.js
 function convertPathItem(path76, pathItemObject, document4, context2) {
@@ -1601813,7 +1601850,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 +1601861,7 @@ var DocsDefinitionResolver = class {
     this.uploadFiles = uploadFiles2;
     this.registerApi = registerApi2;
     this.targetAudiences = targetAudiences;
+    this.pythonDocsSectionHandler = pythonDocsSectionHandler;
   }
   #idgen = NodeIdGenerator2.init();
   /**
@@ -1602512,7 +1602551,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 +1602603,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 +1602631,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 +1602643,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 +1602766,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 +1602821,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 +1602839,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 +1603115,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 +1611620,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.51.0-1-g79714d0ea3a";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -1613390,7 +1613437,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.51.0-1-g79714d0ea3a",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",