postman-runtime 7.28.3 → 7.29.1

package/lib/runner/run.js

@@ -9,8 +9,8 @@ var _ = require('lodash'),
  * The run object is the primary way to interact with a run in progress. It allows controlling the run (pausing,
  * starting, etc) and holds references to the helpers, such as requesters and authorizer.
  *
- * @param state
- * @param options
+ * @param {Object} state -
+ * @param {Object} options -
  *
  * @property {Requester} requester
  * @constructor
@@ -47,22 +47,20 @@ Run = function PostmanCollectionRun (state, options) { // eslint-disable-line fu
 _.assign(Run.prototype, {
     // eslint-disable-next-line jsdoc/check-param-names
     /**
-     * @param {String} action
-     * @param {Object} [payload]
-     * @param {*} [args...]
+     * @param {String} action -
+     * @param {Object} [payload] -
      */
-    queue: function (action, payload) {
+    queue (action, payload) {
         // extract the arguments that are to be forwarded to the processor
         return this._schedule(action, payload, _.slice(arguments, 2), false);
     },
 
     // eslint-disable-next-line jsdoc/check-param-names
     /**
-     * @param {String} action
-     * @param {Object} [payload]
-     * @param {*} [args...]
+     * @param {String} action -
+     * @param {Object} [payload] -
      */
-    interrupt: function (action, payload) {
+    interrupt (action, payload) {
         // extract the arguments that are to be forwarded to the processor
         return this._schedule(action, payload, _.slice(arguments, 2), true);
     },
@@ -75,11 +73,10 @@ _.assign(Run.prototype, {
      * without terminating the instruction queue. However, it is up to the caller to make sure errors are handled,
      * or it will go unhandled.
      *
-     * @param {String} action
-     * @param {Object} payload
-     * @param {*} [args...]
+     * @param {String} action -
+     * @param {Object} payload -
      */
-    immediate: function (action, payload) {
+    immediate (action, payload) {
         var scope = this,
             instruction = this.pool.create(action, payload, _.slice(arguments, 2));
 
@@ -94,9 +91,9 @@ _.assign(Run.prototype, {
     },
 
     /**
-     * @param {Function|Object} callback
+     * @param {Function|Object} callback -
      */
-    start: function (callback) {
+    start (callback) {
         // @todo add `when` parameter to backpack.normalise
         callback = backpack.normalise(callback, Object.keys(Run.triggers));
 
@@ -128,10 +125,10 @@ _.assign(Run.prototype, {
 
     /**
      * @private
-     * @param {Object|Cursor} cursor
+     * @param {Object|Cursor} cursor -
      * @return {Item}
      */
-    resolveCursor: function (cursor) {
+    resolveCursor (cursor) {
         if (!cursor || !Array.isArray(this.state.items)) { return; }
 
         return this.state.items[cursor.position];
@@ -140,12 +137,12 @@ _.assign(Run.prototype, {
     /**
      * @private
      *
-     * @param {String} action
-     * @param {Object} [payload]
-     * @param {Array} [args]
-     * @param {Boolean} [immediate]
+     * @param {String} action -
+     * @param {Object} [payload] -
+     * @param {Array} [args] -
+     * @param {Boolean} [immediate] -
      */
-    _schedule: function (action, payload, args, immediate) {
+    _schedule (action, payload, args, immediate) {
         var instruction = this.pool.create(action, payload, args);
 
         // based on whether the immediate flag is set, add to the top or bottom of the instruction queue.
@@ -154,7 +151,7 @@ _.assign(Run.prototype, {
         return instruction;
     },
 
-    _process: function (callback) {
+    _process (callback) {
         // extract the command from the queue
         var instruction = this.pool.shift();
 
@@ -183,6 +180,7 @@ _.assign(Run, {
 
     /**
      * stores all execution commands
+     *
      * @enum {Function}
      *
      * @note commands are loaded by flattening the modules in the `./commands` directory
@@ -191,6 +189,7 @@ _.assign(Run, {
 
     /**
      * Functions executed with commands on start
+     *
      * @type {Array}
      */
     initialisers: []
@@ -207,27 +206,33 @@ Run.commands = _.transform({
     'delay.command': require('./extensions/delay.command')
 }, function (all, extension) {
     // extract the prototype from the command interface
-    _.has(extension, 'prototype') && _.forOwn(extension.prototype, function (value, prop) {
-        if (Run.prototype.hasOwnProperty(prop)) {
-            throw new Error('run: duplicate command prototype extension ' + prop);
-        }
-        Run.prototype[prop] = value;
-    });
+    if (_.has(extension, 'prototype')) {
+        _.forOwn(extension.prototype, function (value, prop) {
+            if (Object.hasOwnProperty.call(Run.prototype, prop)) {
+                throw new Error('run: duplicate command prototype extension ' + prop);
+            }
+            Run.prototype[prop] = value;
+        });
+    }
 
     // put the triggers in a box
-    _.has(extension, 'triggers') && _.isArray(extension.triggers) && _.forEach(extension.triggers, function (name) {
-        name && (Run.triggers[name] = true);
-    });
+    if (_.has(extension, 'triggers') && _.isArray(extension.triggers)) {
+        _.forEach(extension.triggers, function (name) {
+            name && (Run.triggers[name] = true);
+        });
+    }
 
     // we add the processors to the processor list
-    _.has(extension, 'process') && _.forOwn(extension.process, function (command, name) {
-        if (!_.isFunction(command)) { return; }
-        if (all.hasOwnProperty(name)) {
-            throw new Error('run: duplicate command processor ' + name);
-        }
-        // finally add the command function to the accumulator
-        all[name] = command;
-    });
+    if (_.has(extension, 'process')) {
+        _.forOwn(extension.process, function (command, name) {
+            if (!_.isFunction(command)) { return; }
+            if (Object.hasOwnProperty.call(all, name)) {
+                throw new Error('run: duplicate command processor ' + name);
+            }
+            // finally add the command function to the accumulator
+            all[name] = command;
+        });
+    }
 
     // add the initialisation functions
     _.has(extension, 'init') && _.isFunction(extension.init) && Run.initialisers.push(extension.init);

package/lib/runner/timings.js

@@ -1,6 +1,7 @@
 /**
  * All timing related functions within the runner is maintained in this module. Things like recording time with label,
  * computing elapsed time between two labels, etc all go in here.
+ *
  * @module Run~Timer
  */
 var /**
@@ -18,6 +19,7 @@ var /**
  * @param {Object.<Number>} records create the timer instance with one or more labels and their timestamp.
  */
 Timings = function Timings (records) {
+    // eslint-disable-next-line guard-for-in
     for (var prop in records) {
         this[prop] = parseInt(records[prop], 10);
     }
@@ -26,7 +28,7 @@ Timings = function Timings (records) {
 /**
  * Create a new instance of timer. Equivalent to doing new {@link Timer}(records:Object.<Number>);
  *
- * @param {Object.<Number>} records
+ * @param {Object.<Number>} records -
  * @returns {Timings}
  */
 Timings.create = function (records) {
@@ -36,7 +38,7 @@ Timings.create = function (records) {
 /**
  * Record the current time with the label specified.
  *
- * @param {String} label
+ * @param {String} label -
  * @returns {Number}
  *
  * @example
@@ -60,7 +62,9 @@ Timings.prototype.toObject = function () {
         prop;
 
     for (prop in this) {
-        (typeof this[prop] === NUMBER) && (obj[prop] = this[prop]);
+        if (typeof this[prop] === NUMBER) {
+            obj[prop] = this[prop];
+        }
     }
 
     return obj;

package/lib/runner/util.js

@@ -71,6 +71,7 @@ createReadStream = function (resolver, fileSrc, callback) {
 
 /**
  * Utility functions that are required to be re-used throughout the runner
+ *
  * @module Runner~util
  * @private
  *
@@ -83,13 +84,13 @@ module.exports = {
      * The first parameter is the function itself, followed by the scope in which this function is to be executed.
      * The third parameter onwards are blindly forwarded to the function being called
      *
-     * @param {Function} fn
-     * @param {*} ctx
+     * @param {Function} fn -
+     * @param {*} ctx -
      *
      * @returns {Error} If there was an error executing the function, the error is returned.
      * Note that if the function called here is asynchronous, it's errors will not be returned (for obvious reasons!)
      */
-    safeCall: function (fn, ctx) {
+    safeCall (fn, ctx) {
         // extract the arguments that are to be forwarded to the function to be called
         var args = Array.prototype.slice.call(arguments, 2);
 
@@ -104,24 +105,24 @@ module.exports = {
     /**
      * Copies attributes from source object to destination object.
      *
-     * @param dest
-     * @param src
+     * @param {Object} dest -
+     * @param {Object} src -
      *
      * @return {Object}
      */
-    syncObject: function (dest, src) {
+    syncObject (dest, src) {
         var prop;
 
         // update or add values from src
         for (prop in src) {
-            if (src.hasOwnProperty(prop)) {
+            if (Object.hasOwnProperty.call(src, prop)) {
                 dest[prop] = src[prop];
             }
         }
 
         // remove values that no longer exist
         for (prop in dest) {
-            if (dest.hasOwnProperty(prop) && !src.hasOwnProperty(prop)) {
+            if (Object.hasOwnProperty.call(dest, prop) && !Object.hasOwnProperty.call(src, prop)) {
                 delete dest[prop];
             }
         }
@@ -141,7 +142,7 @@ module.exports = {
      * @param {Function} callback -
      *
      */
-    createReadStream: function (resolver, fileSrc, callback) {
+    createReadStream (resolver, fileSrc, callback) {
         // bail out if resolver not found.
         if (!resolver) {
             return callback(new Error('file resolver not supported'));

package/lib/version.js

@@ -12,8 +12,8 @@ var _ = require('lodash'),
         'postman-collection': true,
         'postman-request': true,
         'postman-sandbox': true,
-        'uniscope': true,
-        'uvm': true
+        uniscope: true,
+        uvm: true
     },
 
     /**

package/lib/visualizer/index.js

@@ -9,7 +9,7 @@ module.exports = {
      * @param {Object} options - options for processing the template
      * @param {Function} callback - callback called with errors and processed template
      */
-    processTemplate: function (template, userData, options, callback) {
+    processTemplate (template, userData, options, callback) {
         // bail out if there is no valid template to process
         if (typeof template !== 'string') {
             return callback(new Error(`Invalid template. Template must be of type string, found ${typeof template}`));

package/package.json

@@ -1,102 +1,98 @@
 {
   "name": "postman-runtime",
-  "version": "7.28.3",
-  "description": "Underlying library of executing Postman Collections (used by Newman)",
+  "version": "7.29.1",
+  "description": "Underlying library of executing Postman Collections",
+  "author": "Postman Inc.",
+  "license": "Apache-2.0",
   "main": "index.js",
-  "directories": {
-    "lib": "lib",
-    "test": "test"
+  "browser": {
+    "./lib/requester/request-wrapper.js": "./lib/requester/browser/request.js",
+    "postman-request": "./lib/requester/browser/request.js"
   },
+  "homepage": "https://github.com/postmanlabs/postman-runtime#readme",
+  "bugs": {
+    "email": "help@postman.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/postmanlabs/postman-runtime.git"
+  },
+  "keywords": [
+    "postman",
+    "collection",
+    "runtime",
+    "runner"
+  ],
   "scripts": {
     "codecov": "node npm/publish-coverage.js",
+    "dist": "node npm/dist.js",
+    "memory-check": "npm/memory-check.sh",
+    "prepack": "npm run dist",
+    "release": "node npm/create-release.js",
     "test": "npm run test-lint && npm run test-system && npm run test-unit && npm run test-integration && npm run test-integration-legacy",
-    "test-system": "node npm/test-system.js",
-    "test-lint": "node npm/test-lint.js",
-    "test-unit": "node npm/test-unit.js",
     "test-browser": "node npm/test-browser.js",
     "test-electron": "node npm/test-electron.js",
-    "test-integration": "node npm/test-integration.js",
-    "test-integration-legacy": "node npm/test-integration-legacy.js",
+    "test-integration": "nyc --nycrc-path=.nycrc.js node npm/test-integration.js",
+    "test-integration-legacy": "nyc --nycrc-path=.nycrc.js node npm/test-integration-legacy.js",
     "test-integration-newman": "node npm/test-integration-newman.js",
-    "test-coverage": "node npm/test-coverage.js",
-    "build-docs": "node npm/build-docs.js",
-    "build-wiki": "node npm/build-wiki.js",
-    "publish-docs": "node npm/publish-docs.js",
-    "publish-wiki": "node npm/build-wiki.js",
-    "memory-check": "npm/memory-check.sh",
-    "release": "node npm/create-release.js",
-    "dist": "node npm/dist.js",
-    "prepack": "npm run dist"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+ssh://git@github.com:postmanlabs/postman-runtime.git"
+    "test-lint": "node npm/test-lint.js",
+    "test-system": "node npm/test-system.js",
+    "test-unit": "nyc --nycrc-path=.nycrc.js node npm/test-unit.js"
   },
-  "author": "Postman Labs <help@getpostman.com>",
-  "license": "Apache-2.0",
   "dependencies": {
-    "async": "2.6.3",
+    "async": "3.2.3",
     "aws4": "1.11.0",
-    "eventemitter3": "4.0.7",
     "handlebars": "4.7.7",
-    "http-reasons": "0.1.0",
     "httpntlm": "1.7.7",
-    "inherits": "2.0.4",
     "js-sha512": "0.8.0",
     "lodash": "4.17.21",
+    "mime-types": "2.1.35",
     "node-oauth1": "1.3.0",
     "performance-now": "2.1.0",
-    "postman-collection": "4.0.1",
-    "postman-request": "2.88.1-postman.30",
-    "postman-sandbox": "4.0.3",
-    "postman-url-encoder": "3.0.3",
-    "resolve-from": "5.0.0",
+    "postman-collection": "4.1.3",
+    "postman-request": "2.88.1-postman.31",
+    "postman-sandbox": "4.0.7",
+    "postman-url-encoder": "3.0.5",
     "serialised-error": "1.1.3",
     "tough-cookie": "3.0.1",
-    "uuid": "3.4.0"
+    "uuid": "8.3.2"
   },
   "devDependencies": {
-    "@postman/shipit": "0.3.0",
-    "ajv": "6.12.6",
-    "browserify": "16.5.2",
-    "chai": "4.3.4",
-    "colors": "1.4.0",
-    "editorconfig": "0.15.3",
-    "eslint": "5.16.0",
-    "eslint-plugin-jsdoc": "8.7.0",
-    "eslint-plugin-lodash": "7.2.0",
-    "eslint-plugin-mocha": "6.3.0",
-    "eslint-plugin-security": "1.4.0",
-    "express": "4.17.1",
-    "graphql": "15.5.1",
-    "js-yaml": "4.1.0",
-    "jsdoc": "3.6.7",
-    "jsdoc-to-markdown": "7.0.1",
-    "karma": "3.1.4",
-    "karma-browserify": "6.1.0",
-    "karma-chrome-launcher": "3.1.0",
-    "karma-mocha": "2.0.1",
-    "karma-mocha-reporter": "2.2.5",
-    "mocha": "7.2.0",
-    "nyc": "14.1.1",
-    "parse-gitignore": "0.5.1",
-    "passport": "0.4.1",
-    "passport-http": "0.3.0",
-    "postman-jsdoc-theme": "0.0.3",
-    "recursive-readdir": "2.2.2",
-    "server-destroy": "1.0.1",
-    "shelljs": "0.8.4",
-    "sinon": "8.1.1",
-    "teleport-javascript": "1.0.0",
-    "terser": "5.7.1",
-    "tmp": "0.2.1",
-    "yankee": "1.0.8"
-  },
-  "browser": {
-    "./lib/requester/request-wrapper.js": "./lib/requester/browser/request.js",
-    "postman-request": "./lib/requester/browser/request.js"
+    "@postman/shipit": "^0.4.0",
+    "ajv": "^8.11.0",
+    "browserify": "^17.0.0",
+    "chai": "^4.3.6",
+    "chalk": "^4.1.2",
+    "dependency-check": "^4.1.0",
+    "editorconfig": "^0.15.3",
+    "eslint": "^7.32.0",
+    "eslint-plugin-jsdoc": "^36.1.1",
+    "eslint-plugin-lodash": "^7.4.0",
+    "eslint-plugin-mocha": "^10.0.4",
+    "eslint-plugin-security": "^1.5.0",
+    "express": "^4.17.2",
+    "graphql": "^15.7.2",
+    "js-yaml": "^4.1.0",
+    "karma": "^6.3.20",
+    "karma-browserify": "^8.1.0",
+    "karma-chrome-launcher": "^3.1.1",
+    "karma-mocha": "^2.0.1",
+    "karma-mocha-reporter": "^2.2.5",
+    "mocha": "^9.1.3",
+    "nyc": "^15.1.0",
+    "parse-gitignore": "^1.0.1",
+    "passport": "^0.6.0",
+    "passport-http": "^0.3.0",
+    "recursive-readdir": "^2.2.2",
+    "server-destroy": "^1.0.1",
+    "shelljs": "^0.8.5",
+    "sinon": "^12.0.1",
+    "teleport-javascript": "^1.0.0",
+    "terser": "^5.13.1",
+    "tmp": "^0.2.1",
+    "yankee": "^1.0.8"
   },
   "engines": {
-    "node": ">=8"
+    "node": ">=10"
   }
 }