@browserstack/mcp-server 1.0.6 → 1.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,68 +0,0 @@
1
- "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
- Object.defineProperty(o, "default", { enumerable: true, value: v });
15
- }) : function(o, v) {
16
- o["default"] = v;
17
- });
18
- var __importStar = (this && this.__importStar) || (function () {
19
- var ownKeys = function(o) {
20
- ownKeys = Object.getOwnPropertyNames || function (o) {
21
- var ar = [];
22
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
- return ar;
24
- };
25
- return ownKeys(o);
26
- };
27
- return function (mod) {
28
- if (mod && mod.__esModule) return mod;
29
- var result = {};
30
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
- __setModuleDefault(result, mod);
32
- return result;
33
- };
34
- })();
35
- var __importDefault = (this && this.__importDefault) || function (mod) {
36
- return (mod && mod.__esModule) ? mod : { "default": mod };
37
- };
38
- Object.defineProperty(exports, "__esModule", { value: true });
39
- exports.uploadApp = uploadApp;
40
- const axios_1 = __importStar(require("axios"));
41
- const form_data_1 = __importDefault(require("form-data"));
42
- const fs_1 = __importDefault(require("fs"));
43
- const config_1 = __importDefault(require("../../config"));
44
- async function uploadApp(filePath) {
45
- if (!fs_1.default.existsSync(filePath)) {
46
- throw new Error(`File not found at path: ${filePath}`);
47
- }
48
- const formData = new form_data_1.default();
49
- formData.append("file", fs_1.default.createReadStream(filePath));
50
- try {
51
- const response = await axios_1.default.post("https://api-cloud.browserstack.com/app-live/upload", formData, {
52
- headers: {
53
- ...formData.getHeaders(),
54
- },
55
- auth: {
56
- username: config_1.default.browserstackUsername,
57
- password: config_1.default.browserstackAccessKey,
58
- },
59
- });
60
- return response.data;
61
- }
62
- catch (error) {
63
- if (error instanceof axios_1.AxiosError) {
64
- throw new Error(`Failed to upload app: ${error.response?.data?.message || error.message}`);
65
- }
66
- throw error;
67
- }
68
- }
@@ -1,93 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.startAppLiveSession = startAppLiveSession;
7
- exports.default = addAppLiveTools;
8
- const zod_1 = require("zod");
9
- const fs_1 = __importDefault(require("fs"));
10
- const upload_app_1 = require("./applive-utils/upload-app");
11
- const start_session_1 = require("./applive-utils/start-session");
12
- const logger_1 = __importDefault(require("../logger"));
13
- /**
14
- * Launches an App Live Session on BrowserStack.
15
- */
16
- async function startAppLiveSession(args) {
17
- if (!args.desiredPlatform) {
18
- throw new Error("You must provide a desiredPlatform.");
19
- }
20
- if (!args.appPath) {
21
- throw new Error("You must provide a appPath.");
22
- }
23
- if (!args.desiredPhone) {
24
- throw new Error("You must provide a desiredPhone.");
25
- }
26
- if (args.desiredPlatform === "android" && !args.appPath.endsWith(".apk")) {
27
- throw new Error("You must provide a valid Android app path.");
28
- }
29
- if (args.desiredPlatform === "ios" && !args.appPath.endsWith(".ipa")) {
30
- throw new Error("You must provide a valid iOS app path.");
31
- }
32
- // check if the app path exists && is readable
33
- try {
34
- if (!fs_1.default.existsSync(args.appPath)) {
35
- throw new Error("The app path does not exist.");
36
- }
37
- fs_1.default.accessSync(args.appPath, fs_1.default.constants.R_OK);
38
- }
39
- catch (error) {
40
- logger_1.default.error("The app path does not exist or is not readable: %s", error);
41
- throw new Error("The app path does not exist or is not readable.");
42
- }
43
- const { app_url } = await (0, upload_app_1.uploadApp)(args.appPath);
44
- if (!app_url.match("bs://")) {
45
- throw new Error("The app path is not a valid BrowserStack app URL.");
46
- }
47
- const launchUrl = await (0, start_session_1.startSession)({
48
- appUrl: app_url,
49
- desiredPlatform: args.desiredPlatform,
50
- desiredPhone: args.desiredPhone,
51
- desiredPlatformVersion: args.desiredPlatformVersion,
52
- });
53
- return {
54
- content: [
55
- {
56
- type: "text",
57
- text: `Successfully started a session. If a browser window did not open automatically, use the following URL to start the session: ${launchUrl}`,
58
- },
59
- ],
60
- };
61
- }
62
- function addAppLiveTools(server) {
63
- server.tool("runAppLiveSession", "Use this tool when user wants to manually check their app on a particular mobile device using BrowserStack's cloud infrastructure. Can be used to debug crashes, slow performance, etc.", {
64
- desiredPhone: zod_1.z
65
- .string()
66
- .describe("The full name of the device to run the app on. Example: 'iPhone 12 Pro' or 'Samsung Galaxy S20' or 'Google Pixel 6'. Always ask the user for the device they want to use, do not assume it. "),
67
- desiredPlatformVersion: zod_1.z
68
- .string()
69
- .describe("The platform version to run the app on. Example: '12.0' for Android devices or '16.0' for iOS devices"),
70
- desiredPlatform: zod_1.z
71
- .enum(["android", "ios"])
72
- .describe("Which platform to run on, examples: 'android', 'ios'. Set this based on the app path provided."),
73
- appPath: zod_1.z
74
- .string()
75
- .describe("The path to the .ipa or .apk file to install on the device. Always ask the user for the app path, do not assume it."),
76
- }, async (args) => {
77
- try {
78
- return startAppLiveSession(args);
79
- }
80
- catch (error) {
81
- return {
82
- content: [
83
- {
84
- type: "text",
85
- text: `Failed to start an app live session. Error: ${error}. Please open an issue on GitHub if the problem persists`,
86
- isError: true,
87
- },
88
- ],
89
- isError: true,
90
- };
91
- }
92
- });
93
- }
@@ -1,52 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.getNetworkFailures = getNetworkFailures;
7
- exports.default = addAutomateTools;
8
- const zod_1 = require("zod");
9
- const logger_1 = __importDefault(require("../logger"));
10
- const api_1 = require("../lib/api");
11
- /**
12
- * Fetches failed network requests from a BrowserStack Automate session.
13
- * Returns network requests that resulted in errors or failed to complete.
14
- */
15
- async function getNetworkFailures(args) {
16
- try {
17
- const failureLogs = await (0, api_1.retrieveNetworkFailures)(args.sessionId);
18
- logger_1.default.info("Successfully fetched failure network logs for session: %s", args.sessionId);
19
- // Check if there are any failures
20
- const hasFailures = failureLogs.totalFailures > 0;
21
- const text = hasFailures
22
- ? `${failureLogs.totalFailures} network failure(s) found for session :\n\n${JSON.stringify(failureLogs.failures, null, 2)}`
23
- : `No network failures found for session`;
24
- return {
25
- content: [
26
- {
27
- type: "text",
28
- text,
29
- },
30
- ],
31
- };
32
- }
33
- catch (error) {
34
- const errorMessage = error instanceof Error ? error.message : "An unknown error occurred";
35
- logger_1.default.error("Failed to fetch network logs: %s", errorMessage);
36
- return {
37
- content: [
38
- {
39
- type: "text",
40
- text: `Failed to fetch network logs: ${errorMessage}`,
41
- isError: true,
42
- },
43
- ],
44
- isError: true,
45
- };
46
- }
47
- }
48
- function addAutomateTools(server) {
49
- server.tool("getNetworkFailures", "Use this tool to fetch failed network requests from a BrowserStack Automate session.", {
50
- sessionId: zod_1.z.string().describe("The Automate session ID."),
51
- }, getNetworkFailures);
52
- }
@@ -1,64 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.bootstrapProjectWithSDK = bootstrapProjectWithSDK;
4
- exports.default = addSDKTools;
5
- const zod_1 = require("zod");
6
- const instructions_1 = require("./sdk-utils/instructions");
7
- /**
8
- * BrowserStack SDK hooks into your test framework to seamlessly run tests on BrowserStack.
9
- * This tool gives instructions to setup a browserstack.yml file in the project root and installs the necessary dependencies.
10
- */
11
- async function bootstrapProjectWithSDK({ detectedBrowserAutomationFramework, detectedTestingFramework, detectedLanguage, desiredPlatforms, }) {
12
- const instructions = (0, instructions_1.generateBrowserStackYMLInstructions)(desiredPlatforms);
13
- const instructionsForProjectConfiguration = (0, instructions_1.getInstructionsForProjectConfiguration)(detectedBrowserAutomationFramework, detectedTestingFramework, detectedLanguage);
14
- return {
15
- content: [
16
- {
17
- type: "text",
18
- text: `${instructions}\n\n After creating the browserstack.yml file above, do the following: ${instructionsForProjectConfiguration}`,
19
- isError: false,
20
- },
21
- ],
22
- };
23
- }
24
- function addSDKTools(server) {
25
- server.tool("runTestsOnBrowserStack", "Use this tool to get instructions for running tests on BrowserStack.", {
26
- detectedBrowserAutomationFramework: zod_1.z
27
- .string()
28
- .describe("The automation framework configured in the project. Example: 'playwright', 'selenium'"),
29
- detectedTestingFramework: zod_1.z
30
- .string()
31
- .describe("The testing framework used in the project. Example: 'jest', 'pytest'"),
32
- detectedLanguage: zod_1.z
33
- .string()
34
- .describe("The programming language used in the project. Example: 'nodejs', 'python'"),
35
- desiredPlatforms: zod_1.z
36
- .array(zod_1.z.enum(["windows", "macos", "android", "ios"]))
37
- .describe("The platforms the user wants to test on. Always ask this to the user, do not try to infer this."),
38
- }, async (args) => {
39
- const detectedBrowserAutomationFramework = args.detectedBrowserAutomationFramework;
40
- const detectedTestingFramework = args.detectedTestingFramework;
41
- const detectedLanguage = args.detectedLanguage;
42
- const desiredPlatforms = args.desiredPlatforms;
43
- try {
44
- return bootstrapProjectWithSDK({
45
- detectedBrowserAutomationFramework,
46
- detectedTestingFramework,
47
- detectedLanguage,
48
- desiredPlatforms,
49
- });
50
- }
51
- catch (error) {
52
- return {
53
- content: [
54
- {
55
- type: "text",
56
- text: `Failed to bootstrap project with BrowserStack SDK. Error: ${error}. Please open an issue on GitHub if the problem persists`,
57
- isError: true,
58
- },
59
- ],
60
- isError: true,
61
- };
62
- }
63
- });
64
- }
@@ -1,58 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.startBrowserSession = startBrowserSession;
7
- const utils_1 = require("../../lib/utils");
8
- const logger_1 = __importDefault(require("../../logger"));
9
- const child_process_1 = __importDefault(require("child_process"));
10
- async function startBrowserSession(args) {
11
- // Sanitize all input parameters
12
- const sanitizedArgs = {
13
- browser: (0, utils_1.sanitizeUrlParam)(args.browser),
14
- os: (0, utils_1.sanitizeUrlParam)(args.os),
15
- osVersion: (0, utils_1.sanitizeUrlParam)(args.osVersion),
16
- url: (0, utils_1.sanitizeUrlParam)(args.url),
17
- browserVersion: (0, utils_1.sanitizeUrlParam)(args.browserVersion),
18
- isLocal: args.isLocal,
19
- };
20
- // Construct URL with encoded parameters
21
- const params = new URLSearchParams({
22
- os: sanitizedArgs.os,
23
- os_version: sanitizedArgs.osVersion,
24
- browser: sanitizedArgs.browser,
25
- browser_version: sanitizedArgs.browserVersion,
26
- scale_to_fit: "true",
27
- url: sanitizedArgs.url,
28
- resolution: "responsive-mode",
29
- speed: "1",
30
- local: sanitizedArgs.isLocal ? "true" : "false",
31
- start: "true",
32
- });
33
- const launchUrl = `https://live.browserstack.com/dashboard#${params.toString()}`;
34
- try {
35
- // Use platform-specific commands with proper escaping
36
- const command = process.platform === "darwin"
37
- ? ["open", launchUrl]
38
- : process.platform === "win32"
39
- ? ["cmd", "/c", "start", launchUrl]
40
- : ["xdg-open", launchUrl];
41
- // nosemgrep:javascript.lang.security.detect-child-process.detect-child-process
42
- const child = child_process_1.default.spawn(command[0], command.slice(1), {
43
- stdio: "ignore",
44
- detached: true,
45
- });
46
- // Handle process errors
47
- child.on("error", (error) => {
48
- logger_1.default.error(`Failed to open browser automatically: ${error}. Please open this URL manually: ${launchUrl}`);
49
- });
50
- // Unref the child process to allow the parent to exit
51
- child.unref();
52
- return launchUrl;
53
- }
54
- catch (error) {
55
- logger_1.default.error(`Failed to open browser automatically: ${error}. Please open this URL manually: ${launchUrl}`);
56
- return launchUrl;
57
- }
58
- }
@@ -1,97 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.startBrowserLiveSession = startBrowserLiveSession;
7
- exports.default = addBrowserLiveTools;
8
- const zod_1 = require("zod");
9
- const start_session_1 = require("./live-utils/start-session");
10
- const logger_1 = __importDefault(require("../logger"));
11
- const local_1 = require("../lib/local");
12
- /**
13
- * Launches a Browser Live Session on BrowserStack.
14
- */
15
- async function startBrowserLiveSession(args) {
16
- if (!args.desiredBrowser) {
17
- throw new Error("You must provide a desiredBrowser.");
18
- }
19
- if (!args.desiredURL) {
20
- throw new Error("You must provide a desiredURL.");
21
- }
22
- if (!args.desiredOS) {
23
- throw new Error("You must provide a desiredOS.");
24
- }
25
- if (!args.desiredOSVersion) {
26
- throw new Error("You must provide a desiredOSVersion.");
27
- }
28
- if (!args.desiredBrowserVersion) {
29
- throw new Error("You must provide a desiredBrowserVersion.");
30
- }
31
- // Validate URL format
32
- try {
33
- new URL(args.desiredURL);
34
- }
35
- catch (error) {
36
- logger_1.default.error("Invalid URL format: %s", error);
37
- throw new Error("The provided URL is invalid.");
38
- }
39
- const isLocal = (0, local_1.isLocalURL)(args.desiredURL);
40
- if (isLocal) {
41
- await (0, local_1.ensureLocalBinarySetup)();
42
- }
43
- else {
44
- await (0, local_1.killExistingBrowserStackLocalProcesses)();
45
- }
46
- const launchUrl = await (0, start_session_1.startBrowserSession)({
47
- browser: args.desiredBrowser,
48
- os: args.desiredOS,
49
- osVersion: args.desiredOSVersion,
50
- url: args.desiredURL,
51
- browserVersion: args.desiredBrowserVersion,
52
- isLocal,
53
- });
54
- return {
55
- content: [
56
- {
57
- type: "text",
58
- text: `Successfully started a browser session. If a browser window did not open automatically, use the following URL to start the session: ${launchUrl}`,
59
- },
60
- ],
61
- };
62
- }
63
- function addBrowserLiveTools(server) {
64
- server.tool("runBrowserLiveSession", "Use this tool when user wants to manually check their website on a particular browser and OS combination using BrowserStack's cloud infrastructure. Can be used to debug layout issues, compatibility problems, etc.", {
65
- desiredBrowser: zod_1.z
66
- .enum(["Chrome", "IE", "Firefox", "Safari", "Edge"])
67
- .describe("The browser to run the test on. Example: 'Chrome', 'IE', 'Safari', 'Edge'. Always ask the user for the browser they want to use, do not assume it."),
68
- desiredOSVersion: zod_1.z
69
- .string()
70
- .describe("The OS version to run the browser on. Example: '10' for Windows, '12' for macOS, '14' for iOS"),
71
- desiredOS: zod_1.z
72
- .enum(["Windows", "OS X"])
73
- .describe("The operating system to run the browser on. Example: 'Windows', 'OS X'"),
74
- desiredURL: zod_1.z
75
- .string()
76
- .describe("The URL of the website to test. This can be a local URL (e.g., http://localhost:3000) or a public URL. Always ask the user for the URL, do not assume it."),
77
- desiredBrowserVersion: zod_1.z
78
- .string()
79
- .describe("The version of the browser to use. Example: 133.0, 134.0, 87.0"),
80
- }, async (args) => {
81
- try {
82
- return startBrowserLiveSession(args);
83
- }
84
- catch (error) {
85
- return {
86
- content: [
87
- {
88
- type: "text",
89
- text: `Failed to start a browser live session. Error: ${error}. Please open an issue on GitHub if the problem persists`,
90
- isError: true,
91
- },
92
- ],
93
- isError: true,
94
- };
95
- }
96
- });
97
- }
@@ -1,58 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getFailuresInLastRun = getFailuresInLastRun;
4
- exports.default = addObservabilityTools;
5
- const zod_1 = require("zod");
6
- const api_1 = require("../lib/api");
7
- async function getFailuresInLastRun(buildName, projectName) {
8
- const buildsData = await (0, api_1.getLatestO11YBuildInfo)(buildName, projectName);
9
- const observabilityUrl = buildsData.observability_url;
10
- if (!observabilityUrl) {
11
- throw new Error("No observability URL found in build data, this is likely because the build is not yet available on BrowserStack Observability.");
12
- }
13
- let overview = "No overview available";
14
- if (buildsData.unique_errors?.overview?.insight) {
15
- overview = buildsData.unique_errors.overview.insight;
16
- }
17
- let details = "No error details available";
18
- if (buildsData.unique_errors?.top_unique_errors?.length > 0) {
19
- details = buildsData.unique_errors.top_unique_errors
20
- .map((error) => error.error)
21
- .filter(Boolean)
22
- .join("\n");
23
- }
24
- return {
25
- content: [
26
- {
27
- type: "text",
28
- text: `Observability URL: ${observabilityUrl}\nOverview: ${overview}\nError Details: ${details}`,
29
- },
30
- ],
31
- };
32
- }
33
- function addObservabilityTools(server) {
34
- server.tool("getFailuresInLastRun", "Use this tool to debug failures in the last run of the test suite on BrowserStack. Use only when browserstack.yml file is present in the project root.", {
35
- buildName: zod_1.z
36
- .string()
37
- .describe("Name of the build to get failures for. This is the 'build' key in the browserstack.yml file. If not sure, ask the user for the build name."),
38
- projectName: zod_1.z
39
- .string()
40
- .describe("Name of the project to get failures for. This is the 'projectName' key in the browserstack.yml file. If not sure, ask the user for the project name."),
41
- }, async (args) => {
42
- try {
43
- return getFailuresInLastRun(args.buildName, args.projectName);
44
- }
45
- catch (error) {
46
- return {
47
- content: [
48
- {
49
- type: "text",
50
- text: `Failed to get failures in the last run. Error: ${error}. Please open an issue on GitHub if this is an issue with BrowserStack`,
51
- isError: true,
52
- },
53
- ],
54
- isError: true,
55
- };
56
- }
57
- });
58
- }
@@ -1,64 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.SUPPORTED_CONFIGURATIONS = void 0;
7
- const config_1 = __importDefault(require("../../config"));
8
- const nodejsInstructions = `
9
- - Ensure that \`browserstack-node-sdk\` is present in package.json, use the latest version.
10
- - Add new scripts to package.json for running tests on BrowserStack (use \`npx\` to trigger the sdk):
11
- \`\`\`json
12
- "scripts": {
13
- "test:browserstack": "npx browserstack-node-sdk <framework-specific-test-execution-command>"
14
- }
15
- \`\`\`
16
- - Add to dependencies:
17
- \`\`\`json
18
- "browserstack-node-sdk": "latest"
19
- \`\`\`
20
- - Inform user to export BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY as environment variables.
21
- `;
22
- const pythonInstructions = `
23
- Run the following command to install the browserstack-sdk:
24
- \`\`\`bash
25
- python3 -m pip install browserstack-sdk
26
- \`\`\`
27
-
28
- Run the following command to setup the browserstack-sdk:
29
- \`\`\`bash
30
- browserstack-sdk setup --username "${config_1.default.browserstackUsername}" --key "${config_1.default.browserstackAccessKey}"
31
- \`\`\`
32
-
33
- In order to run tests on BrowserStack, run the following command:
34
- \`\`\`bash
35
- browserstack-sdk python <path-to-test-file>
36
- \`\`\`
37
- `;
38
- exports.SUPPORTED_CONFIGURATIONS = {
39
- nodejs: {
40
- playwright: {
41
- jest: { instructions: nodejsInstructions },
42
- codeceptjs: { instructions: nodejsInstructions },
43
- playwright: { instructions: nodejsInstructions },
44
- },
45
- selenium: {
46
- jest: { instructions: nodejsInstructions },
47
- webdriverio: { instructions: nodejsInstructions },
48
- mocha: { instructions: nodejsInstructions },
49
- cucumber: { instructions: nodejsInstructions },
50
- nightwatch: { instructions: nodejsInstructions },
51
- codeceptjs: { instructions: nodejsInstructions },
52
- },
53
- },
54
- python: {
55
- playwright: {
56
- pytest: { instructions: pythonInstructions },
57
- },
58
- selenium: {
59
- pytest: { instructions: pythonInstructions },
60
- robot: { instructions: pythonInstructions },
61
- behave: { instructions: pythonInstructions },
62
- },
63
- },
64
- };
@@ -1,64 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getInstructionsForProjectConfiguration = void 0;
4
- exports.generateBrowserStackYMLInstructions = generateBrowserStackYMLInstructions;
5
- const constants_1 = require("./constants");
6
- const errorMessageSuffix = "Please open an issue at our Github repo: https://github.com/browserstack/browserstack-mcp-server/issues to request support for your project configuration";
7
- const getInstructionsForProjectConfiguration = (detectedBrowserAutomationFramework, detectedTestingFramework, detectedLanguage) => {
8
- const configuration = constants_1.SUPPORTED_CONFIGURATIONS[detectedLanguage];
9
- if (!configuration) {
10
- throw new Error(`BrowserStack MCP Server currently does not support ${detectedLanguage}, ${errorMessageSuffix}`);
11
- }
12
- if (!configuration[detectedBrowserAutomationFramework]) {
13
- throw new Error(`BrowserStack MCP Server currently does not support ${detectedBrowserAutomationFramework} for ${detectedLanguage}, ${errorMessageSuffix}`);
14
- }
15
- if (!configuration[detectedBrowserAutomationFramework][detectedTestingFramework]) {
16
- throw new Error(`BrowserStack MCP Server currently does not support ${detectedTestingFramework} for ${detectedBrowserAutomationFramework} on ${detectedLanguage}, ${errorMessageSuffix}`);
17
- }
18
- return configuration[detectedBrowserAutomationFramework][detectedTestingFramework].instructions;
19
- };
20
- exports.getInstructionsForProjectConfiguration = getInstructionsForProjectConfiguration;
21
- function generateBrowserStackYMLInstructions(desiredPlatforms) {
22
- return `
23
- Create a browserstack.yml file in the project root. The file should be in the following format:
24
-
25
- \`\`\`yaml
26
- # ======================
27
- # BrowserStack Reporting
28
- # ======================
29
- projectName: BrowserStack MCP Runs
30
- build: mcp-run
31
-
32
- # =======================================
33
- # Platforms (Browsers / Devices to test)
34
- # =======================================
35
- # Platforms object contains all the browser / device combinations you want to test on.
36
- # Generate this on the basis of the following platforms requested by the user:
37
- # Requested platforms: ${desiredPlatforms}
38
- platforms:
39
- - os: Windows
40
- osVersion: 11
41
- browserName: chrome
42
- browserVersion: latest
43
-
44
- # =======================
45
- # Parallels per Platform
46
- # =======================
47
- # The number of parallel threads to be used for each platform set.
48
- # BrowserStack's SDK runner will select the best strategy based on the configured value
49
- #
50
- # Example 1 - If you have configured 3 platforms and set \`parallelsPerPlatform\` as 2, a total of 6 (2 * 3) parallel threads will be used on BrowserStack
51
- #
52
- # Example 2 - If you have configured 1 platform and set \`parallelsPerPlatform\` as 5, a total of 5 (1 * 5) parallel threads will be used on BrowserStack
53
- parallelsPerPlatform: 1
54
-
55
- browserstackLocal: true
56
-
57
- # ===================
58
- # Debugging features
59
- # ===================
60
- debug: true
61
- testObservability: true
62
- \`\`\`
63
- \n`;
64
- }
@@ -1,2 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });