bdy 1.19.7-dev → 1.19.9-dev-pipeline

package/distTs/src/command/pipeline/yaml.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const texts_1 = require("../../texts");
+const input_1 = __importDefault(require("../../input"));
+const output_1 = __importDefault(require("../../output"));
+const commandPipelineYaml = (0, utils_1.newCommand)('yaml', texts_1.DESC_COMMAND_PIPELINE_YAML);
+commandPipelineYaml.hideVersionUpdate = true;
+commandPipelineYaml.alias('yml');
+commandPipelineYaml.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
+commandPipelineYaml.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
+commandPipelineYaml.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
+commandPipelineYaml.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_PIPELINE_YML}`);
+commandPipelineYaml.action(async (identifier, options) => {
+    const workspace = input_1.default.restApiWorkspace(options.workspace);
+    const project = input_1.default.restApiProject(options.project);
+    const client = input_1.default.restApiTokenClient();
+    const data = await client.getPipelineByIdentifier(workspace, project, identifier);
+    if (!data || !data.domain) {
+        output_1.default.exitError(texts_1.ERR_WORKSPACE_NOT_FOUND);
+    }
+    if (!data.project_identifier) {
+        output_1.default.exitError(texts_1.ERR_PROJECT_NOT_FOUND);
+    }
+    if (!data.pipeline_id) {
+        output_1.default.exitError(texts_1.ERR_PIPELINE_NOT_FOUND);
+    }
+    const result = await client.getPipelineYml(workspace, project, data.pipeline_id);
+    let yml = '';
+    if (result.yaml) {
+        yml = Buffer.from(result.yaml, 'base64').toString('utf8');
+    }
+    output_1.default.exitNormal(yml);
+});
+exports.default = commandPipelineYaml;

package/distTs/src/command/pipeline.js

@@ -6,7 +6,30 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../utils");
 const texts_1 = require("../texts");
 const run_1 = __importDefault(require("./pipeline/run"));
+const list_1 = __importDefault(require("./pipeline/list"));
+const get_1 = __importDefault(require("./pipeline/get"));
+const yaml_1 = __importDefault(require("./pipeline/yaml"));
+const create_1 = __importDefault(require("./pipeline/create"));
+const update_1 = __importDefault(require("./pipeline/update"));
 const commandPipeline = (0, utils_1.newCommand)('pipeline', texts_1.DESC_COMMAND_PIPELINE);
 commandPipeline.alias('pip');
 commandPipeline.addCommand(run_1.default);
+commandPipeline.addCommand(list_1.default);
+commandPipeline.addCommand(get_1.default);
+commandPipeline.addCommand(yaml_1.default);
+commandPipeline.addCommand(create_1.default);
+commandPipeline.addCommand(update_1.default);
+commandPipeline.addHelpText('after', `
+EXAMPLES:${texts_1.EXAMPLE_PIPELINE_RUN_START}
+${texts_1.EXAMPLE_PIPELINE_RUN_STATUS}
+${texts_1.EXAMPLE_PIPELINE_RUN_LOGS}
+${texts_1.EXAMPLE_PIPELINE_RUN_CANCEL}
+${texts_1.EXAMPLE_PIPELINE_RUN_RETRY}
+${texts_1.EXAMPLE_PIPELINE_RUN_APPLY}
+${texts_1.EXAMPLE_PIPELINE_RUN_LIST}
+${texts_1.EXAMPLE_PIPELINE_LIST}
+${texts_1.EXAMPLE_PIPELINE_GET}
+${texts_1.EXAMPLE_PIPELINE_YML}
+${texts_1.EXAMPLE_PIPELINE_CREATE}
+${texts_1.EXAMPLE_PIPELINE_UPDATE}`);
 exports.default = commandPipeline;

package/distTs/src/command/project/link.js

@@ -23,7 +23,7 @@ commandProjectLink.action(async (dir, options) => {
     ProjectCfg.init(path, workspace, project);
     output_1.default.okSign();
     output_1.default.normal(texts_1.TXT_COMMAND_PROJECT_LINK_TO, false);
-    output_1.default.light(` ${url}`);
+    output_1.default.cyan(` ${url}`);
     await initRepo(workspace, project, path, git, options);
     tryNow();
     output_1.default.exitNormal();
@@ -54,13 +54,13 @@ const tryNow = () => {
     output_1.default.arrowSign();
     output_1.default.label(texts_1.OPT_COMMAND_PROJECT_LINK_TRY_NOW);
     output_1.default.dim('$ ', false);
-    output_1.default.light('bdy tunnel http 3000 ', false);
+    output_1.default.cyan('bdy tunnel http 3000 ', false);
     output_1.default.muted('                  Expose localhost:3000 to the internet');
     output_1.default.dim('$ ', false);
-    output_1.default.light('bdy artifact publish . ', false);
+    output_1.default.cyan('bdy artifact publish . ', false);
     output_1.default.muted('                 Publish an artifact from the current project');
     output_1.default.dim('$ ', false);
-    output_1.default.light('bdy sandbox create --run "npm start" ', false);
+    output_1.default.cyan('bdy sandbox create --run "npm start" ', false);
     output_1.default.muted('  Spin up a cloud sandbox and run your app');
 };
 const initRepo = async (workspace, project, path, git, options) => {
@@ -89,16 +89,16 @@ const initRepo = async (workspace, project, path, git, options) => {
         });
         output_1.default.okSign();
         output_1.default.normal('Remote ', false);
-        output_1.default.light('origin ', false);
+        output_1.default.cyan('origin ', false);
         output_1.default.normal('set to ', false);
-        output_1.default.light(remote);
+        output_1.default.cyan(remote);
     }
     else if (remotes.origin !== remote) {
         output_1.default.yellow(texts_1.OPT_COMMAND_PROJECT_LINK_HAS_REMOTE);
         output_1.default.normal('Current origin: ', false);
-        output_1.default.light(remotes.origin);
+        output_1.default.cyan(remotes.origin);
         output_1.default.normal('Buddy project: ', false);
-        output_1.default.light(remote);
+        output_1.default.cyan(remote);
         const opt = await output_1.default.inputMenuAdv(texts_1.OPT_COMMAND_PROJECT_LINK_SET_GIT_REMOTE, [
             {
                 name: 'Add buddy remote',
@@ -127,9 +127,9 @@ const initRepo = async (workspace, project, path, git, options) => {
             });
             output_1.default.okSign();
             output_1.default.normal('Remote ', false);
-            output_1.default.light('buddy ', false);
+            output_1.default.cyan('buddy ', false);
             output_1.default.normal('set to ', false);
-            output_1.default.light(remote);
+            output_1.default.cyan(remote);
         }
         else if (opt === 'origin') {
             await (0, utils_1.execLocally)(`git remote rm origin`, {
@@ -140,7 +140,7 @@ const initRepo = async (workspace, project, path, git, options) => {
             });
             output_1.default.okSign();
             output_1.default.normal('Origin replaced with ', false);
-            output_1.default.light(remote);
+            output_1.default.cyan(remote);
         }
         else {
             return;

package/distTs/src/command/tests/capture/validation.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOptions = validateOptions;
+exports.checkIfMinimalOptionsAreProvided = checkIfMinimalOptionsAreProvided;
+const zod_1 = require("zod");
+const output_1 = __importDefault(require("../../../output"));
+const validation_1 = require("../visual/shared/validation");
+const optionsSchema = zod_1.z.object({
+    urls: zod_1.z.string().optional(),
+    sitemap: zod_1.z.string().optional(),
+    urlsFile: zod_1.z.string().optional(),
+    follow: zod_1.z.boolean(),
+    respectRobots: zod_1.z.boolean(),
+    ignore: zod_1.z
+        .array(zod_1.z.string().regex(/^(?:([^:]+)::)?(?:(CSS|XPATH))=(.+)$/, {
+        message: "Ignore option must follow pattern '[scope::]type=value' where type must be CSS or XPATH (scope is optional)",
+    }))
+        .optional()
+        .transform(validation_1.parseScopedSelector),
+    cookie: validation_1.cookieSchema,
+    header: validation_1.headerSchema,
+    delay: validation_1.delaySchema,
+    waitFor: validation_1.waitForSchema,
+    ignoreUrls: zod_1.z.array(zod_1.z.string()).optional(),
+    dryRun: zod_1.z.boolean().optional(),
+});
+function validateOptions(options) {
+    try {
+        const validatedOptions = optionsSchema.parse(options);
+        return validatedOptions;
+    }
+    catch (error) {
+        if (error instanceof zod_1.ZodError) {
+            output_1.default.exitError(error.errors.map((e) => e.message).join(', '));
+        }
+        else {
+            throw error;
+        }
+    }
+}
+function checkIfMinimalOptionsAreProvided(options) {
+    return !!options.urls || !!options.sitemap || !!options.urlsFile;
+}

package/distTs/src/command/tests/capture.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const texts_1 = require("../../texts");
+const output_1 = __importDefault(require("../../output"));
+const node_fs_1 = require("node:fs");
+const commandCapture = (0, utils_1.newCommand)('capture', texts_1.DESC_COMMAND_CAPTURE);
+commandCapture.option('--urls <urls>', texts_1.OPTION_COMPARE_URLS);
+commandCapture.option('--sitemap <sitemap>', texts_1.OPTION_COMPARE_SITEMAP);
+commandCapture.option('--urlsFile <urlsFile>', texts_1.OPTION_COMPARE_URLS_FILE);
+commandCapture.option('--dryRun', texts_1.OPTION_COMPARE_DRY_RUN);
+commandCapture.option('--follow', texts_1.OPTION_COMPARE_FOLLOW, false);
+commandCapture.option('--respectRobots', texts_1.OPTION_COMPARE_RESPECT_ROBOTS, false);
+commandCapture.option('--ignoreUrls <ignoreUrls...>', texts_1.OPTION_COMPARE_IGNORE_URLS);
+commandCapture.option('--ignore <ignores...>', texts_1.OPTION_COMPARE_IGNORE);
+commandCapture.option('--cookie <cookies...>', texts_1.OPTION_COMPARE_COOKIE);
+commandCapture.option('--header <headers...>', texts_1.OPTION_COMPARE_HEADER);
+commandCapture.option('--delay <delays...>', texts_1.OPTION_COMPARE_DELAY);
+commandCapture.option('--waitFor <waitFors...>', texts_1.OPTION_COMPARE_WAIT_FOR);
+commandCapture.action(async (options) => {
+    const { getCiAndGitInfo, formattedCiInfo } = require('@buddy-works/ci-info');
+    const { addProtocolIfMissing } = require('../../visualTest/linkUtils');
+    const { sendCompareLinks } = require('../../visualTest/requests');
+    const { checkIfMinimalOptionsAreProvided, validateOptions } = require('./capture/validation');
+    const { createVtContext, applyToken, applyCiAndCommitInfo } = require('../../visualTest/context');
+    const validatedOptions = validateOptions(options);
+    const Input = require('../../input').default;
+    const token = await Input.vtSuiteToken();
+    if (!token) {
+        output_1.default.exitError(texts_1.ERR_MISSING_VT_TOKEN);
+    }
+    const ctx = createVtContext();
+    applyToken(ctx, token);
+    if (!checkIfMinimalOptionsAreProvided(validatedOptions)) {
+        output_1.default.exitError(texts_1.ERR_MISSING_URLS);
+    }
+    let urls = [];
+    let sitemapSource;
+    if (validatedOptions.urls) {
+        const urlsList = getUrlsFromUrlOption(validatedOptions.urls);
+        urls = urls.concat(urlsList);
+    }
+    if (validatedOptions.urlsFile) {
+        const urlsList = getUrlsFromUrlFile(validatedOptions.urlsFile);
+        urls = urls.concat(urlsList);
+    }
+    if (validatedOptions.sitemap) {
+        sitemapSource = addProtocolIfMissing(validatedOptions.sitemap);
+    }
+    const { filteredUrls, duplicates } = filterDuplicates(urls);
+    if (duplicates.length > 0) {
+        output_1.default.normal(`Detected ${duplicates.length} duplicated urls:`);
+        output_1.default.normal(duplicates.join('\n'));
+    }
+    if (validatedOptions.dryRun) {
+        output_1.default.exitSuccess(`List of urls:\n${filteredUrls.join('\n')}`);
+    }
+    else if (filteredUrls.length > 1) {
+        output_1.default.normal(`List of urls:\n${filteredUrls.join('\n')}`);
+    }
+    const ciAndGitInfo = await getCiAndGitInfo({});
+    output_1.default.normal(formattedCiInfo(ciAndGitInfo));
+    applyCiAndCommitInfo(ctx, ciAndGitInfo);
+    try {
+        const { message } = await sendCompareLinks(ctx, filteredUrls, validatedOptions, sitemapSource);
+        output_1.default.exitSuccess(message);
+    }
+    catch (error) {
+        output_1.default.exitError(`${error}`);
+    }
+});
+function getUrlsFromUrlOption(urls) {
+    const { addProtocolIfMissing } = require('../../visualTest/linkUtils');
+    return urls.split(',').map((url) => addProtocolIfMissing(url).trim());
+}
+function getUrlsFromUrlFile(urlsFile) {
+    const { addProtocolIfMissing } = require('../../visualTest/linkUtils');
+    const urlsFromFile = (0, node_fs_1.readFileSync)(urlsFile, 'utf-8');
+    return urlsFromFile
+        .split('\n')
+        .filter((url) => url.trim().length > 0)
+        .map((url) => addProtocolIfMissing(url).trim());
+}
+function filterDuplicates(urls) {
+    const seen = new Set();
+    const duplicates = new Set();
+    for (const url of urls) {
+        if (seen.has(url)) {
+            duplicates.add(url);
+        }
+        else {
+            seen.add(url);
+        }
+    }
+    return {
+        filteredUrls: Array.from(seen),
+        duplicates: Array.from(duplicates),
+    };
+}
+exports.default = commandCapture;

package/distTs/src/command/tests/unit/link.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../utils");
+const texts_1 = require("../../../texts");
+const output_1 = __importDefault(require("../../../output"));
+const commandUtLink = (0, utils_1.newCommand)('link', texts_1.DESC_COMMAND_UT_LINK);
+commandUtLink.option('-w, --workspace <workspace>', texts_1.OPTION_REST_API_WORKSPACE);
+commandUtLink.option('-p, --project <project>', texts_1.OPTION_REST_API_PROJECT);
+commandUtLink.option('-s, --suite <suite>', texts_1.OPTION_SUITE_IDENTIFIER);
+commandUtLink.action(async (options) => {
+    const Input = require('../../../input').default;
+    const ProjectCfg = require('../../../project/cfg').default;
+    output_1.default.handleSignals();
+    const workspace = Input.restApiWorkspace(options.workspace);
+    const project = Input.restApiProject(options.project);
+    const client = Input.restApiTokenClient(false, options.api, options.region);
+    let suiteIdentifier = options.suite;
+    if (!suiteIdentifier) {
+        const opt = await output_1.default.inputMenuAdv(texts_1.TXT_COMMAND_SUITE_SELECT, [
+            {
+                name: texts_1.TXT_COMMAND_SUITE_CREATE_NEW,
+                description: texts_1.TXT_COMMAND_SUITE_CREATE_NEW_UT_DESC,
+                value: 'new',
+            },
+            {
+                name: texts_1.TXT_COMMAND_SUITE_LINK_EXISTING,
+                description: texts_1.TXT_COMMAND_SUITE_LINK_EXISTING_DESC,
+                value: 'existing',
+            },
+        ]);
+        if (opt === 'new') {
+            const name = await output_1.default.inputString(texts_1.TXT_COMMAND_SUITE_NAME);
+            const response = await client.createUtSuite(workspace, project, { name, identifier: name });
+            output_1.default.okSign();
+            output_1.default.normal(texts_1.TXT_COMMAND_SUITE_CREATED);
+            suiteIdentifier = response.identifier;
+        }
+        else {
+            const result = await client.getUtSuites(workspace, project);
+            const suites = result?.suites || [];
+            if (!suites.length) {
+                output_1.default.exitError(texts_1.ERR_NO_UT_SUITES);
+            }
+            if (suites.length === 1) {
+                suiteIdentifier = suites[0].identifier;
+            }
+            else {
+                const items = suites.map((s) => s.name || s.identifier);
+                const index = await output_1.default.inputMenu(texts_1.TXT_COMMAND_UT_LINK_SELECT, items);
+                suiteIdentifier = suites[index].identifier;
+            }
+        }
+    }
+    ProjectCfg.setSuite((0, utils_1.getWorkingDir)(), 'ut', suiteIdentifier);
+    output_1.default.okSign();
+    output_1.default.exitSuccess(texts_1.TXT_COMMAND_UT_LINK_SUCCESS);
+});
+exports.default = commandUtLink;

package/distTs/src/command/tests/unit/upload.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../utils");
+const texts_1 = require("../../../texts");
+const output_1 = __importDefault(require("../../../output"));
+const commander_1 = require("commander");
+const node_path_1 = __importDefault(require("node:path"));
+const commandUtUpload = (0, utils_1.newCommand)('upload', texts_1.DESC_COMMAND_UT_UPLOAD);
+commandUtUpload.argument('<glob>', texts_1.OPTION_UPLOAD_REPORT_GLOB);
+commandUtUpload.addOption(new commander_1.Option('--format <format>', texts_1.OPTION_UPLOAD_REPORT_FORMAT)
+    .choices(['junit-xml'])
+    .makeOptionMandatory());
+commandUtUpload.option('--dryRun', texts_1.OPTION_UPLOAD_DRY_RUN);
+commandUtUpload.action(async (input, options) => {
+    const { getCiInfo } = require('../../../unitTest/ci');
+    const { sendUploadRequest } = require('../../../unitTest/requests');
+    const { createUtContext, applyUtToken, applyUtCiInfo } = require('../../../unitTest/context');
+    const Input = require('../../../input').default;
+    const ctx = createUtContext();
+    const token = await Input.utSuiteToken();
+    if (!token) {
+        output_1.default.exitError(texts_1.ERR_MISSING_UT_TOKEN);
+    }
+    applyUtToken(ctx, token);
+    const { glob, dryRun } = validateInputAndOptions(input, options);
+    const ciInfo = await getCiInfo();
+    applyUtCiInfo(ctx, ciInfo);
+    const { absolutePattern, files } = findFilesByGlob(glob);
+    if (files.length === 0) {
+        output_1.default.exitError(`No files matched the provided glob: ${absolutePattern}`);
+    }
+    if (dryRun) {
+        output_1.default.normal(`Found ${files.length} report file(s) using pattern: ${absolutePattern}`);
+        files.forEach((file) => {
+            output_1.default.normal(file);
+        });
+        output_1.default.exitSuccess('Dry run completed');
+    }
+    await sendUploadRequest(ctx, files);
+    output_1.default.exitSuccess('Upload completed');
+});
+exports.default = commandUtUpload;
+function validateInputAndOptions(input, options) {
+    const z = require('zod');
+    const { ZodError } = require('zod');
+    const globSchema = z.string();
+    const optionsSchema = z.object({
+        format: z.enum(['junit-xml']),
+        dryRun: z.boolean().optional(),
+    });
+    try {
+        const glob = globSchema.parse(input);
+        const { format, dryRun } = optionsSchema.parse(options);
+        return {
+            glob,
+            format,
+            dryRun,
+        };
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            output_1.default.exitError(error.errors.map((e) => `${e.path}: ${e.message}`).join(', '));
+        }
+        else {
+            throw error;
+        }
+    }
+}
+function findFilesByGlob(pattern) {
+    const { fdir } = require('fdir');
+    const picomatch = require('picomatch');
+    const cwd = process.cwd();
+    const scan = picomatch.scan(pattern);
+    if (!scan.isGlob) {
+        return {
+            absolutePattern: pattern,
+            files: (0, utils_1.isFile)(pattern) ? [pattern] : [],
+        };
+    }
+    if (node_path_1.default.isAbsolute(pattern)) {
+        const root = scan.base;
+        const files = new fdir().withFullPaths().glob(pattern).crawl(root).sync();
+        return { absolutePattern: pattern, files };
+    }
+    const preparedPattern = node_path_1.default.resolve(cwd, pattern);
+    const files = new fdir().withFullPaths().glob(preparedPattern).crawl().sync();
+    return { absolutePattern: preparedPattern, files };
+}

package/distTs/src/command/tests/unit.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const texts_1 = require("../../texts");
+const upload_1 = __importDefault(require("./unit/upload"));
+const link_1 = __importDefault(require("./unit/link"));
+const commandUnit = (0, utils_1.newCommand)('unit', texts_1.DESC_COMMAND_UNIT);
+commandUnit.addCommand(upload_1.default);
+commandUnit.addCommand(link_1.default);
+exports.default = commandUnit;

package/distTs/src/command/tests/visual/link.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../utils");
+const texts_1 = require("../../../texts");
+const output_1 = __importDefault(require("../../../output"));
+const commandVisualLink = (0, utils_1.newCommand)('link', texts_1.DESC_COMMAND_VT_LINK);
+commandVisualLink.option('-w, --workspace <workspace>', texts_1.OPTION_REST_API_WORKSPACE);
+commandVisualLink.option('-p, --project <project>', texts_1.OPTION_REST_API_PROJECT);
+commandVisualLink.option('-s, --suite <suite>', texts_1.OPTION_SUITE_IDENTIFIER);
+commandVisualLink.action(async (options) => {
+    const Input = require('../../../input').default;
+    const ProjectCfg = require('../../../project/cfg').default;
+    output_1.default.handleSignals();
+    const workspace = Input.restApiWorkspace(options.workspace);
+    const project = Input.restApiProject(options.project);
+    const client = Input.restApiTokenClient(false, options.api, options.region);
+    let suiteIdentifier = options.suite;
+    if (!suiteIdentifier) {
+        const opt = await output_1.default.inputMenuAdv(texts_1.TXT_COMMAND_SUITE_SELECT, [
+            {
+                name: texts_1.TXT_COMMAND_SUITE_CREATE_NEW,
+                description: texts_1.TXT_COMMAND_SUITE_CREATE_NEW_VT_DESC,
+                value: 'new',
+            },
+            {
+                name: texts_1.TXT_COMMAND_SUITE_LINK_EXISTING,
+                description: texts_1.TXT_COMMAND_SUITE_LINK_EXISTING_DESC,
+                value: 'existing',
+            },
+        ]);
+        if (opt === 'new') {
+            const name = await output_1.default.inputString(texts_1.TXT_COMMAND_SUITE_NAME);
+            const response = await client.createVtSuite(workspace, project, { name, identifier: name });
+            output_1.default.okSign();
+            output_1.default.normal(texts_1.TXT_COMMAND_SUITE_CREATED);
+            suiteIdentifier = response.identifier;
+        }
+        else {
+            const result = await client.getVtSuites(workspace, project);
+            const suites = result?.suites || [];
+            if (!suites.length) {
+                output_1.default.exitError(texts_1.ERR_NO_VT_SUITES);
+            }
+            if (suites.length === 1) {
+                suiteIdentifier = suites[0].identifier;
+            }
+            else {
+                const items = suites.map((s) => s.name || s.identifier);
+                const index = await output_1.default.inputMenu(texts_1.TXT_COMMAND_VT_LINK_SELECT, items);
+                suiteIdentifier = suites[index].identifier;
+            }
+        }
+    }
+    ProjectCfg.setSuite((0, utils_1.getWorkingDir)(), 'vt', suiteIdentifier);
+    output_1.default.okSign();
+    output_1.default.exitSuccess(texts_1.TXT_COMMAND_VT_LINK_SUCCESS);
+});
+exports.default = commandVisualLink;

package/distTs/src/command/tests/visual/session/close.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../../utils");
+const texts_1 = require("../../../../texts");
+const output_1 = __importDefault(require("../../../../output"));
+const commandSessionClose = (0, utils_1.newCommand)('close', texts_1.DESC_COMMAND_SESSION_CLOSE);
+commandSessionClose.action(async () => {
+    const { checkBuildId } = require('../../../../visualTest/validation');
+    const { closeSession } = require('../../../../visualTest/requests');
+    const { createVtContext, applyToken } = require('../../../../visualTest/context');
+    const Input = require('../../../../input').default;
+    const token = await Input.vtSuiteToken();
+    if (!token) {
+        output_1.default.exitError(texts_1.ERR_MISSING_VT_TOKEN);
+    }
+    if (!checkBuildId()) {
+        output_1.default.exitError(texts_1.ERR_MISSING_BUILD_ID);
+    }
+    const ctx = createVtContext();
+    applyToken(ctx, token);
+    try {
+        const { message } = await closeSession(ctx);
+        output_1.default.exitNormal(message);
+    }
+    catch (error) {
+        output_1.default.exitError(`${error}`);
+    }
+});
+exports.default = commandSessionClose;

package/distTs/src/command/tests/visual/session/create.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../../utils");
+const texts_1 = require("../../../../texts");
+const output_1 = __importDefault(require("../../../../output"));
+const commandSessionCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_SESSION_CREATE);
+commandSessionCreate.argument('<command>', texts_1.OPTION_EXEC_COMMAND);
+commandSessionCreate.option('--skipDiscovery', texts_1.OPTION_EXEC_SKIP_DISCOVERY);
+commandSessionCreate.option('--oneByOne', texts_1.OPTION_EXEC_ONE_BY_ONE);
+commandSessionCreate.option('--parallel', texts_1.OPTION_EXEC_PARALLEL);
+commandSessionCreate.action(async (command, options) => {
+    const which = require('which');
+    const { getCiAndGitInfo, formattedCiInfo } = require('@buddy-works/ci-info');
+    const { checkParallel } = require('../../../../visualTest/validation');
+    const { getDefaultSettings } = require('../../../../visualTest/requests');
+    const { debug, createVtContext, applyExecOptions, applyCiAndCommitInfo, applyToken } = require('../../../../visualTest/context');
+    const { createServer } = require('../../../../visualTest/server');
+    const { finishProcessingSnapshots, setDefaultSettings, showSessionLink } = require('../../../../visualTest/snapshots');
+    const { testExec } = require('../../../../visualTest/exec');
+    const { getBrowserPath } = require('../../../../visualTest/browser');
+    const Input = require('../../../../input').default;
+    const ctx = createVtContext();
+    applyExecOptions(ctx, options);
+    try {
+        const browserPath = await getBrowserPath();
+        ctx.browserPath = browserPath;
+    }
+    catch (error) {
+        output_1.default.exitError(`${error}`);
+    }
+    const token = await Input.vtSuiteToken();
+    if (!token) {
+        output_1.default.exitError(texts_1.ERR_MISSING_VT_TOKEN);
+    }
+    applyToken(ctx, token);
+    if (!checkParallel(ctx)) {
+        output_1.default.exitError(texts_1.ERR_MISSING_BUILD_ID);
+    }
+    const app = await createServer(ctx);
+    const [mainCommand, ...mainCommandArguments] = command.split(' ');
+    output_1.default.normal((0, texts_1.LOG_RUNNING_EXEC_COMMAND)(`${mainCommand} ${[...mainCommandArguments].join(' ')}`));
+    const resolved = await which(mainCommand, { nothrow: true });
+    if (!resolved) {
+        output_1.default.exitError((0, texts_1.ERR_MISSING_EXEC_COMMAND)(`${mainCommand} ${[...mainCommandArguments].join(' ')}`));
+    }
+    try {
+        let t1, t11;
+        if (debug) {
+            t1 = performance.now();
+        }
+        const defaultSettings = await getDefaultSettings(ctx);
+        setDefaultSettings(defaultSettings);
+        const ciAndGitInfo = await getCiAndGitInfo({
+            baseBranch: defaultSettings.baseBranch,
+            logger: output_1.default.warning,
+        });
+        applyCiAndCommitInfo(ctx, ciAndGitInfo);
+        output_1.default.normal(formattedCiInfo(ciAndGitInfo));
+        if (debug) {
+            t11 = performance.now();
+        }
+        const spawnedProcessExitCode = await testExec(mainCommand, [
+            ...mainCommandArguments,
+        ]);
+        if (debug && t11) {
+            const t22 = performance.now();
+            output_1.default.normal((0, texts_1.DEBUG_EXEC_TEST_COMMAND)(t22 - t11));
+        }
+        await app.close();
+        await finishProcessingSnapshots(ctx, spawnedProcessExitCode);
+        showSessionLink();
+        if (debug && t1) {
+            const t2 = performance.now();
+            output_1.default.normal((0, texts_1.DEBUG_EXEC_COMMAND)(t2 - t1));
+        }
+        process.exit(spawnedProcessExitCode);
+    }
+    catch (error) {
+        await app.close();
+        output_1.default.exitError(`${error}`);
+    }
+});
+exports.default = commandSessionCreate;

package/distTs/src/command/tests/visual/session.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../../utils");
+const texts_1 = require("../../../texts");
+const create_1 = __importDefault(require("./session/create"));
+const close_1 = __importDefault(require("./session/close"));
+const commandSession = (0, utils_1.newCommand)('session', texts_1.DESC_COMMAND_SESSION);
+commandSession.addCommand(create_1.default);
+commandSession.addCommand(close_1.default);
+exports.default = commandSession;