Update OpenAPI generation to use Set for tags

Author: qertis

README.md

@@ -13,6 +13,7 @@ npm i openapi-jsonrpc-jsdoc --save-dev
 ```js
 // api/api-v1.js
 /**
+ * @json-rpc
  * @description Название API
  * @param {object} parameters - params
  * @param {string} parameters.id - id

index.js

@@ -13,7 +13,7 @@ async function openapiJsonrpcJsdoc({ files, securitySchemes = {}, packageUrl, se
     dictionaries: ['jsdoc'],
     hierarchy: true,
   });
-  const tags = [];
+  const tags = new Set();
   const temporaryDocument = {
     'x-send-defaults': true,
     'openapi': '3.0.0',
@@ -59,25 +59,33 @@ async function openapiJsonrpcJsdoc({ files, securitySchemes = {}, packageUrl, se
         BasicAuth: [],
       },
     ],
-    'tags': tags,
+    'tags': [],
   };
   const requiredSchema = ['method', 'id', 'jsonrpc'];
-  for (const module of documents) {
-    const apiName = module.meta.filename.replace(/.js$/, '');
+  prepare: for (const module of documents) {
+    let isJsonRpc = false;
 
     if (module.tags && Array.isArray(module.tags)) {
-      for (const tag of module.tags) {
-        tags.push(...new Set(tag.value.split(',').map(t => t.trim())));
+      for (const {title, value} of module.tags) {
+        if (title === 'json-rpc') {
+          isJsonRpc = true;
+        } else if (title === 'tags' && value) {
+          value.split(',').map(t => t.trim()).forEach(t => tags.add(t));
+        }
       }
     }
+    if (!isJsonRpc) {
+      continue prepare;
+    }
+    const apiName = module.meta.filename.replace(/.js$/, '');
 
     const schema = {
       post: {
         operationId: `${module.meta.filename}`,
         deprecated: module.deprecated || false,
         summary: `/${apiName}`,
         description: module.description,
-        tags: tags,
+        tags: Array.from(tags),
         parameters: [],
         responses: {
           '200': {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "openapi-jsonrpc-jsdoc",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "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

@@ -1,4 +1,5 @@
 /**
+ * @json-rpc
  * @description Название API
  * @param {object} parameters - params
  * @param {string} parameters.id - id

test/api/v2.js

@@ -1,8 +1,9 @@
 /**
+ * @json-rpc
  * @deprecated
  * @description Название API 2
  * @return {null}
  */
 module.exports = () => {
   return null;
-};
+};

test/index.test.js

@@ -1,7 +1,7 @@
 const test = require('ava');
 const express = require('express');
-const http = require('http');
-const path = require('path');
+const http = require('node:http');
+const path = require('node:path');
 const OpenApiValidator = require('express-openapi-validator');
 const openapiJSONRpcJSDoc = require('../index');
 
@@ -60,6 +60,7 @@ test('t1', t => {
   t.false(v1Test.post.deprecated);
   t.is(typeof v1Test.post.description, 'string');
   t.true(Array.isArray(v1Test.post.tags));
+  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.type, 'object');