@govuk-pay/cli 0.0.31 → 0.0.33

package/src/commands/local/config/pay_local_cluster.js

@@ -3,18 +3,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadClusterConfig = exports.PayLocalCluster = void 0;
+exports.loadServicesConfig = exports.loadClusterConfig = exports.PayLocalCluster = exports.CLUSTERS = void 0;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const yaml_1 = __importDefault(require("yaml"));
 const md5_js_1 = require("../../../util/md5.js");
+exports.CLUSTERS = ['all', 'admin', 'card', 'paymentlinks', 'webhooks', 'endtoend', 'java', 'toolbox'];
 // This is the complete cluster configuration that will be used as the context for template rendering
 class PayLocalCluster {
     name;
     payServices;
     dbServices;
     reverseProxyServices;
-    egressProxy;
     javaApps;
     nodeApps;
     localJavaApps;
@@ -29,6 +29,7 @@ class PayLocalCluster {
     requiresEgressProxy;
     serviceURLEnvVars;
     mountLocalNodeApps;
+    mountPayJSCommons;
     noProxyEnvVar;
     defaultServiceConfigsPath;
     environmentOverridesPath;
@@ -38,7 +39,6 @@ class PayLocalCluster {
         this.payServices = clusterConfig.payServices;
         this.dbServices = clusterConfig.dbServices;
         this.reverseProxyServices = clusterConfig.reverseProxyServices;
-        this.egressProxy = clusterConfig.egressProxy;
         this.javaApps = this.payServices.filter((service) => service.serviceType === PayServiceType.Java);
         this.nodeApps = this.payServices.filter((service) => service.serviceType === PayServiceType.Node);
         this.remoteJavaApps = this.javaApps.filter((service) => service.localBuild);
@@ -49,8 +49,9 @@ class PayLocalCluster {
         this.anyNodeApps = this.nodeApps.length >= 0;
         this.requiresLocalStack = this.payServices.some((service) => service.requiresLocalStack);
         this.requiresRedis = this.payServices.some((service) => service.usesRedis);
-        this.requiresEgressProxy = this.egressProxy !== undefined;
+        this.requiresEgressProxy = clusterConfig.egressProxy;
         this.mountLocalNodeApps = clusterConfig.mountLocalNodeApps;
+        this.mountPayJSCommons = clusterConfig.mountPayJSCommons;
         this.serviceURLEnvVars = [
             this.javaApps.map((javaService) => envVarForJavaService(javaService)),
             this.nodeApps.map((nodeService) => envVarForNodeService(nodeService))
@@ -64,7 +65,7 @@ class PayLocalCluster {
             this.payServices.map((service) => service.name),
             this.dbServices.map((service) => service.name),
             this.reverseProxyServices.map((service) => service.name),
-            this.egressProxy === undefined ? [] : this.egressProxy.name
+            this.requiresEgressProxy ? [] : ['egress']
         ].flat().join(',');
         this.environmentOverridesPath = clusterConfig.environmentOverridesPath;
         this.defaultServiceConfigsPath = clusterConfig.defaultServiceConfigsPath;
@@ -89,9 +90,7 @@ var PayServiceType;
     PayServiceType["Node"] = "node";
 })(PayServiceType || (PayServiceType = {}));
 function loadClusterConfig(options, workspace, defaultServiceConfigsPath, environmentOverridesPath) {
-    const servicesConfigPath = node_path_1.default.join(__dirname, '..', '..', '..', '..', 'resources', 'pay-local', 'config', 'service_config.yaml');
-    const serviceConfigFileContents = node_fs_1.default.readFileSync(servicesConfigPath, 'utf8');
-    const servicesConfig = yaml_1.default.parse(serviceConfigFileContents);
+    const servicesConfig = loadServicesConfig();
     const payServices = [];
     for (const [, serviceConfig] of Object.entries(servicesConfig)) {
         if (includeAppInCluster(options.cluster, options, serviceConfig)) {
@@ -116,15 +115,23 @@ function loadClusterConfig(options, workspace, defaultServiceConfigsPath, enviro
         name: options.cluster,
         payServices,
         dbServices,
+        egressProxy: options.withEgressProxy,
         reverseProxyServices,
         workspace,
-        mountLocalNodeApps: options.mount_local_node_apps,
+        mountLocalNodeApps: options.mountLocalNodeApps,
+        mountPayJSCommons: options.mountPayJSCommons,
         defaultServiceConfigsPath,
         environmentOverridesPath
     };
     return new PayLocalCluster(clusterConfig);
 }
 exports.loadClusterConfig = loadClusterConfig;
+function loadServicesConfig() {
+    const servicesConfigPath = node_path_1.default.join(__dirname, '..', '..', '..', '..', 'resources', 'pay-local', 'config', 'service_config.yaml');
+    const serviceConfigFileContents = node_fs_1.default.readFileSync(servicesConfigPath, 'utf8');
+    return yaml_1.default.parse(serviceConfigFileContents);
+}
+exports.loadServicesConfig = loadServicesConfig;
 function includeAppInCluster(cluster, options, serviceConfig) {
     if (cluster === 'all' || cluster === 'nuke' || serviceConfig.clusters.includes(cluster)) {
         if (options.apps.length === 0 || options.apps.includes(serviceConfig.name)) {
@@ -166,7 +173,7 @@ function payServiceFromPayServiceConfig(config, upOptions, environmentOverridesP
         hasSNSTopics: snsTopics.length > 0,
         hasProxy: config.proxy === undefined ? false : config.proxy,
         hasDB: config.db,
-        useEgressProxy: config.can_use_egress_proxy === undefined ? false : config.can_use_egress_proxy && upOptions.with_egress_proxy,
+        useEgressProxy: config.can_use_egress_proxy === undefined ? false : config.can_use_egress_proxy && upOptions.withEgressProxy,
         dependsOn: config.db ? [`${config.name}_db`] : [],
         expose: [],
         payServiceConfig: config,

package/src/commands/local/subcommands/account.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.builder = exports.desc = exports.command = void 0;
+const app_client_js_1 = __importDefault(require("../app_client/app_client.js"));
+const standardContent_1 = require("../../../core/standardContent");
+exports.command = 'account';
+exports.desc = 'Create a local gateway account';
+const builder = (yargs) => {
+    return yargs.usage(`$0 local account [--service-id <SERVICE_ID>]\n\n${exports.desc}`)
+        .option('service-id', {
+        type: 'string',
+        description: 'ID of an existing service'
+    });
+};
+exports.builder = builder;
+exports.handler = accountHandler;
+async function accountHandler(argv) {
+    await (0, standardContent_1.showHeader)();
+    const serviceId = argv.serviceId;
+    if (await app_client_js_1.default.isUnhealthy('adminusers')) {
+        console.error('The adminusers service is unhealthy, so an account cannot be created');
+        return;
+    }
+    if (await app_client_js_1.default.isUnhealthy('connector')) {
+        console.error('The connector service is unhealthy, so an account cannot be created');
+        return;
+    }
+    let serviceExternalId;
+    if (serviceId === undefined) {
+        serviceExternalId = await app_client_js_1.default.createService();
+        if (serviceExternalId === undefined) {
+            console.error('Service creation failed');
+            return;
+        }
+    }
+    else {
+        serviceExternalId = serviceId;
+    }
+    if (serviceExternalId === undefined) {
+        throw new Error('Service external ID is undefined, this should be impossible');
+    }
+    const account = await app_client_js_1.default.createAccountInServiceWithEmailCollectionMode(serviceExternalId, 'MANDATORY');
+    if (account === undefined) {
+        console.error('Failed to create a fully set up account');
+        return;
+    }
+    console.log(account);
+}
+exports.default = accountHandler;

package/src/commands/local/subcommands/browse.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.builder = exports.desc = exports.command = void 0;
+const node_child_process_1 = require("node:child_process");
+const app_client_js_1 = __importDefault(require("../app_client/app_client.js"));
+const pay_local_cluster_js_1 = require("../config/pay_local_cluster.js");
+const standardContent_1 = require("../../../core/standardContent");
+exports.command = 'browse <service>';
+exports.desc = 'Browse to local service';
+const builder = (yargs) => {
+    return yargs
+        .usage(`$0 local browse <service> [--proxy]\n\n${exports.desc}`)
+        .positional('service', {
+        type: 'string',
+        description: 'service'
+    })
+        .option('proxy', {
+        type: 'boolean',
+        default: false,
+        description: 'Opens the service via the local proxy for the service'
+    });
+};
+exports.builder = builder;
+exports.handler = browseHandler;
+async function browseHandler(argv) {
+    await (0, standardContent_1.showHeader)();
+    const service = argv.service;
+    const proxy = argv.proxy;
+    const servicesConfig = (0, pay_local_cluster_js_1.loadServicesConfig)();
+    if (!(service in servicesConfig)) {
+        console.error(`The service specified (${service}) was not defined in the service_config.yaml file`);
+        return;
+    }
+    const serviceConfig = servicesConfig[service];
+    const url = app_client_js_1.default.externalUrlFor(service, '/', proxy);
+    (0, node_child_process_1.spawn)('open', [url]);
+    if (await app_client_js_1.default.isHealthy(serviceConfig.name)) {
+        console.log(`📋 “${url}” opened`);
+    }
+    else {
+        console.error(`❌ “${url}” opened, however the app did not respond successfully to ${url}/healthcheck`);
+    }
+}
+exports.default = browseHandler;

package/src/commands/local/subcommands/db.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.builder = exports.desc = exports.command = void 0;
+const node_child_process_1 = require("node:child_process");
+const pay_local_cluster_js_1 = require("../config/pay_local_cluster.js");
+const standardContent_1 = require("../../../core/standardContent");
+exports.command = 'db <app_name>';
+exports.desc = 'Connect to <app_name> database';
+const builder = (yargs) => {
+    return yargs
+        .usage(`$0 local db <app_name> [--docker]\n\n${exports.desc}`)
+        .positional('app_name', {
+        type: 'string',
+        description: 'service'
+    })
+        .option('docker', {
+        type: 'boolean',
+        default: false,
+        description: 'Launch psql inside the apps database container (no psql history)'
+    });
+};
+exports.builder = builder;
+exports.handler = dbHandler;
+async function dbHandler(argv) {
+    await (0, standardContent_1.showHeader)();
+    const service = argv.app_name;
+    const docker = argv.docker;
+    const servicesConfig = (0, pay_local_cluster_js_1.loadServicesConfig)();
+    if (!(service in servicesConfig)) {
+        console.error(`The service specified (${service}) was not defined in the service_config.yaml file`);
+        return;
+    }
+    const serviceConfig = servicesConfig[service];
+    if (!serviceConfig.db) {
+        console.error(`The service specified (${serviceConfig.name}) does not have a database`);
+        return;
+    }
+    if (docker) {
+        launchPsqlInDocker(serviceConfig);
+    }
+    else if (!psqlAvailable()) {
+        console.warn('PSQL installation not found locally.');
+        launchPsqlInDocker(serviceConfig);
+    }
+    else {
+        launchPsql(serviceConfig);
+    }
+}
+exports.default = dbHandler;
+function psqlAvailable() {
+    const psqlCheck = (0, node_child_process_1.spawnSync)('command', ['-v', 'psql'], { shell: true });
+    if (psqlCheck.status === 0) {
+        return true;
+    }
+    return false;
+}
+function launchPsqlInDocker(serviceConfig) {
+    console.log('Running psql in running app db container.');
+    console.log('Note: This means you wont have a psql history, and one will not survive restarts of pay local');
+    (0, node_child_process_1.spawn)('docker', [
+        'exec',
+        '-e', 'PGPASSWORD=mysecretpassword', // pragma: allowlist secret
+        '-e', 'PGSSLMODE=disable',
+        '-ti',
+        `${serviceConfig.name}_db`,
+        'psql',
+        '--host', `${serviceConfig.name}_db`,
+        '--user', serviceConfig.name,
+        '--dbname', serviceConfig.name
+    ], { stdio: 'inherit', shell: true });
+}
+function launchPsql(serviceConfig) {
+    if (serviceConfig.db_port === undefined) {
+        throw new Error(`Service config for ${serviceConfig.name} is missing db_port specification`);
+    }
+    (0, node_child_process_1.spawn)('psql', [
+        '--host', '127.0.0.1',
+        '--port', `${serviceConfig.db_port}`,
+        '--user', serviceConfig.name,
+        '--dbname', serviceConfig.name
+    ], {
+        stdio: 'inherit',
+        shell: true,
+        env: {
+            ...process.env,
+            PGPASSWORD: 'mysecretpassword', // pragma: allowlist secret
+            PGSSLMODE: 'disable'
+        }
+    });
+}

package/src/commands/local/subcommands/down.js

@@ -3,34 +3,50 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.composeFileToDown = exports.ENVIRONMENT_OVERRIDES_PATH = exports.DOCKER_COMPOSE_SERVICES_CONFIG_PATH = exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = void 0;
+exports.composeFileToDown = exports.handler = exports.builder = exports.desc = exports.command = exports.ENVIRONMENT_OVERRIDES_PATH = exports.DOCKER_COMPOSE_SERVICES_CONFIG_PATH = exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = void 0;
 const node_path_1 = __importDefault(require("node:path"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const configs_js_1 = require("../../../util/configs.js");
 const last_up_record_js_1 = require("../config/last_up_record.js");
 const docker_compose_controller_js_1 = __importDefault(require("../docker_compose_controller.js"));
+const pay_local_cluster_js_1 = require("../config/pay_local_cluster.js");
+const standardContent_1 = require("../../../core/standardContent");
 exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = node_path_1.default.join('local', 'docker-compose', 'rendered-templates');
 exports.DOCKER_COMPOSE_SERVICES_CONFIG_PATH = node_path_1.default.join('local', 'docker-compose', 'default-configs-DO-NOT-EDIT');
 exports.ENVIRONMENT_OVERRIDES_PATH = node_path_1.default.join('local', 'environment-overrides');
-async function DownHandler(options) {
+exports.command = 'down';
+exports.desc = 'Bring down a cluster';
+const builder = (yargs) => {
+    return yargs
+        .usage(`$0 local down [--cluster <cluster>]\n\n${exports.desc}`)
+        .option('cluster', {
+        type: 'string',
+        description: 'Cluster to bring down',
+        choices: pay_local_cluster_js_1.CLUSTERS
+    });
+};
+exports.builder = builder;
+exports.handler = downHandler;
+async function downHandler(argv) {
+    await (0, standardContent_1.showHeader)();
+    const { cluster } = argv;
     const renderedTempaltesPath = (0, configs_js_1.ensureConfigDirectory)(exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH);
-    const args = parseArguments(options);
-    const composeFilePath = composeFileToDown(args, renderedTempaltesPath);
+    const composeFilePath = composeFileToDown(cluster, renderedTempaltesPath);
     const composeFileName = node_path_1.default.basename(composeFilePath);
     const clusterToDown = composeFileName.substring(0, composeFileName.lastIndexOf('.yaml'));
     console.log(`Bringing down cluster ${clusterToDown}`);
     docker_compose_controller_js_1.default.down(composeFilePath);
 }
-exports.default = DownHandler;
-function composeFileToDown(downOptions, renderedTemplatesPath) {
-    if (downOptions.cluster !== undefined) {
-        const clusterFilePath = node_path_1.default.resolve(renderedTemplatesPath, `${downOptions.cluster}.yaml`);
+exports.default = downHandler;
+function composeFileToDown(cluster, renderedTemplatesPath) {
+    if (cluster !== undefined) {
+        const clusterFilePath = node_path_1.default.resolve(renderedTemplatesPath, `${cluster}.yaml`);
         if (node_fs_1.default.existsSync(clusterFilePath)) {
             return clusterFilePath;
         }
-        throw new Error(`Cannot bring down cluster '${downOptions.cluster}' since it does not have a rendered docker-compose template in ${renderedTemplatesPath}.\n` +
+        throw new Error(`Cannot bring down cluster '${cluster}' since it does not have a rendered docker-compose template in ${renderedTemplatesPath}.\n` +
             '\n' +
-            `Perhaps you don't have a cluster running, or the cluster that is running isn't ${downOptions.cluster}\n`);
+            `Perhaps you don't have a cluster running, or the cluster that is running isn't ${cluster}\n`);
     }
     const mostRecentUpFile = (0, last_up_record_js_1.getLastUp)(renderedTemplatesPath);
     if (mostRecentUpFile !== undefined) {
@@ -49,8 +65,3 @@ function composeFileToDown(downOptions, renderedTemplatesPath) {
         'Perhaps you do not have a running cluster, or you need to `pay local down --cluster <cluster>` specifying the last cluster you launched\n');
 }
 exports.composeFileToDown = composeFileToDown;
-function parseArguments(_options) {
-    return {
-        cluster: 'card'
-    };
-}

package/src/commands/local/subcommands/nuke.js

@@ -3,26 +3,32 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENVIRONMENT_OVERRIDES_PATH = exports.DOCKER_COMPOSE_SERVICES_CONFIG_PATH = exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = void 0;
+exports.handler = exports.desc = exports.command = exports.ENVIRONMENT_OVERRIDES_PATH = exports.DOCKER_COMPOSE_SERVICES_CONFIG_PATH = exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = void 0;
 const up_js_1 = __importDefault(require("./up.js"));
 const node_path_1 = __importDefault(require("node:path"));
 const docker_compose_controller_js_1 = __importDefault(require("../docker_compose_controller.js"));
+const standardContent_1 = require("../../../core/standardContent");
 exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = node_path_1.default.join('local', 'docker-compose', 'rendered-templates');
 exports.DOCKER_COMPOSE_SERVICES_CONFIG_PATH = node_path_1.default.join('local', 'docker-compose', 'default-configs-DO-NOT-EDIT');
 exports.ENVIRONMENT_OVERRIDES_PATH = node_path_1.default.join('local', 'environment-overrides');
-async function NukeHandler() {
+exports.command = 'nuke';
+exports.desc = 'Kill and completely destroy all containers previously started by pay local';
+exports.handler = nukeHandler;
+async function nukeHandler(argv) {
+    await (0, standardContent_1.showHeader)();
     const upOptions = {
         cluster: 'nuke',
         proxy: true,
-        with_egress_proxy: true,
+        withEgressProxy: true,
         apps: [],
         local: [],
         rebuild: false,
         pull: false,
-        mount_local_node_apps: false
+        mountLocalNodeApps: false,
+        mountPayJSCommons: false
     };
     const renderedTemplatePath = await (0, up_js_1.default)(upOptions, true);
     console.log('Nuking cluster');
     docker_compose_controller_js_1.default.nuke(renderedTemplatePath);
 }
-exports.default = NukeHandler;
+exports.default = nukeHandler;

package/src/commands/local/subcommands/otp.js

@@ -1,27 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.builder = exports.desc = exports.command = void 0;
 const node_child_process_1 = require("node:child_process");
 const totp_generator_1 = require("totp-generator");
-async function OTPHandler(options) {
-    const args = parseArguments(options);
-    const { otp } = totp_generator_1.TOTP.generate(args.secret);
+const standardContent_1 = require("../../../core/standardContent");
+exports.command = 'opt <key>';
+exports.desc = 'Create otp code';
+const builder = (yargs) => {
+    return yargs.positional('key', {
+        type: 'string',
+        description: 'otp key'
+    });
+};
+exports.builder = builder;
+exports.handler = otpHandler;
+async function otpHandler(argv) {
+    await (0, standardContent_1.showHeader)();
+    const { otp } = totp_generator_1.TOTP.generate(argv.key);
     console.log(otp);
     copyToClipboard(otp);
     console.log(`📋 “${otp}” copied to clipboard`);
 }
-exports.default = OTPHandler;
-function parseArguments(options) {
-    if (options.length !== 1) {
-        help();
-        throw new Error('No key specified');
-    }
-    return { secret: options[0].trimEnd() };
-}
+exports.default = otpHandler;
 function copyToClipboard(otp) {
     const proc = (0, node_child_process_1.spawn)('pbcopy');
     proc.stdin.write(otp);
     proc.stdin.end();
 }
-function help() {
-    console.log('Usage: pay local otp <otp_secret_key>');
-}

package/src/commands/local/subcommands/payment.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 });
+exports.handler = exports.builder = exports.desc = exports.command = void 0;
+const node_child_process_1 = require("node:child_process");
+const app_client_js_1 = __importDefault(require("../app_client/app_client.js"));
+const standardContent_1 = require("../../../core/standardContent");
+exports.command = 'payment';
+exports.desc = 'Create a payment';
+const builder = (yargs) => {
+    return yargs
+        .usage(`$0 local payment [--api-key <api-key>] [--email-collection-mode <email-collection-mode>]\n\n${exports.desc}`)
+        .option('api-key', {
+        type: 'string',
+        description: 'API Key'
+    }).option('email-collection-mode', {
+        type: 'string',
+        default: 'MANDATORY',
+        choices: ['MANDATORY', 'OPTIONAL', 'OFF'],
+        description: 'Email collection mode to use'
+    });
+};
+exports.builder = builder;
+exports.handler = paymentHandler;
+async function paymentHandler(argv) {
+    await (0, standardContent_1.showHeader)();
+    let apiKey = argv.apiKey;
+    if (await app_client_js_1.default.isUnhealthy('connector')) {
+        console.error('The connector service is unhealthy, so a payment cannot be created');
+        return;
+    }
+    if (await app_client_js_1.default.isUnhealthy('publicapi')) {
+        console.error('The publicapi service is unhealthy, so a payment cannot be created');
+        return;
+    }
+    if (apiKey === undefined) {
+        console.warn('👔  Creating gateway account and service');
+        console.warn();
+        if (await app_client_js_1.default.isUnhealthy('adminusers')) {
+            console.error('The adminusers service is unhealthy, so a gateway account cannot be created to enable a payment to be created');
+            return;
+        }
+        const serviceExternalID = await app_client_js_1.default.createService();
+        if (serviceExternalID === undefined) {
+            console.error('Unable to create a service');
+            return;
+        }
+        const account = await app_client_js_1.default.createAccountInServiceWithEmailCollectionMode(serviceExternalID, argv.emailCollectionMode);
+        if (account === undefined) {
+            console.error('Failed to create a fully set up account');
+            return;
+        }
+        const createTokenResult = await app_client_js_1.default.createToken(account.gateway_account_id);
+        if (createTokenResult === undefined) {
+            console.error('Failed to create an api token');
+            return;
+        }
+        apiKey = createTokenResult;
+        console.warn(`🆔  Gateway account ID: ${account.gateway_account_id}`);
+        console.warn(`💁  Service ID: ${serviceExternalID}`);
+        console.warn();
+    }
+    const createPaymentResult = await app_client_js_1.default.createPayment(apiKey);
+    if (createPaymentResult === undefined) {
+        console.error('Failed to create a payment');
+        return;
+    }
+    console.warn(`💷  Payment ID: ${createPaymentResult.payment_id}`);
+    console.warn(`🎫  API token: ${apiKey}`);
+    console.warn();
+    const nextUrl = createPaymentResult._links.next_url?.href;
+    if (nextUrl === undefined) {
+        console.error('The response from creating the payment did not include a next_url link');
+        return;
+    }
+    console.log(`Opening next_url (${nextUrl} in your browser`);
+    (0, node_child_process_1.spawn)('open', [nextUrl]);
+}
+exports.default = paymentHandler;

package/src/commands/local/subcommands/paymentlink.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.builder = exports.desc = exports.command = void 0;
+const node_child_process_1 = __importDefault(require("node:child_process"));
+const app_client_js_1 = __importDefault(require("../app_client/app_client.js"));
+const standardContent_1 = require("../../../core/standardContent");
+exports.command = 'paymentlink';
+exports.desc = 'Create a payment link';
+const builder = (yargs) => {
+    return yargs
+        .usage(`$0 local paymentlink --api-key <api-key>\n\n${exports.desc}`)
+        .option('api-key', {
+        demandOption: true,
+        type: 'string',
+        description: 'API Key'
+    });
+};
+exports.builder = builder;
+exports.handler = paymentLinkHandler;
+async function paymentLinkHandler(argv) {
+    await (0, standardContent_1.showHeader)();
+    const apiKey = argv.apiKey;
+    if (await app_client_js_1.default.isUnhealthy('products')) {
+        console.error('The products service is unhealthy, so a payment link cannot be created');
+        return;
+    }
+    else if (await app_client_js_1.default.isUnhealthy('products-ui')) {
+        console.error('The products-ui service is unhealthy, so a payment link cannot be created');
+        return;
+    }
+    const paymentLinks = await app_client_js_1.default.createPaymentLink(apiKey);
+    if (paymentLinks === undefined) {
+        console.error('Payment link creation failed');
+        return;
+    }
+    paymentLinks.forEach((link) => { console.log(`${link.method} ${link.rel}: ${link.href}`); });
+    const payLink = paymentLinks.find((link) => link.rel === 'pay');
+    if (payLink === undefined) {
+        console.error('The response to create a payment link did not include a link with the rel of "pay"');
+        return;
+    }
+    node_child_process_1.default.spawn('open', [payLink.href]);
+}
+exports.default = paymentLinkHandler;

package/src/commands/local/subcommands/restart.js

@@ -3,33 +3,36 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = void 0;
+exports.handler = exports.builder = exports.desc = exports.command = exports.DOCKER_COMPOSE_RENDERED_TEMPLATES_PATH = void 0;
 const node_path_1 = __importDefault(require("node:path"));
 const configs_js_1 = require("../../../util/configs.js");
 const last_up_record_js_1 = require("../config/last_up_record.js");
 const docker_compose_controller_js_1 = __importDefault(require("../docker_compose_controller.js"));
-exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = node_path_1.default.join('local', 'docker-compose', 'rendered-templates');
-async function DownHandler(options) {
-    const renderedTempaltesPath = (0, configs_js_1.ensureConfigDirectory)(exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH);
-    const args = parseArguments(options);
+const standardContent_1 = require("../../../core/standardContent");
+exports.DOCKER_COMPOSE_RENDERED_TEMPLATES_PATH = node_path_1.default.join('local', 'docker-compose', 'rendered-templates');
+exports.command = 'restart <app>';
+exports.desc = 'Restart a container and waits for it to be healthy';
+const builder = (yargs) => {
+    return yargs
+        .usage(`$0 local restart <app>\n\n${exports.desc}`)
+        .positional('app', {
+        type: 'string',
+        description: 'App to restart'
+    });
+};
+exports.builder = builder;
+exports.handler = restartHandler;
+async function restartHandler(argv) {
+    await (0, standardContent_1.showHeader)();
+    const service = argv.app;
+    const renderedTempaltesPath = (0, configs_js_1.ensureConfigDirectory)(exports.DOCKER_COMPOSE_RENDERED_TEMPLATES_PATH);
     const composeFilePath = (0, last_up_record_js_1.getLastUp)(renderedTempaltesPath);
     if (composeFilePath === undefined) {
         throw new Error('Cannot find the docker-compose file for the running cluster');
     }
     const composeFileName = node_path_1.default.basename(composeFilePath);
     const clusterName = composeFileName.substring(0, composeFileName.lastIndexOf('.yaml'));
-    console.log(`\nRestarting '${args.service} in cluster ${clusterName}`);
-    docker_compose_controller_js_1.default.restart(composeFilePath, args.service);
-}
-exports.default = DownHandler;
-function parseArguments(options) {
-    if (options.length !== 1) {
-        throw new Error('Incorrect number of arguments, expected 1 to restart command\n' +
-            '\n' +
-            '  Usage: pay local restart <service>\n' +
-            '\n');
-    }
-    return {
-        service: options[0]
-    };
+    console.log(`\nRestarting '${service} in cluster ${clusterName}`);
+    docker_compose_controller_js_1.default.restart(composeFilePath, service);
 }
+exports.default = restartHandler;