bdy 1.20.0-stage → 1.20.1-master

package/distTs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.20.0-stage",
+  "version": "1.20.1-master",
   "type": "commonjs",
   "license": "MIT",
   "scripts": {

package/distTs/src/command/crawl/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 commandCrawlLink = (0, utils_1.newCommand)('link', texts_1.DESC_COMMAND_CRAWL_LINK);
+commandCrawlLink.option('-w, --workspace <workspace>', texts_1.OPTION_REST_API_WORKSPACE);
+commandCrawlLink.option('-p, --project <project>', texts_1.OPTION_REST_API_PROJECT);
+commandCrawlLink.option('-s, --suite <suite>', texts_1.OPTION_SUITE_IDENTIFIER);
+commandCrawlLink.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_CRAWL_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.createCrawlSuite(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.getCrawlSuites(workspace, project);
+            const suites = result?.suites || [];
+            if (!suites.length) {
+                output_1.default.exitError(texts_1.ERR_NO_CRAWL_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_CRAWL_LINK_SELECT, items);
+                suiteIdentifier = suites[index].identifier;
+            }
+        }
+    }
+    ProjectCfg.setSuite((0, utils_1.getWorkingDir)(), 'crawl', suiteIdentifier);
+    output_1.default.okSign();
+    output_1.default.exitSuccess(texts_1.TXT_COMMAND_CRAWL_LINK_SUCCESS);
+});
+exports.default = commandCrawlLink;

package/distTs/src/command/crawl/run.js

@@ -0,0 +1,147 @@
+"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 commander_1 = require("commander");
+const texts_1 = require("../../texts");
+const output_1 = __importDefault(require("../../output"));
+const node_zlib_1 = require("node:zlib");
+const promises_1 = require("node:stream/promises");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const promises_2 = require("node:fs/promises");
+const commandCrawlRun = (0, utils_1.newCommand)('run', texts_1.DESC_COMMAND_CRAWL_RUN);
+commandCrawlRun.argument('[url]', texts_1.OPTION_CRAWL_URL);
+commandCrawlRun.option('--follow', texts_1.OPTION_CRAWL_FOLLOW, false);
+commandCrawlRun.option('--respectRobots', texts_1.OPTION_COMPARE_RESPECT_ROBOTS, false);
+commandCrawlRun.addOption(new commander_1.Option('--outputType <type>', texts_1.OPTION_CRAWL_OUTPUT_TYPE).choices([
+    'jpeg',
+    'png',
+    'md',
+    'html',
+]));
+commandCrawlRun.option('--outputTypes <json>', texts_1.OPTION_CRAWL_OUTPUT_TYPES);
+commandCrawlRun.option('--quality <quality>', texts_1.OPTION_CRAWL_QUALITY);
+commandCrawlRun.option('--fullPage', texts_1.OPTION_CRAWL_FULL_PAGE, false);
+commandCrawlRun.option('--cssSelector <selector>', texts_1.OPTION_CRAWL_CSS_SELECTOR);
+commandCrawlRun.option('--xpathSelector <selector>', texts_1.OPTION_CRAWL_XPATH_SELECTOR);
+commandCrawlRun.addOption(new commander_1.Option('--colorScheme <scheme>', texts_1.OPTION_CRAWL_COLOR_SCHEME).choices([
+    'LIGHT',
+    'DARK',
+    'LIGHT_AND_DARK',
+]));
+commandCrawlRun.option('--browsers <browsers>', texts_1.OPTION_CRAWL_BROWSERS);
+commandCrawlRun.option('--devices <devices>', texts_1.OPTION_CRAWL_DEVICES);
+commandCrawlRun.option('--waitFor <waitFors...>', texts_1.OPTION_COMPARE_WAIT_FOR);
+commandCrawlRun.option('--cookie <cookies...>', texts_1.OPTION_COMPARE_COOKIE);
+commandCrawlRun.option('--header <headers...>', texts_1.OPTION_COMPARE_HEADER);
+commandCrawlRun.option('--localStorage <items...>', texts_1.OPTION_CRAWL_LOCAL_STORAGE);
+commandCrawlRun.option('--delay <delays...>', texts_1.OPTION_CRAWL_DELAY);
+commandCrawlRun.option('--outputDir <dir>', texts_1.OPTION_CRAWL_OUTPUT_DIR, '.');
+commandCrawlRun.action(async (inputUrl, options) => {
+    const { downloadCrawlPackage, sendCrawl } = require('../../crawl/requests');
+    const { createCrawlContext, applyToken, applyCiAndCommitInfo } = require('../../visualTest/context');
+    const { validateInputAndOptions } = require('./validation');
+    const { getCiAndGitInfo } = require('@buddy-works/ci-info');
+    const tar = require('tar-stream');
+    const Input = require('../../input').default;
+    const token = await Input.crawlSuiteToken();
+    if (!token) {
+        output_1.default.exitError(texts_1.ERR_MISSING_CRAWL_TOKEN);
+    }
+    const ctx = createCrawlContext();
+    applyToken(ctx, token);
+    const { url, follow, respectRobots, outputTypes, outputDir, colorScheme, browsers, devices, cookies, requestHeaders, delays, waitForSelectors, localStorage, } = validateInputAndOptions(inputUrl, options);
+    try {
+        const ciAndGitInfo = await getCiAndGitInfo({});
+        applyCiAndCommitInfo(ctx, ciAndGitInfo);
+        const { buildId } = await sendCrawl(ctx, url, follow, respectRobots, outputTypes, colorScheme, browsers, devices, cookies, requestHeaders, delays, waitForSelectors, localStorage);
+        const status = await watchSessionStatus(ctx, buildId);
+        if (!status.ok) {
+            output_1.default.exitError(`Crawl session failed: ${status.error}`);
+        }
+        output_1.default.normal('Downloading crawl package');
+        const crawlPackageStream = await downloadCrawlPackage(ctx, buildId);
+        const brotliDecompressor = (0, node_zlib_1.createBrotliDecompress)();
+        const unpack = tar.extract();
+        unpack.on('entry', async (header, stream, next) => {
+            const currentDir = process.cwd();
+            const preparedOutputDir = outputDir.startsWith('.')
+                ? node_path_1.default.join(currentDir, outputDir)
+                : outputDir;
+            const newFilePath = node_path_1.default.join(preparedOutputDir, header.name);
+            try {
+                if (header.type === 'file') {
+                    await (0, promises_2.mkdir)(node_path_1.default.dirname(newFilePath), { recursive: true });
+                    const fileWriteStream = (0, node_fs_1.createWriteStream)(newFilePath);
+                    await (0, promises_1.pipeline)(stream, fileWriteStream);
+                    next();
+                }
+                else {
+                    stream.resume();
+                    next();
+                }
+            }
+            catch (entryError) {
+                output_1.default.error(`Error processing entry ${header.name}: ${entryError}`);
+                next(entryError);
+            }
+        });
+        await (0, promises_1.pipeline)(crawlPackageStream, brotliDecompressor, unpack);
+        output_1.default.exitSuccess('Downloading crawl package finished');
+    }
+    catch (error) {
+        output_1.default.exitError(`${error}`);
+    }
+});
+async function watchSessionStatus(ctx, buildId) {
+    const { connectToCrawlSession } = require('../../crawl/requests');
+    return new Promise((resolve) => {
+        const eventSource = connectToCrawlSession(ctx, buildId);
+        eventSource.addEventListener('SESSION_STATUS', (event) => {
+            const data = JSON.parse(event.data);
+            if (data.status === 'STARTED') {
+                output_1.default.normal('Crawl session started');
+            }
+            else if (data.status === 'GATHER_URLS_COMPLETED') {
+                output_1.default.normal(`Gathering URLs completed, found ${data.text} URLs`);
+            }
+            else if (data.status === 'GATHER_URLS_FAILED') {
+                output_1.default.error('Gathering URLs failed');
+            }
+            else if (data.status === 'CRAWL_URL_COMPLETED') {
+                output_1.default.normal(`Crawling ${data.text} completed`);
+            }
+            else if (data.status === 'CRAWL_URL_FAILED') {
+                output_1.default.error(`Crawling ${data.text} failed`);
+            }
+            else if (data.status === 'CREATE_PACKAGE_COMPLETED') {
+                output_1.default.normal('Package created');
+            }
+            else if (data.status === 'CREATE_PACKAGE_FAILED') {
+                output_1.default.error('Package creation failed');
+            }
+            else if (data.status === 'ERROR') {
+                eventSource.close();
+                resolve({ ok: false, error: data.text });
+            }
+            else if (data.status === 'FINISHED') {
+                eventSource.close();
+                output_1.default.normal('Crawl session finished');
+                resolve({ ok: true });
+            }
+        });
+        eventSource.addEventListener('error', (event) => {
+            if (event.code) {
+                eventSource.close();
+                if (event.code === 410) {
+                    output_1.default.normal('Crawl session finished');
+                }
+                resolve({ ok: event.code === 410, error: event.code });
+            }
+        });
+    });
+}
+exports.default = commandCrawlRun;

package/distTs/src/command/crawl/validation.js

@@ -0,0 +1,154 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateInputAndOptions = validateInputAndOptions;
+const zod_1 = require("zod");
+const output_1 = __importDefault(require("../../output"));
+const validation_1 = require("../tests/visual/shared/validation");
+const urlSchema = zod_1.z.string().url().optional();
+const browserSchema = zod_1.z.enum(['chrome', 'firefox', 'safari']);
+const browsersListSchema = zod_1.z
+    .string()
+    .transform((value) => value
+    .split(',')
+    .map((browser) => browser.trim().toLowerCase())
+    .filter((browser) => browser.length > 0))
+    .refine((browsers) => browsers.length > 0, {
+    message: 'Invalid browsers list. Supported values: chrome,firefox,safari',
+})
+    .pipe(zod_1.z.array(browserSchema))
+    .transform((browsers) => Array.from(new Set(browsers.map((browser) => browser === 'chrome'
+    ? 'CHROMIUM'
+    : browser === 'firefox'
+        ? 'FIREFOX'
+        : 'WEBKIT'))));
+const optionsSchema = zod_1.z.object({
+    follow: zod_1.z.boolean(),
+    respectRobots: zod_1.z.boolean().optional(),
+    outputType: zod_1.z.enum(['jpeg', 'png', 'md', 'html']).optional(),
+    outputTypes: zod_1.z.string().optional(),
+    quality: zod_1.z.coerce.number().min(1).max(100).optional(),
+    outputDir: zod_1.z.string().default('.'),
+    fullPage: zod_1.z.boolean().optional(),
+    cssSelector: zod_1.z.string().optional(),
+    xpathSelector: zod_1.z.string().optional(),
+    colorScheme: zod_1.z.enum(['LIGHT', 'DARK', 'LIGHT_AND_DARK']).optional(),
+    browsers: browsersListSchema.optional(),
+    devices: zod_1.z.string().optional(),
+    delay: validation_1.delaySchema,
+    waitFor: validation_1.waitForSchema,
+    cookie: validation_1.cookieSchema,
+    header: validation_1.headerSchema,
+    localStorage: zod_1.z
+        .array(zod_1.z.string().regex(/^(?:([^:]+)::)?([^=]+)=(.*)$/, {
+        message: "LocalStorage option must follow pattern '[scope::]key=value' (scope is optional)",
+    }))
+        .optional()
+        .transform((value) => value?.map((v) => {
+        const { scope, key, value } = (0, validation_1.parseScopedKeyValue)(v);
+        return { scope, key, value };
+    })),
+});
+function validateInputAndOptions(input, options) {
+    try {
+        const url = urlSchema.parse(input);
+        const { follow, respectRobots, outputType, outputTypes: rawOutputTypes, quality, outputDir, fullPage, cssSelector, xpathSelector, colorScheme, browsers: parsedBrowsers, devices: rawDevices, delay, waitFor, cookie, header, localStorage, } = optionsSchema.parse(options);
+        let parsedOutputTypes;
+        if (rawOutputTypes) {
+            try {
+                const outputTypeEntrySchema = zod_1.z.array(zod_1.z
+                    .object({
+                    type: zod_1.z.string().transform((v) => v.toUpperCase()),
+                    selector: zod_1.z
+                        .object({
+                        type: zod_1.z.enum(['CSS', 'XPATH']).optional(),
+                        value: zod_1.z.string().optional(),
+                    })
+                        .optional(),
+                    quality: zod_1.z.number().min(1).max(100).optional(),
+                    fullPage: zod_1.z.boolean().optional(),
+                })
+                    .transform((data) => ({
+                    ...data,
+                    type: data.type,
+                })));
+                parsedOutputTypes = outputTypeEntrySchema.parse(JSON.parse(rawOutputTypes));
+            }
+            catch {
+                output_1.default.exitError("Invalid --outputTypes value. Use JSON array, e.g. --outputTypes '[{\"type\":\"png\"},{\"type\":\"jpeg\",\"quality\":80}]'");
+            }
+        }
+        else if (outputType) {
+            if (typeof quality === 'number' && outputType !== 'jpeg') {
+                output_1.default.exitError('Quality is only supported for jpeg output type, use --outputType jpeg');
+            }
+            if (cssSelector && xpathSelector) {
+                output_1.default.exitError('Only one of --cssSelector or --xpathSelector can be used');
+            }
+            const entry = {
+                type: outputType.toUpperCase(),
+            };
+            if (cssSelector) {
+                entry.selector = { type: 'CSS', value: cssSelector };
+            }
+            else if (xpathSelector) {
+                entry.selector = { type: 'XPATH', value: xpathSelector };
+            }
+            if (typeof quality === 'number') {
+                entry.quality = quality;
+            }
+            if (fullPage) {
+                entry.fullPage = fullPage;
+            }
+            parsedOutputTypes = [entry];
+        }
+        let parsedDevices;
+        if (rawDevices) {
+            try {
+                const dimensionSchema = zod_1.z
+                    .string()
+                    .regex(/^\d+x\d+$/, 'Must be in format "widthxheight"')
+                    .transform((val) => {
+                    const [width, height] = val.split('x').map(Number);
+                    return { width, height };
+                });
+                const deviceSchema = zod_1.z.array(zod_1.z.object({
+                    name: zod_1.z.string().optional(),
+                    viewport: dimensionSchema,
+                    screen: dimensionSchema,
+                    devicePixelRatio: zod_1.z.number().positive(),
+                    isMobile: zod_1.z.boolean(),
+                }));
+                parsedDevices = deviceSchema.parse(JSON.parse(rawDevices));
+            }
+            catch {
+                output_1.default.exitError('Invalid --devices value. Use JSON array, e.g. --devices \'[{"viewport":"1920x1080","screen":"1920x1080","devicePixelRatio":1,"isMobile":false}]\'');
+            }
+        }
+        return {
+            url,
+            follow,
+            respectRobots,
+            outputTypes: parsedOutputTypes,
+            outputDir,
+            colorScheme,
+            browsers: parsedBrowsers,
+            devices: parsedDevices,
+            cookies: cookie,
+            requestHeaders: header,
+            delays: delay ?? [],
+            waitForSelectors: waitFor,
+            localStorage,
+        };
+    }
+    catch (error) {
+        if (error instanceof zod_1.ZodError) {
+            output_1.default.exitError(error.errors.map((e) => `${e.path}: ${e.message}`).join(', '));
+        }
+        else {
+            throw error;
+        }
+    }
+}

package/distTs/src/command/crawl.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 run_1 = __importDefault(require("./crawl/run"));
+const link_1 = __importDefault(require("./crawl/link"));
+const commandCrawl = (0, utils_1.newCommand)('crawl', texts_1.DESC_COMMAND_CRAWL);
+commandCrawl.addCommand(run_1.default);
+commandCrawl.addCommand(link_1.default);
+exports.default = commandCrawl;

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;