Feat/expose transform methods (#149)

* feat: expose transforms methods and jsdocInfo info

* test: updated components, configuration and parameters tests

* test: added missing test to exposed methods

index.js

@@ -19,10 +19,15 @@ const expressJSDocSwagger = app => (userOptions = {}, userSwagger = {}) => {
     .then(result => {
       swaggerObject = {
         ...swaggerObject,
-        ...result,
+        ...result.swaggerObject,
       };
       swaggerObject = merge.recursive(true, swaggerObject, userSwagger);
-      events.finish(swaggerObject);
+      events.finish(swaggerObject, {
+        jsdocInfo: result.jsdocInfo,
+        getPaths: result.getPaths,
+        getComponents: result.getComponents,
+        getTags: result.getTags,
+      });
     })
     .catch(events.error);
 

processSwagger.js

@@ -36,7 +36,9 @@ const processSwagger = (options, logger = defaultLogger) => {
       logger({ entity: 'components', swaggerObject });
       swaggerObject = getTags(swaggerObject, data);
       logger({ entity: 'tags', swaggerObject });
-      return swaggerObject;
+      return {
+        swaggerObject, jsdocInfo, getPaths, getComponents, getTags,
+      };
     });
 };
 

swaggerEvents.js

@@ -14,8 +14,8 @@ const processFile = eventEmitter => info => (
   eventEmitter.emit(PROCESS_EVENT_NAME, info)
 );
 
-const finish = eventEmitter => info => (
-  eventEmitter.emit(FINISH_EVENT_NAME, info)
+const finish = eventEmitter => (info, methods) => (
+  eventEmitter.emit(FINISH_EVENT_NAME, info, methods)
 );
 
 const swaggerEvents = () => {

test/e2e/components/components.test.js

@@ -86,5 +86,5 @@ test('should parse components jsdoc from jsdoc-example', async () => {
     },
   };
   const result = await processSwagger(options);
-  expect(result).toEqual(expected);
+  expect(result.swaggerObject).toEqual(expected);
 });

test/e2e/configuration/configuration.test.js

@@ -90,5 +90,12 @@ test('should parse basic info', async () => {
     },
   };
   const result = await processSwagger(options);
-  expect(result).toEqual(expected);
+  expect(result.swaggerObject).toEqual(expected);
+});
+test('should get transforms(jsdocInfo, getPaths, getComponents, getTags) methods', async () => {
+  const result = await processSwagger(options);
+  expect(result).toHaveProperty('jsdocInfo');
+  expect(result).toHaveProperty('getPaths');
+  expect(result).toHaveProperty('getComponents');
+  expect(result).toHaveProperty('getTags');
 });

test/e2e/parameters/parameters.test.js

@@ -119,5 +119,5 @@ test('should parse parameters from jsdoc-example', async () => {
     },
   };
   const result = await processSwagger(options);
-  expect(result).toEqual(expected);
+  expect(result.swaggerObject).toEqual(expected);
 });