@pact-foundation/pact 10.0.0-beta.9 → 10.0.0

package/RELEASING.md

@@ -1,84 +1,88 @@
 # Releasing
 
-## Publishing via Travis (recommended)
+We've moved to GitHub Actions for releases.
 
-- Update the version number in each `package.json` file to latest version
-- Commit
+## How a release works
 
-        $ npm run release
-        $ # review workspace and commits - if all looks good...
-        $ git push --follow-tags
+Releases trigger when the repository recieves the custom repository_dispatch event
+`release-triggered`.
 
-Travis CI will do the rest.
+This triggers the `publish.yml` workflow, which in turn
+triggers the `release.sh` script in `scripts/ci`.
+The workflow will also create a github release with an appropriate changelog.
 
-## How to re-tag if a publish fails
+Having the release triggered by a custom event is useful for automating
+releases in the future (eg for version bumps in pact dependencies).
 
-Delete broken tag:
+### Release.sh
 
-    $ git tag -d "X.Y.Z" && git push origin :refs/tags/X.Y.Z
+This script is not intended to be run locally. Note that it modifies your git
+settings.
 
-Now you can re-tag and push as above.
+The script will:
 
-## Publishing manually
+- Modify git authorship settings
+- Confirm that there would be changes in the changelog after release
+- Run Lint
+- Run Build
+- Run Test
+- Commit an appropriate version bump, changelog and tag
+- Package and publish to npm
+- Push the new commit and tag back to the main branch.
 
-Log in to npm as pact-foundation.
+Should you need to modify the script locally, you will find it uses some
+dependencies in `scripts/ci/lib`.
 
-Run the following commands:
+## Kicking off a release
 
-    $ npm run dist
-    $ npm run coverage
-    $ npm prune --production
-    $ tar -czvf pactjs.tar.gz config dist src package.json README.md LICENSE
-    $ npm run deploy:prepare
-    $ script: npm publish dist --access public
+You must be able to create a github access token with `repo` scope to the
+pact-js repository.
 
-This should have published the latest version, check to see that at npmjs.com/package/pact.
-We now need to create a GitHub release, upload zipped distribution (pactjs.tar.gz) to [GitHub Releases](https://github.com/pact-foundation/pact-js/releases).
+- Set an environment variable `GITHUB_ACCESS_TOKEN_FOR_PF_RELEASES` to this token.
+- Make sure master contains the code you want to release
+- Run `scripts/trigger-release.sh`
 
-## Updating NPM key
+Then wait for github to do its magic. It will release the current head of master.
 
-Log in to pact-foundation npm account in a browser and revoke the old key in the Tokens section.
-Delete the env.global.secure key from travis.yml
-Log in to npm via command line using the pact-foundation account.
-Echo the ~/.npmrc file and grab the token out of it.
+Note that the release script refuses to publish anything that wouldn't
+produce a changelog. Please make sure your commits follow the guidelines in
+`CONTRIBUTING.md`
 
-    $ gem install travis
-    $ travis encrypt NPM_KEY=${NPM_KEY} --add env.global
+## If the release fails
 
-## v3.0.0
+The publish is the second to last step, so if the release fails, you don't
+need to do any rollbacks.
 
-The native binaries required for post-install are trigerred [Github Actions](https://github.com/pact-foundation/pact-js/actions) on successful travis builds.
+However, there is a potential for the push to fail _after_ a publish if there
+are new commits to master since the release started. This is unlikely with
+the current commit frequency, but could still happen. Check the logs to
+determine if npm has a version that doesn't exist in the master branch.
 
-Occasionally, you may need to generate these binaries manually. You can do so by running the command as follows (be careful to substitute branches/tagse etc.):
+If this has happened, you will need to manually put the release commit in.
 
-To produce a darwin build, run from a Mac:
-
-```
-export NODE_PRE_GYP_GITHUB_TOKEN=<your github access token>
-npm install node-pre-gyp node-pre-gyp-github
-npm run build:v3
-rm -rf native/target
-npm run upload-binary
 ```
+# First delete the new tag
+#   somehow this ends up in the repository
+#   even though the push fails.
 
-For linux64 (update version of node you need to release from in the docker image name). Please run the steps by hand:
+git checkout master
+git pull --tags
+git tag -d <broken-version>
+git push -delete origin <broken-version>
+
+
+# If there are changes that introduce features, then you'll have to branch and probably rebase
+
+# Now create a new commit + tag for the version:
+npm run release
+
+# Push that tag + commit
+git push origin master --follow-tags
 
 ```
-docker run --rm -it -v $(pwd):/app node:latest bash
-apt-get update -y
-curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
-curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | \
-    sh -s -- -y
-#
-# choose 1 to progress
-#
-source $HOME/.cargo/env
-export NODE_PRE_GYP_GITHUB_TOKEN=<your github access token>
-cd /app
-rm -rf node_modules build
-npm ci
-npm install node-pre-gyp node-pre-gyp-github
-npm run build:v3
-rm -rf native/target
-npm run upload-binary
-```
+
+- Don't forget to create a new release in github.
+
+Depending on the nature of the new commits to master after the release, you
+may need to rebase them on top of the tagged release commit and force push (only do this
+if the released version would be different to the version tagged by `npm run release`)

package/package.json

@@ -1,54 +1,30 @@
 {
   "name": "@pact-foundation/pact",
-  "version": "10.0.0-beta.9",
+  "version": "10.0.0",
   "description": "Pact for all things Javascript",
-  "main": "./pact.js",
-  "types": "./pact.d.ts",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
   "scripts": {
-    "build": "npm run build:v2 && npm run build:v3",
-    "build:v2": "npm run lint && npm run compile",
-    "build:v3": "neon build --release",
     "compile": "rimraf dist && tsc",
-    "clean": "rimraf docs dist dist-web coverage .nyc_output logs pacts jscpd.json",
-    "clean:native": "rm -rf native/target",
-    "coverage": "nyc report --reporter=text-lcov | coveralls",
-    "deploy:package": "tar -czf pactjs.tar.gz config dist src package.json README.md LICENSE",
-    "deploy:prepare": "npm i --production && npm run deploy:package && ./scripts/create_npmrc_file.sh",
-    "dist": "npm run compile && webpack --config ./config/webpack.web.config.js && cp package.json ./dist",
-    "jscpd": "jscpd -p src -r json -o jscpd.json",
-    "lint": "npm run lint:prettier:ts && npm run lint:prettier:js",
-    "lint:fix": "prettier --parser typescript --write \"{src,test,examples}/**/*.ts\" && prettier --write \"{src,test,examples}/**/*.js\"",
-    "lint:prettier:ts": "prettier --parser typescript --check \"{src,test,examples}/**/*.ts\"",
-    "lint:prettier:js": "prettier --check \"{src,test,examples}/**/*.js\"",
-    "postdist": "npm t",
-    "predist": "npm run clean && npm run lint && npm run jscpd",
-    "release": "standard-version -p beta",
-    "test": "nyc --check-coverage --reporter=html --reporter=text-summary mocha",
-    "test:examples": "npm run test:e2e-examples && npm run test:jest-examples && npm run test:mocha-examples && npm run test:ava-examples && npm run test:ts-examples && npm run test:message-examples && npm run test:serverless-examples && npm run test:graphql-examples",
-    "test:e2e-examples": "cd examples/e2e && npm it",
-    "test:ava-examples": "cd examples/ava && npm it",
-    "test:jest-examples": "cd examples/jest && npm it",
-    "test:mocha-examples": "cd examples/mocha && npm it",
-    "test:ts-examples": "cd examples/typescript && npm it",
-    "test:message-examples": "cd examples/messages && npm it",
-    "test:serverless-examples": "cd examples/serverless && npm it",
-    "test:graphql-examples": "cd examples/graphql && npm it",
-    "test:karma": "npm run test:karma:jasmine && npm run test:karma:mocha",
-    "test:karma:jasmine": "cd examples/karma && npm i && npm run test:jasmine",
-    "test:karma:mocha": "cd examples/karma && npm i && npm run test:mocha",
-    "travis": "./scripts/build.sh",
-    "appveyor": "./scripts/build.ps1",
-    "webpack": "webpack --config ./config/webpack.web.config.js",
-    "install": "node-pre-gyp install --fallback-to-build=false || neon build --release",
-    "package": "node-pre-gyp package",
-    "upload-binary": "npm run package && node-pre-gyp-github publish"
+    "clean": "rimraf docs dist coverage .nyc_output logs pacts",
+    "coverage": "nyc report --reporter=lcov",
+    "dist": "tsc && copyfiles package.json ./dist",
+    "lint": "eslint --config .eslintrc.json \"{src,test}/**/*.ts\"",
+    "lint:fix": "npm run lint -- --fix",
+    "format:base": "prettier \"{src,test,examples}/**/*.{ts,js}\"",
+    "format:fix": "npm run format:base -- --write",
+    "format:check": "npm run format:base -- --check",
+    "postdist": "npm test",
+    "predist": "npm run clean && npm run format:check && npm run lint",
+    "release": "standard-version -f",
+    "test": "nyc --check-coverage --reporter=html --reporter=text-summary mocha"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/pact-foundation/pact-js.git"
   },
   "engines": {
-    "node": ">=6"
+    "node": ">=10"
   },
   "keywords": [
     "pact",
@@ -80,100 +56,122 @@
   "bugs": {
     "url": "https://github.com/pact-foundation/pact-js/issues"
   },
-  "homepage": "http://docs.pact.io/documentation/javascript.html",
+  "homepage": "https://docs.pact.io/implementation_guides/javascript/",
+  "standard-version": {
+    "types": [
+      {
+        "type": "feat",
+        "section": "Features"
+      },
+      {
+        "type": "fix",
+        "section": "Fixes and Improvements"
+      },
+      {
+        "type": "chore",
+        "hidden": true
+      },
+      {
+        "type": "docs",
+        "hidden": true
+      },
+      {
+        "type": "style",
+        "hidden": true
+      },
+      {
+        "type": "refactor",
+        "hidden": true
+      },
+      {
+        "type": "perf",
+        "hidden": true
+      },
+      {
+        "type": "test",
+        "hidden": true
+      }
+    ]
+  },
   "dependencies": {
-    "@pact-foundation/pact-node": "^10.9.0",
+    "@pact-foundation/pact-core": "^13.6.2",
     "@types/bluebird": "^3.5.20",
-    "@types/bunyan": "^1.8.3",
-    "@types/express": "^4.11.1",
-    "@types/ramda": "^0.26.43",
+    "@types/express": "^4.17.11",
+    "axios": "^0.27.2",
     "bluebird": "~3.5.1",
-    "body-parser": "^1.18.2",
-    "bunyan": "^1.8.12",
-    "bunyan-prettystream": "^0.1.3",
-    "cli-color": "^1.1.0",
-    "es6-object-assign": "^1.1.0",
-    "es6-promise": "^4.1.1",
-    "express": "^4.16.3",
+    "body-parser": "^1.20.0",
+    "cli-color": "^2.0.1",
+    "express": "^4.18.1",
     "graphql": "^14.0.0",
     "graphql-tag": "^2.9.1",
     "http-proxy": "^1.18.1",
-    "http-proxy-middleware": "^0.19.0",
-    "lodash": "^4.17.14",
+    "js-base64": "^3.6.1",
+    "lodash": "^4.17.21",
     "lodash.isfunction": "3.0.8",
     "lodash.isnil": "4.0.0",
     "lodash.isundefined": "3.0.1",
     "lodash.omit": "^4.5.0",
     "lodash.omitby": "4.6.0",
-    "node-pre-gyp": "^0.13.0",
-    "node-pre-gyp-github": "^1.4.3",
+    "pino-pretty": "^6.0.0",
     "pkginfo": "^0.4.1",
-    "popsicle": "^9.2.0",
-    "ramda": "^0.26.1"
+    "ramda": "^0.27.2",
+    "randexp": "^0.5.3"
   },
   "devDependencies": {
-    "@babel/cli": "~7.6.0",
-    "@babel/core": "^7.6.4",
-    "@babel/preset-env": "^7.6.3",
-    "@types/chai": "^4.0.3",
-    "@types/chai-as-promised": "0.0.31",
+    "@babel/cli": "^7.18.6",
+    "@babel/core": "^7.18.6",
+    "@babel/preset-env": "^7.18.6",
+    "@octokit/rest": "^18.0.3",
+    "@pact-foundation/pact-js-prettier-config": "^1.0.0",
+    "@types/chai": "^4.3.1",
+    "@types/chai-as-promised": "^7.1.1",
     "@types/cli-color": "^0.3.29",
-    "@types/form-data": "^2.2.1",
-    "@types/lodash": "^4.14.73",
-    "@types/lodash.isnil": "^4.0.3",
-    "@types/mocha": "^2.2.41",
+    "@types/http-proxy": "^1.17.9",
+    "@types/lodash": "^4.14.182",
+    "@types/lodash.isnil": "^4.0.7",
+    "@types/mocha": "^8.0.4",
+    "@types/mockery": "^1.4.29",
     "@types/nock": "^9.1.2",
     "@types/node": "^8.0.24",
-    "@types/q": "^1.5.2",
+    "@types/ramda": "^0.26.43",
     "@types/sinon": "^7.0.6",
     "@types/sinon-chai": "^2.7.29",
     "@types/superagent": "^3.5.7",
     "@types/tough-cookie": "^2.3.2",
     "@types/underscore": "^1.8.5",
-    "awesome-typescript-loader": "^5.2.0",
-    "babel-eslint": "~10.0.3",
-    "babel-loader": "^8.0.6",
+    "@typescript-eslint/eslint-plugin": "^5.30.4",
+    "@typescript-eslint/parser": "^5.30.4",
     "chai": "~4.1.2",
     "chai-as-promised": "^7.1.1",
-    "coveralls": "^3.0.2",
+    "copyfiles": "^2.4.1",
     "enhanced-resolve": "^3.4.1",
-    "eslint": "^5.6.1",
-    "eslint-config-prettier": "^5.0.0",
-    "eslint-plugin-prettier": "^3.1.0",
-    "imports-loader": "~0.7.1",
-    "istanbul": "~0.4.5",
+    "eslint": "^8.19.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-import-resolver-typescript": "^3.2.1",
+    "eslint-plugin-chai-friendly": "^0.7.2",
+    "eslint-plugin-import": "^2.26.0",
+    "eslint-plugin-mocha": "^10.0.5",
+    "eslint-plugin-prettier": "^4.2.1",
     "jasmine-core": "~2.9.1",
-    "jscpd": "0.6.22",
-    "json-loader": "~0.5.7",
-    "loader-utils": "^1.1.0",
     "lodash.clone": "^4.5.0",
-    "mocha": "^5.1.1",
+    "mocha": "^9.1.1",
     "mocha-lcov-reporter": "^1.3.0",
-    "neon-cli": "^0.3.3",
+    "mockery": "^2.1.0",
+    "neon-cli": "^0.9.1",
     "nock": "^9.1.6",
-    "nyc": "^15.0.0-beta.0",
-    "prettier": "^1.18.2",
+    "nyc": "^15.1.0",
+    "prettier": "^2.7.1",
     "proxyquire": "^2.0.1",
     "rimraf": "^2.7.1",
+    "sha256-file": "^1.0.0",
     "sinon": "^7.2.4",
     "sinon-chai": "^3.3.0",
-    "source-map-loader": "^0.2.1",
     "source-map-support": "^0.4.18",
-    "standard-version": "^7.1.0",
+    "standard-version": "^9.5.0",
     "superagent": "^3.8.2",
     "ts-mock-imports": "^1.2.6",
     "ts-node": "^3.3.0",
-    "tslint": "^5.11.0",
-    "tslint-config-prettier": "^1.15.0",
-    "typescript": "^3.8.3",
-    "webpack": "^3.5.5"
-  },
-  "binary": {
-    "module_name": "index",
-    "host": "https://github.com/pact-foundation/pact-js/releases/download/",
-    "remote_path": "v{version}",
-    "package_name": "{node_abi}-{platform}-{arch}.tar.gz",
-    "module_path": "./native",
-    "pkg_path": "."
+    "typescript": "^4.7.4"
   }
 }

package/src/common/jsonTypes.d.ts

@@ -0,0 +1,5 @@
+export declare type AnyJson = boolean | number | string | null | JsonArray | JsonMap;
+export interface JsonMap {
+    [key: string]: AnyJson;
+}
+export declare type JsonArray = Array<AnyJson>;

package/src/common/jsonTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=jsonTypes.js.map

package/src/common/jsonTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonTypes.js","sourceRoot":"","sources":["../../../src/common/jsonTypes.ts"],"names":[],"mappings":""}

package/src/common/logger.d.ts

@@ -0,0 +1,10 @@
+export * from '@pact-foundation/pact-core/src/logger';
+declare const _default: {
+    pactCrash: (message: string) => void;
+    error: (message: string) => void;
+    warn: (message: string) => void;
+    info: (message: string) => void;
+    debug: (message: string) => void;
+    trace: (message: string) => void;
+};
+export default _default;

package/src/common/logger.js

@@ -0,0 +1,32 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var logger_1 = __importDefault(require("@pact-foundation/pact-core/src/logger"));
+var package_json_1 = require("../../package.json");
+__exportStar(require("@pact-foundation/pact-core/src/logger"), exports);
+var context = "pact@".concat(package_json_1.version);
+exports.default = {
+    pactCrash: function (message) { return logger_1.default.pactCrash(message, context); },
+    error: function (message) { return logger_1.default.error(message, context); },
+    warn: function (message) { return logger_1.default.warn(message, context); },
+    info: function (message) { return logger_1.default.info(message, context); },
+    debug: function (message) { return logger_1.default.debug(message, context); },
+    trace: function (message) { return logger_1.default.trace(message, context); },
+};
+//# sourceMappingURL=logger.js.map

package/src/common/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/common/logger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,iFAA2D;AAE3D,mDAA6C;AAE7C,wEAAsD;AAEtD,IAAM,OAAO,GAAG,eAAQ,sBAAO,CAAE,CAAC;AAElC,kBAAe;IACb,SAAS,EAAE,UAAC,OAAe,IAAW,OAAA,gBAAM,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAlC,CAAkC;IACxE,KAAK,EAAE,UAAC,OAAe,IAAW,OAAA,gBAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EAA9B,CAA8B;IAChE,IAAI,EAAE,UAAC,OAAe,IAAW,OAAA,gBAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAA7B,CAA6B;IAC9D,IAAI,EAAE,UAAC,OAAe,IAAW,OAAA,gBAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAA7B,CAA6B;IAC9D,KAAK,EAAE,UAAC,OAAe,IAAW,OAAA,gBAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EAA9B,CAA8B;IAChE,KAAK,EAAE,UAAC,OAAe,IAAW,OAAA,gBAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EAA9B,CAA8B;CACjE,CAAC"}

package/src/common/net.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Network module.
+ * @module net
+ * @private
+ */
+export declare const localAddresses: string[];
+export declare const portCheck: (port: number, host: string) => Promise<void>;
+export declare const isPortAvailable: (port: number, host: string) => Promise<void>;
+export declare const freePort: () => Promise<number>;

package/src/common/net.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Network module.
+ * @module net
+ * @private
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.freePort = exports.isPortAvailable = exports.portCheck = exports.localAddresses = void 0;
+var net = __importStar(require("net"));
+var bluebird_1 = require("bluebird");
+exports.localAddresses = ['127.0.0.1', 'localhost', '0.0.0.0', '::1'];
+var portCheck = function (port, host) {
+    return new Promise(function (resolve, reject) {
+        var server = net
+            .createServer()
+            .listen({ port: port, host: host, exclusive: true })
+            .on('error', function (e) {
+            if (e.code === 'EADDRINUSE') {
+                reject(new Error("Port ".concat(port, " is unavailable on address ").concat(host)));
+            }
+            else {
+                reject(e);
+            }
+        })
+            .on('listening', function () {
+            server.once('close', function () { return resolve(); }).close();
+        });
+    });
+};
+exports.portCheck = portCheck;
+var isPortAvailable = function (port, host) {
+    return Promise.resolve(bluebird_1.Promise
+        .map(exports.localAddresses, 
+    // we meed to wrap the built-in Promise with bluebird.reflect() so we can
+    // test the result of the promise without failing bluebird.map()
+    function (h) { return bluebird_1.Promise.resolve((0, exports.portCheck)(port, h)).reflect(); }, 
+    // do each port check sequentially (as localhost & 127.0.0.1 will conflict on most default environments)
+    { concurrency: 1 })
+        .then(function (inspections) {
+        // if every port check failed, then fail the `isPortAvailable` check
+        if (inspections.every(function (inspection) { return !inspection.isFulfilled(); })) {
+            return Promise.reject(new Error("Cannot open port ".concat(port, " on ipv4 or ipv6 interfaces")));
+        }
+        // the local addresses passed - now check the host that the user has specified
+        return (0, exports.portCheck)(port, host);
+    }));
+};
+exports.isPortAvailable = isPortAvailable;
+var freePort = function () {
+    return new Promise(function (res) {
+        var s = net.createServer();
+        s.listen(0, function () {
+            var port = s.address().port;
+            s.close(function () { return res(port); });
+        });
+    });
+};
+exports.freePort = freePort;
+//# sourceMappingURL=net.js.map

package/src/common/net.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"net.js","sourceRoot":"","sources":["../../../src/common/net.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAA2B;AAC3B,qCAA+C;AAElC,QAAA,cAAc,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAEpE,IAAM,SAAS,GAAG,UAAC,IAAY,EAAE,IAAY;IAClD,OAAA,IAAI,OAAO,CAAC,UAAC,OAAO,EAAE,MAAM;QAC1B,IAAM,MAAM,GAAG,GAAG;aACf,YAAY,EAAE;aACd,MAAM,CAAC,EAAE,IAAI,MAAA,EAAE,IAAI,MAAA,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;aACvC,EAAE,CAAC,OAAO,EAAE,UAAC,CAAwB;YACpC,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,eAAQ,IAAI,wCAA8B,IAAI,CAAE,CAAC,CAAC,CAAC;aACrE;iBAAM;gBACL,MAAM,CAAC,CAAC,CAAC,CAAC;aACX;QACH,CAAC,CAAC;aACD,EAAE,CAAC,WAAW,EAAE;YACf,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAM,OAAA,OAAO,EAAE,EAAT,CAAS,CAAC,CAAC,KAAK,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AAdF,CAcE,CAAC;AAfQ,QAAA,SAAS,aAejB;AAEE,IAAM,eAAe,GAAG,UAAC,IAAY,EAAE,IAAY;IACxD,OAAA,OAAO,CAAC,OAAO,CACb,kBAAQ;SACL,GAAG,CACF,sBAAc;IACd,yEAAyE;IACzE,gEAAgE;IAChE,UAAC,CAAC,IAAK,OAAA,kBAAQ,CAAC,OAAO,CAAC,IAAA,iBAAS,EAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAA9C,CAA8C;IACrD,wGAAwG;IACxG,EAAE,WAAW,EAAE,CAAC,EAAE,CACnB;SACA,IAAI,CAAC,UAAC,WAAW;QAChB,oEAAoE;QACpE,IAAI,WAAW,CAAC,KAAK,CAAC,UAAC,UAAU,IAAK,OAAA,CAAC,UAAU,CAAC,WAAW,EAAE,EAAzB,CAAyB,CAAC,EAAE;YAChE,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,2BAAoB,IAAI,gCAA6B,CAAC,CACjE,CAAC;SACH;QAED,8EAA8E;QAC9E,OAAO,IAAA,iBAAS,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CACL;AArBD,CAqBC,CAAC;AAtBS,QAAA,eAAe,mBAsBxB;AAEG,IAAM,QAAQ,GAAG;IACtB,OAAO,IAAI,OAAO,CAAC,UAAC,GAAG;QACrB,IAAM,CAAC,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE;YACV,IAAM,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC;YAC9B,CAAC,CAAC,KAAK,CAAC,cAAM,OAAA,GAAG,CAAC,IAAI,CAAC,EAAT,CAAS,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AARW,QAAA,QAAQ,YAQnB"}

package/src/common/net.spec.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var chai_1 = __importDefault(require("chai"));
+var chai_as_promised_1 = __importDefault(require("chai-as-promised"));
+var net_1 = __importDefault(require("net"));
+var net_2 = require("./net");
+var logger_1 = __importDefault(require("./logger"));
+var expect = chai_1.default.expect;
+chai_1.default.use(chai_as_promised_1.default);
+describe('Net', function () {
+    var port = 4567;
+    var defaultHost = '0.0.0.0';
+    var specialPort = process.platform.match('win') ? -1 : 80;
+    // Utility function to create a server on a given port and return a Promise
+    var createServer = function (p, host) {
+        if (host === void 0) { host = defaultHost; }
+        return new Promise(function (resolve, reject) {
+            var server = net_1.default.createServer();
+            server.on('error', function (err) { return reject(err); });
+            server.on('listening', function () { return resolve(server); });
+            server.listen({ port: p, host: host, exclusive: true }, function () {
+                logger_1.default.info("test server is up on ".concat(host, ":").concat(p));
+            });
+        });
+    };
+    describe('#isPortAvailable', function () {
+        context('when the port is not allowed to be bound', function () {
+            it('returns a rejected promise', function () {
+                return expect((0, net_2.isPortAvailable)(specialPort, defaultHost)).to.eventually.be
+                    .rejected;
+            });
+        });
+        context('when the port is available', function () {
+            it('returns a fulfilled promise', function () {
+                return expect((0, net_2.isPortAvailable)(port, defaultHost)).to.eventually.be.fulfilled;
+            });
+        });
+        context('when the port is unavailable', function () {
+            var closeFn = function (cb) { return cb(); };
+            it('returns a rejected promise', function () {
+                return createServer(port).then(function (server) {
+                    closeFn = server.close.bind(server);
+                    return expect((0, net_2.isPortAvailable)(port, defaultHost)).to.eventually.be
+                        .rejected;
+                });
+            });
+            // close the servers used in this test as to not conflict with other tests
+            afterEach(function (done) { return closeFn(done); });
+        });
+        context('when a single host is unavailable', function () {
+            var closeFn = function (cb) { return cb(); };
+            it('returns a fulfilled promise', function () {
+                // simulate ::1 being unavailable
+                return createServer(port, '::1').then(function (server) {
+                    closeFn = server.close.bind(server);
+                    // this should work as the `127.0.0.1` is NOT `::1`
+                    return expect((0, net_2.isPortAvailable)(port, '127.0.0.1')).to.eventually.be
+                        .fulfilled;
+                });
+            });
+            // close the servers used in this test as to not conflict with other tests
+            afterEach(function (done) { return closeFn(done); });
+        });
+    });
+});
+//# sourceMappingURL=net.spec.js.map