@fern-api/fern-api-dev 4.62.3-3-g2870783b556 → 4.62.3-4-gc085443a514

package/cli.cjs

@@ -588535,7 +588535,7 @@ var RequestBodyConverter = class extends converters_exports.AbstractConverters.A
       contentType
     });
     if (convertedSchema == null) {
-      return void 0;
+      return this.handleSchemalessJsonContent({ contentType, mediaTypeObject });
     }
     const requestBodyTypeShape = convertedSchema.schema?.typeDeclaration.shape;
     if (requestBodyTypeShape?.type === "object") {
@@ -588591,6 +588591,55 @@ var RequestBodyConverter = class extends converters_exports.AbstractConverters.A
       };
     }
   }
+  /**
+   * Handles JSON request bodies that have no schema but DO have native OpenAPI
+   * examples. Creates an unknown-typed reference request body so that examples
+   * are preserved for docs rendering and code snippet generation.
+   */
+  handleSchemalessJsonContent({ contentType, mediaTypeObject }) {
+    const hasExamples = mediaTypeObject.example != null || mediaTypeObject.examples != null && Object.keys(mediaTypeObject.examples).length > 0;
+    if (!hasExamples) {
+      return void 0;
+    }
+    const v2Examples = {
+      userSpecifiedExamples: {},
+      autogeneratedExamples: {}
+    };
+    const examples = this.context.getNamedExamplesFromMediaTypeObject({
+      mediaTypeObject,
+      breadcrumbs: this.breadcrumbs,
+      defaultExampleName: `${[...this.group, this.method].join("_")}_example`
+    });
+    const usedExampleNames = /* @__PURE__ */ new Set();
+    for (const [key2, example] of examples) {
+      const resolvedExample = this.context.resolveExampleWithValue(example);
+      const resolvedExampleObject = this.context.resolveExampleRecursively({
+        example,
+        breadcrumbs: this.breadcrumbs
+      });
+      let exampleName = key2;
+      if (this.context.isExampleWithSummary(resolvedExampleObject)) {
+        const summary = resolvedExampleObject.summary;
+        if (!usedExampleNames.has(summary)) {
+          exampleName = summary;
+        }
+      }
+      usedExampleNames.add(exampleName);
+      if (resolvedExample != null) {
+        v2Examples.userSpecifiedExamples[exampleName] = resolvedExample;
+      }
+    }
+    return {
+      requestBody: HttpRequestBody.reference({
+        contentType,
+        docs: this.description,
+        requestBodyType: TypeReference2.unknown(),
+        v2Examples
+      }),
+      streamRequestBody: void 0,
+      inlinedTypes: {}
+    };
+  }
   handleMultipartContent({ contentType }) {
     const mediaTypeObject = this.mediaType;
     if (mediaTypeObject == null || mediaTypeObject.schema == null) {
@@ -590440,6 +590489,18 @@ var OperationConverter = class _OperationConverter extends AbstractOperationConv
       httpMethod,
       baseUrl
     });
+    if (Object.keys(fernExamples.examples).length === 0 && Object.keys(fernExamples.streamExamples).length === 0) {
+      const nativeExamples = this.synthesizeEndpointExamplesFromNativeRequestBody({
+        httpPath: path97,
+        httpMethod,
+        baseUrl
+      });
+      if (nativeExamples != null) {
+        for (const [name2, example] of Object.entries(nativeExamples)) {
+          fernExamples.examples[name2] = example;
+        }
+      }
+    }
     const endpointLevelSecuritySchemes = new Set(this.operation.security?.flatMap((securityRequirement) => Object.keys(securityRequirement)) ?? []);
     const securityHeaders = this.authSchemeToHeaders(Array.from(endpointLevelSecuritySchemes));
     if (securityHeaders.length > 0) {
@@ -590876,6 +590937,107 @@ var OperationConverter = class _OperationConverter extends AbstractOperationConv
       streamExamples: {}
     };
   }
+  /**
+   * Synthesizes endpoint-level v2Examples from native OpenAPI request body
+   * examples (mediaType.example / mediaType.examples) when no x-fern-examples
+   * or x-code-samples extensions are present.
+   *
+   * This ensures that specs like Close's, which have native examples on
+   * schemaless request bodies, get rendered in docs and code snippets.
+   *
+   * Also extracts native response examples from the operation's successful (2xx)
+   * responses so that the 200 response panel is preserved in docs.
+   */
+  synthesizeEndpointExamplesFromNativeRequestBody({ httpPath, httpMethod, baseUrl }) {
+    if (this.operation.requestBody == null) {
+      return void 0;
+    }
+    const resolvedRequestBody = this.context.resolveMaybeReference({
+      schemaOrReference: this.operation.requestBody,
+      breadcrumbs: [...this.breadcrumbs, "requestBody"]
+    });
+    if (resolvedRequestBody == null) {
+      return void 0;
+    }
+    const responseExample = this.extractNativeResponseExample();
+    const result = {};
+    for (const [, mediaType] of Object.entries(resolvedRequestBody.content)) {
+      if (mediaType.schema != null) {
+        continue;
+      }
+      const namedExamples = this.context.getNamedExamplesFromMediaTypeObject({
+        mediaTypeObject: mediaType,
+        breadcrumbs: [...this.breadcrumbs, "requestBody"],
+        defaultExampleName: "Example"
+      });
+      for (const [name2, example] of namedExamples) {
+        const resolvedValue = this.context.resolveExampleWithValue(example);
+        if (resolvedValue != null) {
+          result[name2] = {
+            displayName: void 0,
+            request: {
+              docs: void 0,
+              endpoint: {
+                method: httpMethod,
+                path: this.buildExamplePath(httpPath, {})
+              },
+              baseUrl: void 0,
+              environment: baseUrl,
+              auth: void 0,
+              pathParameters: {},
+              queryParameters: {},
+              headers: {},
+              requestBody: resolvedValue
+            },
+            response: responseExample,
+            codeSamples: void 0
+          };
+        }
+      }
+    }
+    return Object.keys(result).length > 0 ? result : void 0;
+  }
+  /**
+   * Extracts the first native example from the operation's successful (2xx) response.
+   * This is used to populate the response body in synthesized endpoint examples
+   * so that the 200 response panel is preserved in docs.
+   */
+  extractNativeResponseExample() {
+    if (this.operation.responses == null) {
+      return void 0;
+    }
+    for (const [statusCode, response] of Object.entries(this.operation.responses)) {
+      const statusCodeNum = parseInt(statusCode);
+      if (isNaN(statusCodeNum) || statusCodeNum < 200 || statusCodeNum >= 300) {
+        continue;
+      }
+      const resolvedResponse = this.context.resolveMaybeReference({
+        schemaOrReference: response,
+        breadcrumbs: [...this.breadcrumbs, "responses", statusCode]
+      });
+      if (resolvedResponse?.content == null) {
+        continue;
+      }
+      for (const [, responseMediaType] of Object.entries(resolvedResponse.content)) {
+        const namedExamples = this.context.getNamedExamplesFromMediaTypeObject({
+          mediaTypeObject: responseMediaType,
+          breadcrumbs: [...this.breadcrumbs, "responses", statusCode],
+          defaultExampleName: "Example"
+        });
+        for (const [, example] of namedExamples) {
+          const resolvedValue = this.context.resolveExampleWithValue(example);
+          if (resolvedValue != null) {
+            return {
+              docs: void 0,
+              statusCode: statusCodeNum,
+              body: api_exports.V2HttpEndpointResponseBody.json(resolvedValue)
+            };
+          }
+        }
+      }
+    }
+    return void 0;
+  }
   convertStreamConditionExamples({ httpPath, httpMethod, baseUrl, fernExamples }) {
     const filteredJsonExamples = fernExamples.filter((example) => !(example.response != null && "stream" in example.response));
     const filteredStreamExamples = fernExamples.filter((example) => example.response != null && "stream" in example.response);
@@ -602754,7 +602916,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.62.3-3-g2870783b556",
+          version: "4.62.3-4-gc085443a514",
           usingAccessToken: true
         }
       });
@@ -602805,7 +602967,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.62.3-3-g2870783b556",
+        version: "4.62.3-4-gc085443a514",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -840101,7 +840263,7 @@ var import_path54 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "4.62.3-3-g2870783b556";
+  const version7 = "4.62.3-4-gc085443a514";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -851209,7 +851371,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.62.3-3-g2870783b556"
+        cliVersion: "4.62.3-4-gc085443a514"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -924509,7 +924671,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.62.3-3-g2870783b556";
+    return "4.62.3-4-gc085443a514";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.62.3-3-g2870783b556",
+  "version": "4.62.3-4-gc085443a514",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",