feat(swagger): add a swagger-js based client (#18)

lib/loader.js

@@ -89,6 +89,7 @@ class Component {
       component.templatedEndpoints = null
     }
 
+    component.operationIds = {}
     component.parameters = options.parameters
     component.template = options.template
     component.splits = options.splits.slice()
@@ -206,6 +207,7 @@ class Component {
     Object.keys(endpoint.pathItem)
       .filter(key => endpoint.pathItem[key].operationId)
       .forEach(method => {
+        component.operationIds[method] = endpoint.pathItem[method].operationId
         component[method] = component['_' + method]
         if (method === 'get') component.getStream = component._getStream
       })
@@ -218,8 +220,10 @@ class Component {
    * @returns {(Promise|Stream)} Promise
    */
   _requestAsync (method, options) {
+    const operationId = this.operationIds[method.toLowerCase()]
     return this.http.http(Object.assign({
       method,
+      operationId,
       pathname: this.getPath(),
       pathnameParameters: this.parameters
     }, options))

lib/loader.test.js

@@ -41,6 +41,9 @@ describe('list.loader', () => {
           '/foo/bar/': {
             get: {
               operationId: 'fooBarGet'
+            },
+            post: {
+              operationId: 'fooBarPost'
             }
           }
         }

lib/swagger-client.js

@@ -0,0 +1,39 @@
+'use strict'
+
+class SwaggerClient {
+  /**
+   * {@link https://github.com/swagger-api/swagger-js Swagger Client} client
+   * @param {object} options
+   * @param {function} options.client - Instance of a Swagger.
+   */
+  constructor ({ client }) {
+    this.client = client
+  }
+
+  /**
+   * Invoke API request.
+   * @param {object} options - options object.
+   * @param {object} options.body - JSONifable object or undefined.
+   * @param {string} options.method - HTTP method.
+   * @param {string} optoins.operationId - Swagger/OpenAPI operation ID.
+   * @param {object} options.parameters - named query parameters.
+   * @param {object} options.qs - named query parameters (legacy).
+   * @param {string} options.pathname - URL pathname.
+   * @param {boolean} options.stream - true if called by a "stream method".
+   */
+  http (options) {
+    const parameters = Object.assign(
+      {},
+      options.body,
+      options.qs || options.parameters,
+      options.pathnameParameters
+    )
+
+    return this.client.execute({
+      operationId: options.operationId,
+      parameters
+    })
+  }
+}
+
+module.exports = SwaggerClient

package.json

@@ -28,6 +28,7 @@
     "mocha": "^5.2.0",
     "nock": "^10.0.4",
     "node-fetch": "^2.3.0",
+    "sinon": "^7.2.2",
     "standard": "^12.0.1",
     "standard-version": "^4.4.0"
   },