Merge branch 'develop' into fix/inputValidationNull

Author: LuisTejedaS

.npmignore

@@ -43,4 +43,16 @@ test/data/.temp
 
 # Prevent unit test coverage reports from being added
 .coverage
-.nyc_output
+.nyc_output
+
+# - Prevent config and test files from being added
+.git*
+.github/
+scripts/
+test/
+examples/
+.eslintrc
+.eslintignore
+.nycrc
+.editorconfig
+.jsdoc-config.json

CHANGELOG.md

@@ -1,5 +1,10 @@
 # OpenAPI-Postman Changelog
 
+#### v4.0.0 (July 12, 2022)
+* Added support for new multi-file API detectRootFiles() for OpenAPI 3 and Swagger 2 formats to support detection of root files among multiple files.
+* Added support for new multi-file API detectRelatedFiles() for OpenAPI 3 and Swagger 2 formats to support detection of related files for a provided root file amongst multiple files.
+* Added support for new multi-file API bundle() for OpenAPI 3 and Swagger 2 formats to support bundling of root files from provided multiple files.
+
 #### v3.2.0 (May 02, 2022)
 * Fixed some of critical and high level severity vulnerabilities.
 * Fixed issue [#10752](https://github.com/postmanlabs/postman-app-support/issues/10752) where deepObject style parameters were not generated correctly.

OPTIONS.md

@@ -22,3 +22,4 @@ allowUrlPathVarMatching|boolean|-|false|Whether to allow matching path variables
 disableOptionalParameters|boolean|-|false|Whether to set optional parameters as disabled|CONVERSION
 keepImplicitHeaders|boolean|-|false|Whether to keep implicit headers from the OpenAPI specification, which are removed by default.|CONVERSION
 includeWebhooks|boolean|-|false|Select whether to include Webhooks in the generated collection|CONVERSION
+includeReferenceMap|boolean|-|false|Whether or not to include reference map or not as part of output|BUNDLE

assets/json-schema-faker.js

@@ -23782,7 +23782,7 @@ function extend() {
                   var min = Math.max(params.minimum || 0, 0);
                   var max = Math.min(params.maximum || Infinity, Infinity);
                   min = handleExclusiveMinimum(schema, min);
-                  max = handleExclusiveMaximum(schema, min);
+                  max = handleExclusiveMaximum(schema, max);
                   // discard out-of-bounds enumerations
                   schema.enum = schema.enum.filter(function (x) {
                       if (x >= min && x <= max) {

index.js

@@ -1,6 +1,7 @@
 'use strict';
 
-const SchemaPack = require('./lib/schemapack.js').SchemaPack;
+const _ = require('lodash'),
+  SchemaPack = require('./lib/schemapack.js').SchemaPack;
 
 module.exports = {
   // Old API wrapping the new API
@@ -32,6 +33,21 @@ module.exports = {
     return SchemaPack.getOptions(mode, criteria);
   },
 
+  detectRootFiles: async function(input) {
+    var schema = new SchemaPack(input);
+    return schema.detectRootFiles();
+  },
+
+  detectRelatedFiles: async function(input) {
+    var schema = new SchemaPack(input);
+    return schema.detectRelatedFiles();
+  },
+
+  bundle: async function(input) {
+    var schema = new SchemaPack(input, _.has(input, 'options') ? input.options : {});
+    return schema.bundle();
+  },
+
   // new API
   SchemaPack
 };

lib/30XUtils/inputValidation.js

@@ -8,7 +8,12 @@ module.exports = {
    * @return {Object} Validation result
    */
   validateSpec: function (spec) {
-
+    if (_.isNil(spec)) {
+      return {
+        result: false,
+        reason: 'The Specification is null or undefined'
+      };
+    }
     // Checking for the all the required properties in the specification
     if (_.isNil(spec.openapi)) {
       return {

lib/30XUtils/schemaUtils30X.js

@@ -9,11 +9,12 @@ module.exports = {
   /**
      * Parses an OAS string/object as a YAML or JSON
      * @param {YAML/JSON} openApiSpec - The OAS 3.x specification specified in either YAML or JSON
+     * @param {object} options - The parsing options
      * @returns {Object} - Contains the parsed JSON-version of the OAS spec, or an error
      * @no-unit-test
      */
-  parseSpec: function (openApiSpec) {
-    return schemaUtilsCommon.parseSpec(openApiSpec, inputValidation30X);
+  parseSpec: function (openApiSpec, options) {
+    return schemaUtilsCommon.parseSpec(openApiSpec, inputValidation30X, options);
   },
 
   /**

lib/31XUtils/inputValidation31X.js

@@ -11,6 +11,12 @@ module.exports = {
    */
   validateSpec: function (spec, options) {
     const includeWebhooksOption = options.includeWebhooks;
+    if (_.isNil(spec)) {
+      return {
+        result: false,
+        reason: 'The Specification is null or undefined'
+      };
+    }
     if (_.isNil(spec.openapi)) {
       return {
         result: false,