feat(swagger): add support for passed in serialized swagger.yaml

Author: wyvern8

API.md

@@ -21,7 +21,7 @@
 **Kind**: global class  
 <a name="LaunchDarklyApiClient.create"></a>
 
-### LaunchDarklyApiClient.create(API_TOKEN, log) ⇒ <code>Promise</code>
+### LaunchDarklyApiClient.create(API_TOKEN, log, swaggerYamlString) ⇒ <code>Promise</code>
 Used internally by LaunchDarklyUtils to create an instance of
 Swagger apiClient with interceptors configured
 
@@ -33,6 +33,7 @@ Swagger apiClient with interceptors configured
 | --- | --- | --- |
 | API_TOKEN | <code>string</code> | from LaunchDarkly dashboard |
 | log | <code>Object</code> | logger implementation |
+| swaggerYamlString | <code>string</code> | optional serialized yaml |
 
 <a name="LaunchDarklyLogger"></a>
 
@@ -50,7 +51,7 @@ Get handle on Bunyan logger.  This is the default logger if not supplied to util
 **Kind**: global class  
 <a name="LaunchDarklyUtils+create"></a>
 
-### launchDarklyUtils.create(API_TOKEN, customLogger) ⇒ <code>Promise</code>
+### launchDarklyUtils.create(API_TOKEN, customLogger, swaggerYamlString) ⇒ <code>Promise</code>
 Create an instance of ldutils with api specific classes attached. This is the primary class used to access apis,
 as api grouping util classes are attached to this class.
 
@@ -62,6 +63,7 @@ as api grouping util classes are attached to this class.
 | --- | --- | --- |
 | API_TOKEN | <code>string</code> | from LaunchDarkly dashboard |
 | customLogger | <code>Object</code> | logger implementation, or 'console'. If not supplied, defaults to Bunyan logger |
+| swaggerYamlString | <code>string</code> | optional serialized yaml |
 
 <a name="LaunchDarklyUtilsFlags"></a>
 

src/LaunchDarklyApiClient.js

@@ -12,15 +12,16 @@ export class LaunchDarklyApiClient {
      * Swagger apiClient with interceptors configured
      * @param {string} API_TOKEN - from LaunchDarkly dashboard
      * @param { Object } log - logger implementation
+     * @param { string } swaggerYamlString - optional serialized yaml
      * @returns {Promise}
      * @fulfil {Swagger} apiClient generated by swagger-js
      * @reject {Error} object with message
      */
-    static async create(API_TOKEN, log) {
+    static async create(API_TOKEN, log, swaggerYamlString) {
         log.debug(`creating api client with token: ${API_TOKEN}`);
 
         // swagger.yaml from https://launchdarkly.github.io/ld-openapi/swagger.yaml
-        const swaggerYaml = fs.readFileSync(__dirname + `/../swagger.yaml`, 'utf-8').toString();
+        const swaggerYaml = swaggerYamlString || fs.readFileSync(__dirname + `/../swagger.yaml`, 'utf-8').toString();
         const swaggerJson = jsYaml.safeLoad(swaggerYaml);
 
         return Swagger({

src/LaunchDarklyUtils.js

@@ -15,11 +15,12 @@ export class LaunchDarklyUtils {
      * as api grouping util classes are attached to this class.
      * @param {string} API_TOKEN - from LaunchDarkly dashboard
      * @param { Object } customLogger - logger implementation, or 'console'. If not supplied, defaults to Bunyan logger
+     * @param { string } swaggerYamlString - optional serialized yaml
      * @returns {Promise}
      * @fulfil {LaunchDarklyUtils}
      * @reject {Error} object with message
      */
-    async create(API_TOKEN, customLogger) {
+    async create(API_TOKEN, customLogger, swaggerYamlString) {
         let that = this;
         return new Promise(async (resolve, reject) => {
             // setup logger
@@ -28,7 +29,7 @@ export class LaunchDarklyUtils {
 
             // create LaunchDarkly apiClient
             try {
-                that.apiClient = await LaunchDarklyApiClient.create(API_TOKEN, this.log);
+                that.apiClient = await LaunchDarklyApiClient.create(API_TOKEN, this.log, swaggerYamlString);
                 that.log.debug('api client instantiated..');
 
                 // attach utils