fix: set responses without content schemas to never or unknown, depending on status code

src/types/OpenAPI3.ts

@@ -32,7 +32,7 @@ export interface OpenAPI3Parameter {
 
 export interface OpenAPI3ResponseObject {
   description?: string;
-  content: {
+  content?: {
     [contentType: string]: { schema: OpenAPI3SchemaObject | OpenAPI3Reference };
   };
 }

src/utils.ts

@@ -8,7 +8,7 @@ export function comment(text: string): string {
 }
 
 /** shim for Object.fromEntries() for Node < 13 */
-export function fromEntries(entries: [string, any][]): object {
+export function fromEntries(entries: [string, any][]): Record<string, unknown> {
   return entries.reduce((obj, [key, val]) => ({ ...obj, [key]: val }), {});
 }
 

src/v3.ts

@@ -196,7 +196,11 @@ export default function generateTypesV3(
           ([statusCode, response]) => {
             if (response.description) output += comment(response.description);
             if (!response.content || !Object.keys(response.content).length) {
-              output += `"${statusCode}": any;\n`;
+              const type =
+                statusCode === "204" || Math.floor(+statusCode / 100) === 3
+                  ? "never"
+                  : "unknown";
+              output += `"${statusCode}": ${type};\n`;
               return;
             }
             output += `"${statusCode}": {\n`;

tests/bin/expected/petstore.ts

@@ -10,23 +10,23 @@ export interface paths {
         /**
          * Invalid ID supplied
          */
-        '400': any
+        '400': unknown
         /**
          * Pet not found
          */
-        '404': any
+        '404': unknown
         /**
          * Validation exception
          */
-        '405': any
+        '405': unknown
       }
     }
     post: {
       responses: {
         /**
          * Invalid input
          */
-        '405': any
+        '405': unknown
       }
     }
   }
@@ -54,7 +54,7 @@ export interface paths {
         /**
          * Invalid status value
          */
-        '400': any
+        '400': unknown
       }
     }
   }
@@ -82,7 +82,7 @@ export interface paths {
         /**
          * Invalid tag value
          */
-        '400': any
+        '400': unknown
       }
     }
   }
@@ -110,11 +110,11 @@ export interface paths {
         /**
          * Invalid ID supplied
          */
-        '400': any
+        '400': unknown
         /**
          * Pet not found
          */
-        '404': any
+        '404': unknown
       }
     }
     post: {
@@ -130,7 +130,7 @@ export interface paths {
         /**
          * Invalid input
          */
-        '405': any
+        '405': unknown
       }
     }
     delete: {
@@ -149,11 +149,11 @@ export interface paths {
         /**
          * Invalid ID supplied
          */
-        '400': any
+        '400': unknown
         /**
          * Pet not found
          */
-        '404': any
+        '404': unknown
       }
     }
   }
@@ -205,7 +205,7 @@ export interface paths {
         /**
          * Invalid Order
          */
-        '400': any
+        '400': unknown
       }
     }
   }
@@ -233,11 +233,11 @@ export interface paths {
         /**
          * Invalid ID supplied
          */
-        '400': any
+        '400': unknown
         /**
          * Order not found
          */
-        '404': any
+        '404': unknown
       }
     }
     /**
@@ -256,11 +256,11 @@ export interface paths {
         /**
          * Invalid ID supplied
          */
-        '400': any
+        '400': unknown
         /**
          * Order not found
          */
-        '404': any
+        '404': unknown
       }
     }
   }
@@ -273,7 +273,7 @@ export interface paths {
         /**
          * successful operation
          */
-        default: any
+        default: unknown
       }
     }
   }
@@ -283,7 +283,7 @@ export interface paths {
         /**
          * successful operation
          */
-        default: any
+        default: unknown
       }
     }
   }
@@ -293,7 +293,7 @@ export interface paths {
         /**
          * successful operation
          */
-        default: any
+        default: unknown
       }
     }
   }
@@ -322,7 +322,7 @@ export interface paths {
         /**
          * Invalid username/password supplied
          */
-        '400': any
+        '400': unknown
       }
     }
   }
@@ -332,7 +332,7 @@ export interface paths {
         /**
          * successful operation
          */
-        default: any
+        default: unknown
       }
     }
   }
@@ -357,11 +357,11 @@ export interface paths {
         /**
          * Invalid username supplied
          */
-        '400': any
+        '400': unknown
         /**
          * User not found
          */
-        '404': any
+        '404': unknown
       }
     }
     /**
@@ -380,11 +380,11 @@ export interface paths {
         /**
          * Invalid user supplied
          */
-        '400': any
+        '400': unknown
         /**
          * User not found
          */
-        '404': any
+        '404': unknown
       }
     }
     /**
@@ -403,11 +403,11 @@ export interface paths {
         /**
          * Invalid username supplied
          */
-        '400': any
+        '400': unknown
         /**
          * User not found
          */
-        '404': any
+        '404': unknown
       }
     }
   }