feat: rendering the syntax of different content types responses

README.md

@@ -451,6 +451,37 @@ You can decorate your own response headers by following the below example:
 Note: You need to specify `type` property when you decorate the response headers, otherwise the schema will be modified by Fastify.
 
 <a name="route.response.empty_body"></a>
+##### Different content types responses
+**Note:** not supported by Swagger (OpenAPI v2), [only OpenAPI v3](https://swagger.io/docs/specification/describing-responses/)
+<br>
+<br>
+Different content types responses are supported by `@fastify/swagger` and `@fastify`.
+Please use `content` for the response otherwise Fastify itself will fail to compile the schema:
+
+```js
+{
+  response: {
+    200: {
+      description: 'Description and all status-code based properties are working',
+      content: {
+        'application/json': {
+          schema: { 
+            name: { type: 'string' }, 
+            image: { type: 'string' }, 
+            address: { type: 'string' } 
+          }
+        }, 
+        'application/vnd.v1+json': {
+          schema: { 
+            fullName: { type: 'string' }, 
+            phone: { type: 'string' } 
+          }
+        }
+      }
+    }
+  }
+}
+```
 ##### Empty Body Responses
 Empty body responses are supported by `@fastify/swagger`.
 Please specify `type: 'null'` for the response otherwise Fastify itself will fail to compile the schema:

lib/spec/openapi/utils.js

@@ -323,20 +323,25 @@ function resolveResponse (fastifyResponseJson, produces, ref) {
 
     // add schema when type is not 'null'
     if (rawJsonSchema.type !== 'null') {
-      const content = {}
+      if (resolved.content && !resolved.content.type) {
+        response.content = resolved.content
+      } else {
+        const content = {}
 
-      if ((Array.isArray(produces) && produces.length === 0) || typeof produces === 'undefined') {
-        produces = ['application/json']
-      }
+        if ((Array.isArray(produces) && produces.length === 0) || typeof produces === 'undefined') {
+          produces = ['application/json']
+        }
 
-      delete resolved[xResponseDescription]
+        delete resolved[xResponseDescription]
 
-      const media = schemaToMedia(resolved)
-      produces.forEach((produce) => {
-        content[produce] = media
-      })
+        const media = schemaToMedia(resolved)
 
-      response.content = content
+        for (const produce of produces) {
+          content[produce] = media
+        }
+
+        response.content = content
+      }
     }
 
     responsesContainer[statusCode] = response

package.json

@@ -47,7 +47,6 @@
     "@fastify/helmet": "^10.0.0",
     "@fastify/pre-commit": "^2.0.2",
     "@types/node": "^18.0.0",
-    "fastify": "^4.0.0",
     "fluent-json-schema": "^3.1.0",
     "fs-extra": "^10.1.0",
     "joi": "^17.6.0",
@@ -59,6 +58,7 @@
     "tsd": "^0.23.0"
   },
   "dependencies": {
+    "fastify": "github:iifawzi/fastify#supporting-different-content-types",
     "@fastify/static": "^6.0.0",
     "fastify-plugin": "^4.0.0",
     "json-schema-resolver": "^1.3.0",

test/spec/openapi/schema.js

@@ -110,6 +110,96 @@ test('support 2xx response', async t => {
   t.same(definedPath.responses['3XX'].description, 'Default Response')
 })
 
+test('support multiple content types responses', async t => {
+  const fastify = Fastify()
+  await fastify.register(fastifySwagger, {
+    openapi: true,
+    routePrefix: '/docs',
+    exposeRoute: true
+  })
+
+  const opt = {
+    schema: {
+      response: {
+        200: {
+          description: 'Description and all status-code based properties are working',
+          content: {
+            'application/json': {
+              schema: {
+                name: { type: 'string' },
+                image: { type: 'string' },
+                address: { type: 'string' }
+              }
+            },
+            'application/vnd.v1+json': {
+              schema: {
+                fullName: { type: 'string' },
+                phone: { type: 'string' }
+              }
+            }
+          }
+        },
+        '4xx': {
+          type: 'object',
+          properties: {
+            name: { type: 'string' }
+          }
+        },
+        300: {
+          age: { type: 'number' }
+        }
+      }
+    }
+  }
+  fastify.get('/', opt, () => {})
+
+  await fastify.ready()
+
+  const swaggerObject = fastify.swagger()
+  const api = await Swagger.validate(swaggerObject)
+  const definedPath = api.paths['/'].get
+  t.same(definedPath.responses['200'].description, 'Description and all status-code based properties are working')
+  t.same(definedPath.responses['200'].content, {
+    'application/json': {
+      schema: {
+        type: 'object',
+        properties: {
+          name: { type: 'string' }, image: { type: 'string' }, address: { type: 'string' }
+        }
+      }
+    },
+    'application/vnd.v1+json': {
+      schema: {
+        type: 'object',
+        properties: {
+          fullName: { type: 'string' }, phone: { type: 'string' }
+        }
+      }
+    }
+  })
+  t.same(definedPath.responses['4XX'].description, 'Default Response')
+  t.same(definedPath.responses['4XX'].content, {
+    'application/json': {
+      schema: {
+        type: 'object',
+        properties: {
+          name: { type: 'string' }
+        }
+      }
+    }
+  })
+  t.same(definedPath.responses[300].content, {
+    'application/json': {
+      schema: {
+        type: 'object',
+        properties: {
+          age: { type: 'number' }
+        }
+      }
+    }
+  })
+})
+
 test('support status code 204', async t => {
   const opt = {
     schema: {