@fern-api/fern-api-dev 5.58.0 → 5.59.0

package/cli.cjs

@@ -76219,6 +76219,7 @@ var init_V2HttpEndpointExample2 = __esm({
     init_V2HttpEndpointResponse2();
     V2HttpEndpointExample = schemas_exports3.objectWithoutOptionalProperties({
       displayName: schemas_exports3.string().optional(),
+      contentType: schemas_exports3.string().optional(),
       request: V2HttpEndpointRequest.optional(),
       response: V2HttpEndpointResponse.optional(),
       codeSamples: schemas_exports3.list(V2HttpEndpointCodeSample).optional()
@@ -263778,6 +263779,7 @@ function maybeCreateAndStoreExample({ key: key2, displayName, request: request7,
   if (!exampleStore.has(key2)) {
     const example = {
       displayName,
+      contentType: void 0,
       request: request7,
       response,
       codeSamples: void 0
@@ -350712,6 +350714,19 @@ var init_OperationConverter = __esm({
             }
           }
         }
+        if (Object.keys(fernExamples.examples).length === 0 && Object.keys(fernExamples.streamExamples).length === 0 && convertedRequestBodies != null && convertedRequestBodies.length > 1) {
+          const perContentTypeExamples = this.synthesizeEndpointExamplesFromPerContentTypeRequestBodies({
+            convertedRequestBodies,
+            httpPath: path119,
+            httpMethod,
+            baseUrl
+          });
+          if (perContentTypeExamples != null) {
+            for (const [name2, example] of Object.entries(perContentTypeExamples)) {
+              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) {
@@ -351235,6 +351250,7 @@ var init_OperationConverter = __esm({
             if (resolvedValue != null) {
               result[name2] = {
                 displayName: void 0,
+                contentType: void 0,
                 request: {
                   docs: void 0,
                   endpoint: {
@@ -351298,6 +351314,104 @@ var init_OperationConverter = __esm({
         }
         return void 0;
       }
+      /**
+       * Synthesizes endpoint-level v2Examples from per-content-type request body
+       * examples that have already been extracted by the RequestBodyConverter.
+       *
+       * This handles the case where multiple content types (e.g. application/json
+       * and application/ld+json) reference the same schema but have distinct
+       * per-content-type examples. The RequestBodyConverter correctly extracts
+       * these into each body's v2Examples, but they need to be elevated to
+       * endpoint-level examples (tagged with contentType) for docs rendering.
+       */
+      synthesizeEndpointExamplesFromPerContentTypeRequestBodies({ convertedRequestBodies, httpPath, httpMethod, baseUrl }) {
+        const result = {};
+        const responseExamplesByContentType = this.extractNativeResponseExamplesByContentType();
+        for (const convertedBody of convertedRequestBodies) {
+          const body = convertedBody.requestBody;
+          const bodyContentType = body.contentType;
+          const bodyV2Examples = body.v2Examples;
+          if (bodyV2Examples == null) {
+            continue;
+          }
+          const userExamples = bodyV2Examples.userSpecifiedExamples;
+          if (Object.keys(userExamples).length === 0) {
+            continue;
+          }
+          const matchedResponse = bodyContentType != null ? responseExamplesByContentType.get(bodyContentType) : void 0;
+          for (const [exampleName, exampleValue] of Object.entries(userExamples)) {
+            const key2 = convertedRequestBodies.length > 1 && bodyContentType != null ? `${exampleName} (${bodyContentType})` : exampleName;
+            result[key2] = {
+              displayName: convertedRequestBodies.length > 1 ? key2 : void 0,
+              contentType: bodyContentType ?? 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: exampleValue
+              },
+              response: matchedResponse ?? this.extractNativeResponseExample() ?? void 0,
+              codeSamples: void 0
+            };
+          }
+        }
+        return Object.keys(result).length > 0 ? result : void 0;
+      }
+      /**
+       * Extracts native response examples grouped by content type from the
+       * operation's successful (2xx) responses. Used by
+       * synthesizeEndpointExamplesFromPerContentTypeRequestBodies to match
+       * response examples to their corresponding request content types.
+       */
+      extractNativeResponseExamplesByContentType() {
+        const responsesByContentType = /* @__PURE__ */ new Map();
+        if (this.operation.responses == null) {
+          return responsesByContentType;
+        }
+        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 [responseContentType, responseMediaType] of Object.entries(resolvedResponse.content)) {
+            if (responsesByContentType.has(responseContentType)) {
+              continue;
+            }
+            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) {
+                responsesByContentType.set(responseContentType, {
+                  docs: void 0,
+                  statusCode: statusCodeNum,
+                  body: api_exports.V2HttpEndpointResponseBody.json(resolvedValue)
+                });
+                break;
+              }
+            }
+          }
+        }
+        return responsesByContentType;
+      }
       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);
@@ -351321,6 +351435,7 @@ var init_OperationConverter = __esm({
             this.getExampleName({ example, exampleIndex }),
             {
               displayName: void 0,
+              contentType: void 0,
               request: example.request != null || example["path-parameters"] != null || example["query-parameters"] != null || example.headers != null ? {
                 docs: void 0,
                 endpoint: {
@@ -352776,6 +352891,7 @@ var init_MethodConverter = __esm({
             }
             examples[exampleName] = {
               displayName: void 0,
+              contentType: void 0,
               request: {
                 docs: void 0,
                 endpoint: {
@@ -686972,7 +687088,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.58.0",
+          version: "5.59.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -687038,7 +687154,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.58.0",
+        version: "5.59.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -868133,7 +868249,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.58.0";
+  const version7 = "5.59.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -900614,7 +900730,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.58.0",
+        cliVersion: "5.59.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -964455,6 +964571,7 @@ init_lib9();
 function initializeEmptyServiceExample() {
   return {
     displayName: void 0,
+    contentType: void 0,
     request: {
       endpoint: {
         method: V2EndpointLocationHttpMethod.Post,
@@ -966883,7 +967000,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.58.0"
+    cli_version: "5.59.0"
   };
 }
 function isAutomationMode() {
@@ -967715,7 +967832,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.58.0";
+    return "5.59.0";
   }
   getCliName() {
     if (false) {

package/package.json

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