@govuk-pay/cli 0.0.30 → 0.0.32

package/src/commands/local/docker_compose_controller.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const dockerComposeController = {
+    up(composeFilePath) {
+        (0, node_child_process_1.spawnSync)('docker', ['compose', '--file', composeFilePath, 'up', '--detach', '--wait'], { shell: true, stdio: 'inherit' });
+    },
+    down(composeFilePath) {
+        (0, node_child_process_1.spawnSync)('docker', ['compose', '--file', composeFilePath, 'down'], { shell: true, stdio: 'inherit' });
+    },
+    nuke(composeFilePath) {
+        (0, node_child_process_1.spawnSync)('docker', ['compose', '--file', composeFilePath, 'down', '--volumes'], { shell: true, stdio: 'inherit' });
+    },
+    pull(composeFilePath) {
+        (0, node_child_process_1.spawnSync)('docker', ['compose', '--file', composeFilePath, 'pull'], { shell: true, stdio: 'inherit' });
+    },
+    restart(composeFilePath, service) {
+        (0, node_child_process_1.spawnSync)('docker', ['compose', '--file', composeFilePath, 'restart', service], { shell: true, stdio: 'inherit' });
+    },
+    build(composeFilePath) {
+        (0, node_child_process_1.spawnSync)('docker', ['compose', '--file', composeFilePath, 'build'], { shell: true, stdio: 'inherit' });
+    }
+};
+exports.default = dockerComposeController;

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

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const app_client_js_1 = __importDefault(require("../app_client/app_client.js"));
+async function AccountHandler(options) {
+    const args = parseArguments(options);
+    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 (args.serviceID === undefined) {
+        serviceExternalID = await app_client_js_1.default.createService();
+        if (serviceExternalID === undefined) {
+            console.error('Service creation failed');
+            return;
+        }
+    }
+    else {
+        serviceExternalID = args.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;
+function parseArguments(options) {
+    if (options.length === 0) {
+        return {};
+    }
+    if (options.length > 1) {
+        help();
+        throw new Error('Too many arguments');
+    }
+    return { serviceID: options[0] };
+}
+function help() {
+    console.log('Usage: pay local account [service_id]>');
+}

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

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+async function BrowseHandler(options) {
+    const args = parseArguments(options);
+    const servicesConfig = (0, pay_local_cluster_js_1.loadServicesConfig)();
+    if (!(args.service in servicesConfig)) {
+        console.error(`The service specified (${args.service}) was not defined in the service_config.yaml file`);
+        return;
+    }
+    const serviceConfig = servicesConfig[args.service];
+    const url = app_client_js_1.default.externalUrlFor(args.service, '/', args.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;
+function help() {
+    console.log('Usage: pay local browse <service>');
+}
+function parseArguments(options) {
+    if (options.length !== 1) {
+        help();
+        throw new Error('No service specified');
+    }
+    return {
+        service: options[0],
+        proxy: true
+    };
+}

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

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const pay_local_cluster_js_1 = require("../config/pay_local_cluster.js");
+async function DBHandler(options) {
+    const args = parseArguments(options);
+    const servicesConfig = (0, pay_local_cluster_js_1.loadServicesConfig)();
+    if (!(args.service in servicesConfig)) {
+        console.error(`The service specified (${args.service}) was not defined in the service_config.yaml file`);
+        return;
+    }
+    const serviceConfig = servicesConfig[args.service];
+    if (!serviceConfig.db) {
+        console.error(`The service specified (${serviceConfig.name}) does not have a database`);
+        return;
+    }
+    if (args.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'
+        }
+    });
+}
+function help() {
+    console.log('Usage: pay local db <service> [--docker]');
+}
+function parseArguments(options) {
+    if (options.length !== 1) {
+        help();
+        throw new Error('No service specified');
+    }
+    return {
+        service: options[0],
+        docker: false
+    };
+}

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

@@ -0,0 +1,56 @@
+"use strict";
+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;
+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"));
+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) {
+    const renderedTempaltesPath = (0, configs_js_1.ensureConfigDirectory)(exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH);
+    const args = parseArguments(options);
+    const composeFilePath = composeFileToDown(args, 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`);
+        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` +
+            '\n' +
+            `Perhaps you don't have a cluster running, or the cluster that is running isn't ${downOptions.cluster}\n`);
+    }
+    const mostRecentUpFile = (0, last_up_record_js_1.getLastUp)(renderedTemplatesPath);
+    if (mostRecentUpFile !== undefined) {
+        return mostRecentUpFile;
+    }
+    const defaultDownFile = node_path_1.default.join(renderedTemplatesPath, 'all.yaml');
+    if (node_fs_1.default.existsSync(defaultDownFile)) {
+        return defaultDownFile;
+    }
+    throw new Error('Could not determine which cluster to bring down.\n' +
+        '\n' +
+        '  * You did not specify a cluster with --cluster.\n' +
+        "  * There is no valid record of a most recent 'up'\n" +
+        "  * The 'all' cluster rendered docker-compose.yaml file does not exist.\n" +
+        '\n' +
+        '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

@@ -0,0 +1,28 @@
+"use strict";
+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;
+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"));
+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() {
+    const upOptions = {
+        cluster: 'nuke',
+        proxy: true,
+        with_egress_proxy: true,
+        apps: [],
+        local: [],
+        rebuild: false,
+        pull: false,
+        mount_local_node_apps: 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;

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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);
+    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() };
+}
+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,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const app_client_js_1 = __importDefault(require("../app_client/app_client.js"));
+async function PaymentHandler(options) {
+    const args = parseArguments(options);
+    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;
+    }
+    let apiKey;
+    if (args.api_key === 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, args.email_collection_mode === undefined ? 'MANDATORY' : args.email_collection_mode);
+        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();
+    }
+    else {
+        apiKey = args.api_key;
+    }
+    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;
+function parseArguments(_options) {
+    return {};
+}

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

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = __importDefault(require("node:child_process"));
+const app_client_js_1 = __importDefault(require("../app_client/app_client.js"));
+async function PaymentLinkHandler(options) {
+    const args = parseArguments(options);
+    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(args.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;
+function parseArguments(options) {
+    if (options.length !== 1) {
+        help();
+        throw new Error('No key specified');
+    }
+    return { apiKey: options[0].trimEnd() };
+}
+function help() {
+    console.log('Usage: pay local paymentlink <api_key>');
+}

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

@@ -0,0 +1,35 @@
+"use strict";
+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;
+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 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]
+    };
+}

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

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const app_client_js_1 = __importDefault(require("../app_client/app_client.js"));
+async function TokenHandler(options) {
+    const args = parseArguments(options);
+    if (await app_client_js_1.default.isUnhealthy('publicauth')) {
+        console.error('The publicauth service is unhealthy, so an API token cannot be created');
+        return;
+    }
+    let gatewayAccountID;
+    if (args.gatewayAccountID === undefined) {
+        console.log('No gateway_account_id provided, creating service and gateway account');
+        if (await app_client_js_1.default.isUnhealthy('adminusers')) {
+            console.error('The adminusers service is unhealthy, so an API token cannot be created');
+            return;
+        }
+        if (await app_client_js_1.default.isUnhealthy('connector')) {
+            console.error('The connector service is unhealthy, so an API token cannot be created');
+            return;
+        }
+        const serviceExternalID = await app_client_js_1.default.createService();
+        if (serviceExternalID === undefined) {
+            console.error('Service creation failed');
+            return;
+        }
+        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;
+        }
+        gatewayAccountID = account.gateway_account_id;
+    }
+    else {
+        gatewayAccountID = args.gatewayAccountID;
+    }
+    const token = await app_client_js_1.default.createToken(gatewayAccountID);
+    if (token === undefined) {
+        console.error('Failed to create an API token');
+        return;
+    }
+    copyToClipboard(token);
+    console.log(`📋 API token “${token}” copied to clipboard`);
+}
+exports.default = TokenHandler;
+function parseArguments(options) {
+    if (options.length === 0) {
+        return {};
+    }
+    if (options.length > 1) {
+        help();
+        throw new Error('Too many arguments');
+    }
+    return { gatewayAccountID: options[0] };
+}
+function copyToClipboard(token) {
+    const proc = (0, node_child_process_1.spawn)('pbcopy');
+    proc.stdin.write(token);
+    proc.stdin.end();
+}
+function help() {
+    console.log('Usage: pay local token [gateway_account_id]>');
+}

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

@@ -0,0 +1,55 @@
+"use strict";
+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;
+const path_1 = __importDefault(require("path"));
+const docker_compose_controller_js_1 = __importDefault(require("../docker_compose_controller.js"));
+const configs_js_1 = require("../../../util/configs.js");
+const pay_local_cluster_js_1 = require("../config/pay_local_cluster.js");
+const renderer_js_1 = require("../config/renderer.js");
+const last_up_record_js_1 = require("../config/last_up_record.js");
+const default_config_setup_js_1 = require("../config/default_config_setup.js");
+exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH = path_1.default.join('local', 'docker-compose', 'rendered-templates');
+exports.DOCKER_COMPOSE_SERVICES_CONFIG_PATH = path_1.default.join('local', 'docker-compose', 'default-configs-DO-NOT-EDIT');
+exports.ENVIRONMENT_OVERRIDES_PATH = path_1.default.join('local', 'environment-overrides');
+async function UpHandler(options, onlyWriteConfig = false) {
+    const workspace = (0, configs_js_1.workspaceEnvVar)();
+    const renderedTemplatesPath = (0, configs_js_1.ensureConfigDirectory)(exports.DOCKER_COMPOSE_RENDERED_TEMPALTES_PATH);
+    const composeServicesConfigPath = (0, configs_js_1.ensureConfigDirectory)(exports.DOCKER_COMPOSE_SERVICES_CONFIG_PATH);
+    const environmentOverridesPath = (0, configs_js_1.ensureConfigDirectory)(exports.ENVIRONMENT_OVERRIDES_PATH);
+    (0, default_config_setup_js_1.copyDefaultConfigs)(composeServicesConfigPath);
+    const args = options instanceof Array ? parseArguments(options) : options;
+    const clusterConfig = (0, pay_local_cluster_js_1.loadClusterConfig)(args, workspace, composeServicesConfigPath, environmentOverridesPath);
+    const renderedTemplatePath = (0, renderer_js_1.renderDockerCompose)(clusterConfig, renderedTemplatesPath);
+    console.log(`docker-compose yaml written to ${renderedTemplatePath}`);
+    (0, last_up_record_js_1.recordUp)(renderedTemplatesPath, clusterConfig);
+    if (onlyWriteConfig) {
+        return renderedTemplatePath;
+    }
+    if (args.pull) {
+        console.log(`\nPulling containers for cluster ${clusterConfig.name}`);
+        docker_compose_controller_js_1.default.pull(renderedTemplatePath);
+    }
+    if (args.local.length > 0 && args.rebuild) {
+        console.log(`\nBuilding all local apps for cluster ${clusterConfig.name}`);
+        docker_compose_controller_js_1.default.build(renderedTemplatePath);
+    }
+    console.log(`\nGoing up with cluster ${clusterConfig.name}`);
+    docker_compose_controller_js_1.default.up(renderedTemplatePath);
+    return renderedTemplatePath;
+}
+exports.default = UpHandler;
+function parseArguments(_options) {
+    return {
+        cluster: 'all',
+        apps: [],
+        local: [], // ['cardid', 'frontend'],
+        proxy: true,
+        with_egress_proxy: false,
+        rebuild: true,
+        pull: true,
+        mount_local_node_apps: false
+    };
+}

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

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+async function URLHandler(options) {
+    const args = parseArguments(options);
+    const servicesConfig = (0, pay_local_cluster_js_1.loadServicesConfig)();
+    if (!(args.service in servicesConfig)) {
+        console.error(`The service specified (${args.service}) was not defined in the service_config.yaml file`);
+        return;
+    }
+    const serviceConfig = servicesConfig[args.service];
+    const url = app_client_js_1.default.externalUrlFor(args.service, '/', args.proxy);
+    copyToClipboard(url);
+    if (await app_client_js_1.default.isHealthy(serviceConfig.name)) {
+        console.log(`📋 “${url}” copied to clipboard`);
+    }
+    else {
+        console.error(`❌ “${url}” copied to clipboard, however the app did not respond successfully to ${url}/healthcheck`);
+    }
+}
+exports.default = URLHandler;
+function copyToClipboard(url) {
+    const proc = (0, node_child_process_1.spawn)('pbcopy');
+    proc.stdin.write(url);
+    proc.stdin.end();
+}
+function help() {
+    console.log('Usage: pay local url <service>');
+}
+function parseArguments(options) {
+    if (options.length !== 1) {
+        help();
+        throw new Error('No service specified');
+    }
+    return {
+        service: options[0],
+        proxy: false
+    };
+}