next-openapi-gen 0.5.3 → 0.5.4

package/dist/lib/route-processor.js

@@ -109,7 +109,7 @@ export class RouteProcessor {
         const routePath = this.getRoutePath(filePath);
         const rootPath = capitalize(routePath.split("/")[1]);
         const operationId = getOperationId(routePath, method);
-        const { tag, summary, description, auth, isOpenApi } = dataTypes;
+        const { tag, summary, description, auth, isOpenApi, deprecated, bodyDescription, responseDescription, } = dataTypes;
         if (this.config.includeOpenApiRoutes && !isOpenApi) {
             // If flag is enabled and there is no @openapi tag, then skip path
             return;
@@ -125,6 +125,9 @@ export class RouteProcessor {
             tags: [tag || rootPath],
             parameters: [],
         };
+        if (deprecated) {
+            definition.deprecated = true;
+        }
         // Add auth
         if (auth) {
             definition.security = [
@@ -157,12 +160,11 @@ export class RouteProcessor {
         }
         // Add request body
         if (MUTATION_HTTP_METHODS.includes(method.toUpperCase())) {
-            definition.requestBody =
-                this.schemaProcessor.createRequestBodySchema(body);
+            definition.requestBody = this.schemaProcessor.createRequestBodySchema(body, bodyDescription);
         }
         // Add responses
         definition.responses = responses
-            ? this.schemaProcessor.createResponseSchema(responses)
+            ? this.schemaProcessor.createResponseSchema(responses, responseDescription)
             : {};
         this.swaggerPaths[routePath][method] = definition;
     }

package/dist/lib/schema-processor.js

@@ -555,19 +555,23 @@ export class SchemaProcessor {
         }
         return queryParams;
     }
-    createRequestBodySchema(body) {
-        return {
+    createRequestBodySchema(body, description) {
+        const schema = {
             content: {
                 "application/json": {
                     schema: body,
                 },
             },
         };
+        if (description) {
+            schema.description = description;
+        }
+        return schema;
     }
-    createResponseSchema(responses) {
+    createResponseSchema(responses, description) {
         return {
             200: {
-                description: "Successful response",
+                description: description || "Successful response",
                 content: {
                     "application/json": {
                         schema: responses,

package/dist/lib/utils.js

@@ -25,10 +25,30 @@ export function extractJSDocComments(path) {
     let responseType = "";
     let auth = "";
     let isOpenApi = false;
+    let deprecated = false;
+    let bodyDescription = "";
+    let responseDescription = "";
     if (comments) {
         comments.forEach((comment) => {
             const commentValue = cleanComment(comment.value);
             isOpenApi = commentValue.includes("@openapi");
+            if (commentValue.includes("@deprecated")) {
+                deprecated = true;
+            }
+            if (commentValue.includes("@bodyDescription")) {
+                const regex = /@bodyDescription\s*(.*)/;
+                const match = commentValue.match(regex);
+                if (match && match[1]) {
+                    bodyDescription = match[1].trim();
+                }
+            }
+            if (commentValue.includes("@responseDescription")) {
+                const regex = /@responseDescription\s*(.*)/;
+                const match = commentValue.match(regex);
+                if (match && match[1]) {
+                    responseDescription = match[1].trim();
+                }
+            }
             if (!summary) {
                 summary = commentValue.split("\n")[0];
             }
@@ -82,6 +102,9 @@ export function extractJSDocComments(path) {
         bodyType,
         responseType,
         isOpenApi,
+        deprecated,
+        bodyDescription,
+        responseDescription,
     };
 }
 export function extractTypeFromComment(commentValue, tag) {

package/dist/lib/zod-converter.js

@@ -877,6 +877,9 @@ export class ZodSchemaConverter {
                     schema.description = node.arguments[0].value;
                 }
                 break;
+            case "deprecated":
+                schema.deprecated = true;
+                break;
             case "min":
                 if (node.arguments.length > 0 &&
                     t.isNumericLiteral(node.arguments[0])) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-openapi-gen",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Automatically generate OpenAPI 3.0 documentation from Next.js projects, with support for TypeScript types and Zod schemas.",
   "type": "module",
   "main": "dist/index.js",