@govuk-pay/cli 0.0.2-rc.0

package/bin/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commandRouter_js_1 = __importDefault(require("../src/core/commandRouter.js"));
+(async () => {
+    try {
+        await (0, commandRouter_js_1.default)();
+    }
+    catch (e) {
+        console.error('Error executing command:');
+        console.error(e);
+    }
+})()
+    .catch((e) => {
+    throw e;
+});

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@govuk-pay/cli",
+  "version": "0.0.2-rc.0",
+  "description": "GOV.UK Pay Command Line Interface",
+  "bin": {
+    "pay": "bin/cli.js",
+    "payx": "bin/cli.js",
+    "@govuk-pay/cli": "bin/cli.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "openurl": "^1.1.1",
+    "ts-standard": "^12.0.2"
+  },
+  "files": [
+    "resources",
+    "src"
+  ]
+}

package/readme.md

@@ -0,0 +1,30 @@
+# pay-cli
+GOV.UK Pay Command Line Interface
+
+## Usage
+
+This is published to NPM, you can install it globally using `npm install -g @govuk-pay/cli`,
+once it's installed you can run it using `pay [arguments]` or `payx [arguments]`.
+If you'd rather not install it globally you can run it using `npx @govuk-pay/cli`.
+
+We're in the process of porting the existing Ruby CLI into typescript, we've tried to make that process
+transparent to the users of the CLI.  Most of the commands rely on the existing ruby implementation therefore
+you'll need `rbenv` installed with `bundler` installed into it.  When handing over to ruby we use `zsh` by default,
+if you want a different shell or `rbenv` you can set the following environment variables:
+
+ - `PAY_CLI_RBENV_COMMAND` - defaults to `rbenv`
+ - `PAY_CLI_SHELL_COMMAND` - defaults to `zsh`
+
+To see the commands run `pay` without any arguments.
+
+If you find that the ported typescript version isn't behaving as expected and you want to use the ruby version you can
+use the command `legacy`, for example:
+
+ - `pay browse manual` - uses the typescript port to open the team manual
+ - `pay legacy browse manual` - uses the original ruby version to open the team manual
+
+Please add an issue any time you need to fall back on legacy behaviour so we can improve the typescript implementation.
+
+## Vulnerability Disclosure
+
+GOV.UK Pay aims to stay secure for everyone. If you are a security researcher and have discovered a security vulnerability in this code, we appreciate your help in disclosing it to us in a responsible manner. Please refer to our [vulnerability disclosure policy](https://www.gov.uk/help/report-vulnerability) and our [security.txt](https://vdp.cabinetoffice.gov.uk/.well-known/security.txt) file for details.

package/resources/header.txt

@@ -0,0 +1,9 @@
+
+       ____
+      / __ ____ ___  __
+     / /_/ / __ `/ / / /
+    / ____/ /_/ / /_/ /
+   /_/    __,_/__, /
+               /____/
+
+🏠  Local Pay for local people

package/resources/usageDetails.txt

@@ -0,0 +1,11 @@
+Commands:
+  pay aws                      # Interactions with AWS, e.g. fetching STS tokens
+  pay browse                   # Opens web browser link to useful links
+  pay deployment_status <env>  # Describe what's deployed
+  pay doctor                   # Attempts to initialise or fix the Pay CLI
+  pay help [COMMAND]           # Describe available commands or one specific ...
+  pay local                    # Sets up local Pay development environment
+  pay schema                   # Generates web based database diagrams and me...
+  pay secrets                  # Manage secrets in and between environments
+  pay ssm                      # Start an SSM session to boxes in environments
+  pay tf                       # Runs Terraform

package/src/commands/browse.js

@@ -0,0 +1,95 @@
+"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 __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.logBrowseCommands = void 0;
+const path = __importStar(require("path"));
+const standardContent_js_1 = require("../core/standardContent.js");
+const constants_js_1 = require("../core/constants.js");
+const moduleFunctionWrapper_js_1 = require("../util/moduleFunctionWrapper.js");
+const requestableItems = new Map();
+requestableItems.set('concourse', {
+    name: 'concourse page',
+    url: 'https://pay-cd.deploy.payments.service.gov.uk/'
+});
+requestableItems.set('manual', {
+    name: 'team manual',
+    url: 'https://manual.payments.service.gov.uk/'
+});
+requestableItems.set('repo', {
+    name: 'pay-infra github repository',
+    url: 'https://github.com/alphagov/pay-infra'
+});
+requestableItems.set('status', {
+    name: 'status page',
+    url: 'https://payments.statuspage.io/'
+});
+function logBrowseCommands() {
+    console.log(`Commands:
+    pay browse concourse       # browses the concourse page
+    pay browse help [COMMAND]  # Describe subcommands or one specific subcommand
+    pay browse manual          # browses the pay team manual
+    pay browse repo            # browses the pay-infra github repo
+    pay browse status          # browses the pay status page`);
+}
+exports.logBrowseCommands = logBrowseCommands;
+function logNoCommand(argumentName) {
+    console.error(`Could not find command "${argumentName}".`);
+    console.log(`The available options are: "${Array.from(requestableItems.keys()).join('", "')}".`);
+}
+async function browseHandler(options) {
+    await (0, standardContent_js_1.showHeader)();
+    if (options.arguments.length === 0) {
+        logBrowseCommands();
+        return;
+    }
+    if (options.arguments[0] === 'help') {
+        const argumentName = options.arguments[1];
+        if (argumentName === undefined || argumentName.trim() === '') {
+            logBrowseCommands();
+            return;
+        }
+        const requestedItem = requestableItems.get(argumentName);
+        if (requestedItem != null) {
+            console.log('Usage:');
+            console.log(`  npx --package=${path.resolve(constants_js_1.rootDir)} browse ${argumentName}`);
+            console.log(`browses the ${requestedItem.name}`);
+            return;
+        }
+        logNoCommand(argumentName);
+        return;
+    }
+    const requestedItem = requestableItems.get(options.arguments[0]);
+    if (requestedItem != null) {
+        console.log(`Opening the ${requestedItem.name}`);
+        moduleFunctionWrapper_js_1.moduleFunctionWrapper.open(requestedItem.url, (err) => {
+            if (err != null) {
+                console.log(`Failed to open browser, please visit ${requestedItem.url}`);
+            }
+        });
+        return;
+    }
+    logNoCommand(options.arguments[0]);
+}
+exports.default = browseHandler;

package/src/commands/browse.spec.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// import * as open from 'open'
+const globals_1 = require("@jest/globals");
+const moduleFunctionWrapper_js_1 = require("../util/moduleFunctionWrapper.js");
+const browse_js_1 = __importDefault(require("./browse.js"));
+const commandsText = `Commands:
+    pay browse concourse       # browses the concourse page
+    pay browse help [COMMAND]  # Describe subcommands or one specific subcommand
+    pay browse manual          # browses the pay team manual
+    pay browse repo            # browses the pay-infra github repo
+    pay browse status          # browses the pay status page`;
+(0, globals_1.describe)('browse command', () => {
+    (0, globals_1.beforeEach)(() => {
+        globals_1.jest.spyOn(console, 'log').mockImplementation(() => { });
+        globals_1.jest.spyOn(console, 'error').mockImplementation(() => { });
+        globals_1.jest.spyOn(moduleFunctionWrapper_js_1.moduleFunctionWrapper, 'open').mockImplementation(() => { });
+    });
+    (0, globals_1.afterEach)(() => {
+        globals_1.jest.restoreAllMocks();
+        globals_1.jest.resetModules();
+    });
+    (0, globals_1.it)('should show usage when no additional params are provided', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: [] });
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith(commandsText);
+    });
+    (0, globals_1.it)('should open the browser when manual is provided as the first param', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: ['manual'] });
+        (0, globals_1.expect)(moduleFunctionWrapper_js_1.moduleFunctionWrapper.open).toHaveBeenCalledWith('https://manual.payments.service.gov.uk/', globals_1.expect.any(Function));
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith('Opening the team manual');
+        (0, globals_1.expect)(console.error).not.toHaveBeenCalled();
+    });
+    (0, globals_1.it)('should open the browser when concourse is provided as the first param', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: ['concourse'] });
+        (0, globals_1.expect)(moduleFunctionWrapper_js_1.moduleFunctionWrapper.open).toHaveBeenCalledWith('https://pay-cd.deploy.payments.service.gov.uk/', globals_1.expect.any(Function));
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith('Opening the concourse page');
+        (0, globals_1.expect)(console.error).not.toHaveBeenCalled();
+    });
+    (0, globals_1.it)('should open the browser when repo is provided as the first param', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: ['repo'] });
+        (0, globals_1.expect)(moduleFunctionWrapper_js_1.moduleFunctionWrapper.open).toHaveBeenCalledWith('https://github.com/alphagov/pay-infra', globals_1.expect.any(Function));
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith('Opening the pay-infra github repository');
+        (0, globals_1.expect)(console.error).not.toHaveBeenCalled();
+    });
+    (0, globals_1.it)('should open the browser when status is provided as the first param', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: ['status'] });
+        (0, globals_1.expect)(moduleFunctionWrapper_js_1.moduleFunctionWrapper.open).toHaveBeenCalledWith('https://payments.statuspage.io/', globals_1.expect.any(Function));
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith('Opening the status page');
+        (0, globals_1.expect)(console.error).not.toHaveBeenCalled();
+    });
+    (0, globals_1.it)('should show the help page when requested', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: ['help'] });
+        (0, globals_1.expect)(moduleFunctionWrapper_js_1.moduleFunctionWrapper.open).not.toHaveBeenCalled();
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith(`Commands:
+    pay browse concourse       # browses the concourse page
+    pay browse help [COMMAND]  # Describe subcommands or one specific subcommand
+    pay browse manual          # browses the pay team manual
+    pay browse repo            # browses the pay-infra github repo
+    pay browse status          # browses the pay status page`);
+    });
+    (0, globals_1.it)('should details about a command', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: ['help', 'manual'] });
+        (0, globals_1.expect)(moduleFunctionWrapper_js_1.moduleFunctionWrapper.open).not.toHaveBeenCalled();
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith('Usage:');
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith('browses the team manual');
+    });
+    (0, globals_1.it)('should handle an unknown command', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: ['abcdef'] });
+        (0, globals_1.expect)(moduleFunctionWrapper_js_1.moduleFunctionWrapper.open).not.toHaveBeenCalled();
+        (0, globals_1.expect)(console.error).toHaveBeenCalledWith('Could not find command "abcdef".');
+        (0, globals_1.expect)(console.log).toHaveBeenCalledWith('The available options are: "concourse", "manual", "repo", "status".');
+    });
+    (0, globals_1.it)('should handle an unknown command within help', async () => {
+        await (0, browse_js_1.default)({ commandName: 'browse', arguments: ['help', 'abcdef'] });
+        (0, globals_1.expect)(moduleFunctionWrapper_js_1.moduleFunctionWrapper.open).not.toHaveBeenCalled();
+        (0, globals_1.expect)(console.error).toHaveBeenCalledWith('Could not find command "abcdef".');
+    });
+});

package/src/commands/demo.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+async function demoHandler(options) {
+    console.log('This is where you would put your implementation.');
+    await new Promise((resolve) => {
+        setTimeout(resolve, 10);
+    });
+    console.log('It can be asynchronous.');
+    console.error('You can also write to stderr.');
+}
+exports.default = demoHandler;

package/src/commands/help.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const legacy_1 = require("./legacy");
+const standardContent_1 = require("../core/standardContent");
+const browse_1 = require("./browse");
+async function helpHandler(options) {
+    if (options.arguments[0] === 'browse') {
+        await (0, standardContent_1.showHeader)();
+        (0, browse_1.logBrowseCommands)();
+    }
+    else {
+        await (0, legacy_1.proxyHandlerOptionsToLegacyCli)(options);
+    }
+}
+exports.default = helpHandler;

package/src/commands/legacy.js

@@ -0,0 +1,70 @@
+"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 __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.proxyHandlerOptionsToLegacyCli = exports.proxyArrayOfArgumentsToLegacyCli = void 0;
+const payCliExec_1 = __importStar(require("../util/payCliExec"));
+const path = __importStar(require("node:path"));
+const constants_1 = require("../core/constants");
+const standardContent_1 = require("../core/standardContent");
+async function legacyHandler(options) {
+    const argsToPassOn = [];
+    if (options.commandName !== 'legacy') {
+        argsToPassOn.unshift(options.commandName);
+    }
+    options.arguments.forEach((arg) => {
+        argsToPassOn.push(arg);
+    });
+    await proxyArrayOfArgumentsToLegacyCli(argsToPassOn);
+}
+exports.default = legacyHandler;
+async function proxyArrayOfArgumentsToLegacyCli(argsToPassOn) {
+    await (0, standardContent_1.showHeader)();
+    const rbenvCommand = process.env.PAY_CLI_RBENV_COMMAND ?? 'rbenv';
+    const shellCommand = process.env.PAY_CLI_SHELL_COMMAND ?? 'zsh';
+    const whichRbenvResult = await (0, payCliExec_1.execAndReturnIO)(`which ${rbenvCommand}`);
+    const whichBundlerResult = await (0, payCliExec_1.execAndReturnIO)(`${rbenvCommand} exec which bundle`);
+    if (whichRbenvResult.exitCode !== 0) {
+        console.error('You need rbenv installed before you can continue.');
+        process.exit(12);
+    }
+    if (whichBundlerResult.exitCode !== 0) {
+        console.error('You need bundler installed and available to rbenv before you can continue.');
+        process.exit(12);
+    }
+    await (0, payCliExec_1.default)(shellCommand, {
+        cwd: path.join(constants_1.rootDir, 'legacy-ruby-cli'),
+        matchExitCode: true,
+        streamStdio: true,
+        commandsToWrite: [
+            `${rbenvCommand} exec bundle exec bin/pay ${argsToPassOn.join(' ')}`,
+            'exit $?'
+        ]
+    });
+}
+exports.proxyArrayOfArgumentsToLegacyCli = proxyArrayOfArgumentsToLegacyCli;
+async function proxyHandlerOptionsToLegacyCli(options) {
+    await proxyArrayOfArgumentsToLegacyCli([options.commandName].concat(options.arguments));
+}
+exports.proxyHandlerOptionsToLegacyCli = proxyHandlerOptionsToLegacyCli;

package/src/core/commandRouter.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const standardContent_js_1 = require("./standardContent.js");
+const browse_js_1 = __importDefault(require("../commands/browse.js"));
+const demo_js_1 = __importDefault(require("../commands/demo.js"));
+const legacy_1 = __importDefault(require("../commands/legacy"));
+const help_1 = __importDefault(require("../commands/help"));
+const handlers = new Map();
+handlers.set('browse', {
+    handler: browse_js_1.default
+});
+handlers.set('legacy', {
+    handler: legacy_1.default
+});
+handlers.set('aws', {
+    handler: legacy_1.default
+});
+handlers.set('deployment_status', {
+    handler: legacy_1.default
+});
+handlers.set('doctor', {
+    handler: legacy_1.default
+});
+handlers.set('help', {
+    handler: help_1.default
+});
+handlers.set('local', {
+    handler: legacy_1.default
+});
+handlers.set('schema', {
+    handler: legacy_1.default
+});
+handlers.set('secrets', {
+    handler: legacy_1.default
+});
+handlers.set('ssm', {
+    handler: legacy_1.default
+});
+handlers.set('tf', {
+    handler: legacy_1.default
+});
+handlers.set('demo', {
+    handler: demo_js_1.default
+});
+async function runCommand() {
+    const command = process.argv[2];
+    await showUsageIfNoCommand(command);
+    const commandDetails = await getCommandDetails(command);
+    if (commandDetails === undefined) {
+        console.error(`No command found for [${command}]`);
+        process.exit(10);
+    }
+    await runHandler(command, commandDetails);
+}
+exports.default = runCommand;
+async function getCommandDetails(commandName) {
+    return handlers.get(commandName);
+}
+async function showUsageIfNoCommand(commandName) {
+    if (commandName === undefined || commandName.trim() === '') {
+        await (0, standardContent_js_1.showHeader)();
+        await (0, standardContent_js_1.showUsage)();
+        process.exit(2);
+    }
+}
+async function runHandler(commandName, commandHandler) {
+    try {
+        await commandHandler.handler({
+            commandName,
+            arguments: process.argv.slice(3)
+        });
+    }
+    catch (e) {
+        console.error(`Failed to run command [${commandName}]`);
+        console.error(e);
+        process.exit(12);
+    }
+}

package/src/core/constants.js

@@ -0,0 +1,38 @@
+"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 __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.distDir = exports.rootDir = void 0;
+const path = __importStar(require("path"));
+// import {dirname} from 'path'
+// import {fileURLToPath} from 'url'
+//
+// // @ts-ignore
+// const currentDir = dirname(fileURLToPath(import.meta.url))
+const potentialRootDir = path.resolve(__dirname, '..', '..');
+exports.rootDir = potentialRootDir.endsWith('dist') ? path.resolve(potentialRootDir, '..') : potentialRootDir;
+exports.distDir = path.join(exports.rootDir, 'dist');
+exports.default = {
+    rootDir: exports.rootDir
+};

package/src/core/standardContent.js

@@ -0,0 +1,37 @@
+"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 __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.showUsage = exports.showHeader = void 0;
+const fsp = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const constants_js_1 = require("./constants.js");
+async function showHeader() {
+    console.log(await fsp.readFile(path.join(constants_js_1.rootDir, 'resources/header.txt'), 'utf8'));
+}
+exports.showHeader = showHeader;
+async function showUsage() {
+    console.log(await fsp.readFile(path.join(constants_js_1.rootDir, 'resources/usageDetails.txt'), 'utf8'));
+}
+exports.showUsage = showUsage;

package/src/util/moduleFunctionWrapper.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moduleFunctionWrapper = void 0;
+const openurl_1 = require("openurl");
+exports.moduleFunctionWrapper = {
+    open: openurl_1.open
+};

package/src/util/payCliExec.js

@@ -0,0 +1,88 @@
+"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 __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.execAndReturnIO = void 0;
+const cp = __importStar(require("child_process"));
+async function payCliExec(fullCommand, options) {
+    return await new Promise((resolve) => {
+        const commandParts = fullCommand.split(' ');
+        const command = commandParts.shift();
+        if (command === undefined) {
+            throw new Error('Command can\'t be undefined');
+        }
+        const spawnedThread = cp.spawn(command, commandParts, {
+            cwd: options?.cwd,
+            env: options?.passThroughEnvironmentVariables === true ? { ...process.env } : undefined
+        });
+        if ((options?.onStdout) !== undefined) {
+            spawnedThread.stdout.on('data', options.onStdout);
+        }
+        if ((options?.onStderr) !== undefined) {
+            spawnedThread.stderr.on('data', options.onStderr);
+        }
+        if ((options?.onClose) !== undefined) {
+            spawnedThread.on('close', options.onClose);
+        }
+        if (options?.streamStdio === true) {
+            spawnedThread.stdout.pipe(process.stdout);
+            spawnedThread.stderr.pipe(process.stderr);
+            process.stdin.pipe(spawnedThread.stdin);
+        }
+        if (options?.matchExitCode === true) {
+            spawnedThread.once('close', (exitCode) => {
+                process.exitCode = exitCode;
+            });
+        }
+        spawnedThread.once('close', () => {
+            resolve();
+        });
+        if (options?.commandsToWrite !== undefined) {
+            spawnedThread.stdin.setDefaultEncoding('utf-8');
+            options.commandsToWrite.forEach((value) => {
+                spawnedThread.stdin.write(`${value}\n`);
+            });
+        }
+    });
+}
+exports.default = payCliExec;
+async function execAndReturnIO(command, options = {}) {
+    const result = {
+        stdout: '',
+        stderr: '',
+        exitCode: -1
+    };
+    options.onStdout = (data) => {
+        result.stdout = `${result.stdout}${data.toString()}`;
+    };
+    options.onStderr = (data) => {
+        result.stderr = `${result.stderr}${data.toString()}`;
+    };
+    options.onClose = (statusCode) => {
+        result.exitCode = statusCode;
+    };
+    await payCliExec(command, options);
+    return result;
+}
+exports.execAndReturnIO = execAndReturnIO;