feat: only generate docs for methods that are in the serviceOptions methods

Author: Mairu

lib/openapi.js

@@ -3,6 +3,8 @@ const utils = require('./utils');
 const { assignWithSet } = require('./helpers');
 const { getCustomMethods } = require('./custom-methods');
 
+const serviceMethods = ['find', 'get', 'create', 'update', 'patch', 'remove'];
+
 const defaultMethods = [
   { operation: 'find', method: 'find', id: false, httpMethod: 'get', multi: false },
   { operation: 'get', method: 'get', id: true, httpMethod: 'get', multi: false },
@@ -136,6 +138,16 @@ class OpenApiGenerator {
     if (doc.operations === undefined) {
       doc.operations = {};
     }
+
+    // disable methods that are not defined for feathers 5
+    if (serviceOptions && Array.isArray(serviceOptions.methods)) {
+      serviceMethods.forEach(serviceMethod => {
+        if (!serviceOptions.methods.includes(serviceMethod)) {
+          doc.operations[serviceMethod] = false;
+        }
+      });
+    }
+
     const idName = service.id || 'id';
     const idType = doc.idType || this.config.idType || 'integer';
     let version = this.config.versionPrefix ? path.match(this.config.versionPrefix) : null;

test/v3/generator.test.js

@@ -1254,6 +1254,42 @@ describe('openopi v3 generator', function () {
         });
       });
     });
+
+    describe('serviceOptions (v5)', () => {
+      it('should consume consume docs from serviceOptions', () => {
+        delete service.docs;
+        gen.addService(service, 'message', {
+          methods: ['find', 'get'],
+          events: [],
+          docs: {
+            description: 'my custom description'
+          }
+        });
+
+        expect(specs.tags).to.deep.equal([
+          {
+            description: 'my custom description',
+            name: 'message'
+          }
+        ]);
+        expect(specs.paths['/message'].get).to.exist;
+        expect(specs.paths['/message/{id}'].get).to.exist;
+      });
+
+      it('should disable methods that are missing from methods array', () => {
+        delete service.docs;
+        gen.addService(service, 'message', {
+          methods: ['find'],
+          events: [],
+          docs: {
+            description: 'my custom description'
+          }
+        });
+
+        expect(specs.paths['/message'].get).to.exist;
+        expect(specs.paths['/message/{id}']).to.not.exist;
+      });
+    });
   });
 
   describe('custom methods', function () {