Add enum type handling for parameters

Author: qertis

index.js

@@ -154,8 +154,16 @@ async function openapiJsonrpcJsdoc({ files, securitySchemes = {}, packageUrl, se
           if (parameter.type.names[0] === 'object') {
             return accumulator;
           }
-          let [type] = parameter.type.names;
+          let type;
+          if (parameter.type.names.length === 0) {
+            type = 'null';
+          } else if (parameter.type.names.length === 1) {
+            type = parameter.type.names[0];
+          } else {
+            type = 'enum';
+          }
           let items;
+          let enumData;
           switch (type) {
             case 'Array.<string>': {
               type = 'array';
@@ -167,6 +175,11 @@ async function openapiJsonrpcJsdoc({ files, securitySchemes = {}, packageUrl, se
               items = { type: 'string' };
               break;
             }
+            case 'enum': {
+              type = 'string';
+              enumData = parameter.type.names;
+              break;
+            }
             default: {
               break;
             }
@@ -187,6 +200,7 @@ async function openapiJsonrpcJsdoc({ files, securitySchemes = {}, packageUrl, se
               type,
               description,
               items,
+              enum: enumData,
             },
           };
           return accumulator;

package.json

@@ -1,6 +1,6 @@
 {
   "name": "openapi-jsonrpc-jsdoc",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Transform JSDoc-annotated JSON-RPC 2.0 methods into OpenAPI 3.0 specifications. Auto-generates REST API documentation with complete schemas, parameters, and endpoint definitions.",
   "main": "index.js",
   "scripts": {

test/api/v1.js

@@ -5,6 +5,7 @@
  * @param {string} parameters.id - id
  * @param {string} [parameters.test] - test
  * @param {string[]} parameters.array - array
+ * @param {1|2} parameters.num - enum
  * @tags api, api-v1, api
  * @example
  * {

test/index.test.js

@@ -63,6 +63,8 @@ test('t1', t => {
   t.deepEqual(v1Test.post.tags, Array.from(new Set(v1Test.post.tags)));
   t.true(Array.isArray(v1Test.post.parameters));
   const v1RequestBodySchema = v1Test.post.requestBody.content['application/json'].schema;
+  t.is(v1RequestBodySchema.properties.params.properties.test.type, 'string');
+  t.is(v1RequestBodySchema.properties.params.properties.array.type, 'array');
   t.is(v1RequestBodySchema.type, 'object');
   t.true(v1RequestBodySchema.required.includes('method'));
 });