@browserstack/mcp-server 1.2.1 → 1.2.2-beta.1

package/dist/tools/percy-snapshot-utils/types.d.ts

@@ -0,0 +1,15 @@
+import { SDKSupportedTestingFrameworkEnum, SDKSupportedLanguageEnum } from "../sdk-utils/common/types.js";
+export type ListTestFilesParams = {
+    dirs: string[];
+    language: SDKSupportedLanguageEnum;
+    framework?: SDKSupportedTestingFrameworkEnum;
+};
+export interface DetectionConfig {
+    extensions: string[];
+    namePatterns: RegExp[];
+    contentRegex: RegExp[];
+    uiDriverRegex: RegExp[];
+    uiIndicatorRegex: RegExp[];
+    backendRegex: RegExp[];
+    excludeRegex?: RegExp[];
+}

package/dist/tools/percy-snapshot-utils/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function updateFileAndStep(file: string, idx: number, total: number, instruction: string): Promise<{
+    type: "text";
+    text: string;
+}[]>;

package/dist/tools/percy-snapshot-utils/utils.js

@@ -0,0 +1,30 @@
+const content = [];
+export async function updateFileAndStep(file, idx, total, instruction) {
+    content.length = 0;
+    const nextIndex = idx + 1;
+    content.push({
+        type: "text",
+        text: `Complete all steps in order. If a tool call is requested, update the file first, then call the tool. Follow instructions exactly— do not skip any steps to ensure all files are updated.`,
+    });
+    content.push({
+        type: "text",
+        text: `Step 1 : You need to add percy snapshot commands in some key test cases in the file ${file} use the following instructions: \n${instruction}`,
+    });
+    content.push({
+        type: "text",
+        text: `Step 2 : Confirm that Percy snapshot commands have been added at all key points of visual change in the file ${file}.`,
+    });
+    if (nextIndex < total) {
+        content.push({
+            type: "text",
+            text: `Step 3 : Call the tool updateTestFileWithInstructions with index as ${nextIndex} out of ${total}`,
+        });
+    }
+    if (nextIndex === total) {
+        content.push({
+            type: "text",
+            text: `Step 4: Percy snapshot commands have been added to all files. You can now run the Percy build using the above command.`,
+        });
+    }
+    return content;
+}

package/dist/tools/sdk-utils/{commands.d.ts → bstack/commands.d.ts}

@@ -1,3 +1,3 @@
-import { SDKSupportedLanguage } from "./types.js";
+import { SDKSupportedLanguage } from "../common/types.js";
 export declare function getSDKPrefixCommand(language: SDKSupportedLanguage, framework: string, username: string, accessKey: string): string;
 export declare function getJavaFrameworkForMaven(framework: string): string;

package/dist/tools/sdk-utils/bstack/commands.js

@@ -0,0 +1,88 @@
+// Constants
+const MAVEN_ARCHETYPE_GROUP_ID = "com.browserstack";
+const MAVEN_ARCHETYPE_ARTIFACT_ID = "browserstack-sdk-archetype-integrate";
+const MAVEN_ARCHETYPE_VERSION = "1.0";
+// Mapping of test frameworks to their corresponding Maven archetype framework names
+const JAVA_FRAMEWORK_MAP = {
+    testng: "testng",
+    junit5: "junit5",
+    junit4: "junit4",
+    cucumber: "cucumber-testng",
+};
+// Template for Node.js SDK setup instructions
+const NODEJS_SDK_INSTRUCTIONS = (username, accessKey) => `---STEP---
+Install BrowserStack Node SDK using command:
+\`\`\`bash
+npm i -D browserstack-node-sdk@latest
+\`\`\`
+---STEP---
+Run the following command to setup browserstack sdk:
+\`\`\`bash
+npx setup --username ${username} --key ${accessKey}
+\`\`\``;
+// Template for Gradle setup instructions (platform-independent)
+const GRADLE_SETUP_INSTRUCTIONS = `
+**For Gradle setup:**
+1. Add browserstack-java-sdk to dependencies:
+   compileOnly 'com.browserstack:browserstack-java-sdk:latest.release'
+
+2. Add browserstackSDK path variable:
+   def browserstackSDKArtifact = configurations.compileClasspath.resolvedConfiguration.resolvedArtifacts.find { it.name == 'browserstack-java-sdk' }
+
+3. Add javaagent to gradle tasks:
+   jvmArgs "-javaagent:\${browserstackSDKArtifact.file}"
+`;
+// Generates Maven archetype command for Windows platform
+function getMavenCommandForWindows(framework, mavenFramework) {
+    return (`mvn archetype:generate -B ` +
+        `-DarchetypeGroupId="${MAVEN_ARCHETYPE_GROUP_ID}" ` +
+        `-DarchetypeArtifactId="${MAVEN_ARCHETYPE_ARTIFACT_ID}" ` +
+        `-DarchetypeVersion="${MAVEN_ARCHETYPE_VERSION}" ` +
+        `-DgroupId="${MAVEN_ARCHETYPE_GROUP_ID}" ` +
+        `-DartifactId="${MAVEN_ARCHETYPE_ARTIFACT_ID}" ` +
+        `-Dversion="${MAVEN_ARCHETYPE_VERSION}" ` +
+        `-DBROWSERSTACK_USERNAME="${process.env.BROWSERSTACK_USERNAME}" ` +
+        `-DBROWSERSTACK_ACCESS_KEY="${process.env.BROWSERSTACK_ACCESS_KEY}" ` +
+        `-DBROWSERSTACK_FRAMEWORK="${mavenFramework}"`);
+}
+// Generates Maven archetype command for Unix-like platforms (macOS/Linux)
+function getMavenCommandForUnix(username, accessKey, mavenFramework) {
+    return `mvn archetype:generate -B -DarchetypeGroupId=${MAVEN_ARCHETYPE_GROUP_ID} \\
+-DarchetypeArtifactId=${MAVEN_ARCHETYPE_ARTIFACT_ID} -DarchetypeVersion=${MAVEN_ARCHETYPE_VERSION} \\
+-DgroupId=${MAVEN_ARCHETYPE_GROUP_ID} -DartifactId=${MAVEN_ARCHETYPE_ARTIFACT_ID} -Dversion=${MAVEN_ARCHETYPE_VERSION} \\
+-DBROWSERSTACK_USERNAME="${username}" \\
+-DBROWSERSTACK_ACCESS_KEY="${accessKey}" \\
+-DBROWSERSTACK_FRAMEWORK="${mavenFramework}"`;
+}
+// Generates Java SDK setup instructions with Maven/Gradle options
+function getJavaSDKInstructions(framework, username, accessKey) {
+    const mavenFramework = getJavaFrameworkForMaven(framework);
+    const isWindows = process.platform === "win32";
+    const platformLabel = isWindows ? "Windows" : "macOS/Linux";
+    const mavenCommand = isWindows
+        ? getMavenCommandForWindows(framework, mavenFramework)
+        : getMavenCommandForUnix(username, accessKey, mavenFramework);
+    return `---STEP---
+Install BrowserStack Java SDK
+
+**Maven command for ${framework} (${platformLabel}):**
+Run the command, it is required to generate the browserstack-sdk-archetype-integrate project:
+${mavenCommand}
+
+Alternative setup for Gradle users:
+${GRADLE_SETUP_INSTRUCTIONS}`;
+}
+// Main function to get SDK setup commands based on language and framework
+export function getSDKPrefixCommand(language, framework, username, accessKey) {
+    switch (language) {
+        case "nodejs":
+            return NODEJS_SDK_INSTRUCTIONS(username, accessKey);
+        case "java":
+            return getJavaSDKInstructions(framework, username, accessKey);
+        default:
+            return "";
+    }
+}
+export function getJavaFrameworkForMaven(framework) {
+    return JAVA_FRAMEWORK_MAP[framework] || framework;
+}

package/dist/tools/sdk-utils/bstack/configUtils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Utilities for generating BrowserStack configuration files.
+ */
+export declare function generateBrowserStackYMLInstructions(desiredPlatforms: string[], enablePercy: boolean | undefined, projectName: string): string;

package/dist/tools/sdk-utils/bstack/configUtils.js

@@ -0,0 +1,66 @@
+/**
+ * Utilities for generating BrowserStack configuration files.
+ */
+export function generateBrowserStackYMLInstructions(desiredPlatforms, enablePercy = false, projectName) {
+    let ymlContent = `
+# ======================
+# BrowserStack Reporting
+# ======================
+# A single name for your project to organize all your tests. This is required for Percy.
+projectName: ${projectName}
+# TODO: Replace these sample values with your actual project details
+buildName: Sample-Build
+
+# =======================================
+# Platforms (Browsers / Devices to test)
+# =======================================
+# Platforms object contains all the browser / device combinations you want to test on.
+# Generate this on the basis of the following platforms requested by the user:
+# Requested platforms: ${desiredPlatforms}
+platforms:
+  - os: Windows
+    osVersion: 11
+    browserName: chrome
+    browserVersion: latest
+  
+# =======================
+# Parallels per Platform
+# =======================
+# The number of parallel threads to be used for each platform set.
+# BrowserStack's SDK runner will select the best strategy based on the configured value
+#
+# 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
+#
+# 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
+parallelsPerPlatform: 1
+
+# =================
+# Local Testing
+# =================
+# Set to true to test local
+browserstackLocal: true
+
+# ===================
+# Debugging features
+# ===================
+debug: true # Visual logs, text logs, etc.
+testObservability: true # For Test Observability`;
+    if (enablePercy) {
+        ymlContent += `
+
+# =====================
+# Percy Visual Testing
+# =====================
+# Set percy to true to enable visual testing.
+# Set percyCaptureMode to 'manual' to control when screenshots are taken.
+percy: true
+percyCaptureMode: manual`;
+    }
+    return `
+---STEP---
+Create a browserstack.yml file in the project root. The file should be in the following format:
+
+\`\`\`yaml${ymlContent}
+\`\`\`
+\n`;
+}

package/dist/tools/sdk-utils/bstack/constants.d.ts

@@ -0,0 +1,58 @@
+import { ConfigMapping } from "../common/types.js";
+/**
+ * ---------- PYTHON INSTRUCTIONS ----------
+ */
+export declare const pythonInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+export declare const generatePythonFrameworkInstructions: (framework: string) => (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+export declare const robotInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+export declare const behaveInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+export declare const pytestInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+export declare const javaInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+/**
+ * ---------- CSharp INSTRUCTIONS ----------
+ */
+export declare const csharpCommonInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+export declare const csharpPlaywrightCommonInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+/**
+ * ---------- NODEJS INSTRUCTIONS ----------
+ */
+export declare const nodejsInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+/**
+ * ---------- EXPORT CONFIG ----------
+ */
+export declare const webdriverioInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+export declare const cypressInstructions: (username: string, accessKey: string) => {
+    setup: string;
+    run: string;
+};
+export declare const SUPPORTED_CONFIGURATIONS: ConfigMapping;

package/dist/tools/sdk-utils/{constants.js → bstack/constants.js}

@@ -1,7 +1,8 @@
 /**
  * ---------- PYTHON INSTRUCTIONS ----------
  */
-const pythonInstructions = (username, accessKey) => `
+export const pythonInstructions = (username, accessKey) => {
+    const setup = `
 ---STEP---
 
 Install the BrowserStack SDK:
@@ -15,7 +16,8 @@ Setup the BrowserStack SDK with your credentials:
 \`\`\`bash
 browserstack-sdk setup --username "${username}" --key "${accessKey}"
 \`\`\`
-
+`;
+    const run = `
 ---STEP---
 
 Run your tests on BrowserStack:
@@ -23,7 +25,10 @@ Run your tests on BrowserStack:
 browserstack-sdk python <path-to-test-file>
 \`\`\`
 `;
-const generatePythonFrameworkInstructions = (framework) => (username, accessKey) => `
+    return { setup, run };
+};
+export const generatePythonFrameworkInstructions = (framework) => (username, accessKey) => {
+    const setup = `
 ---STEP---
 
 Install the BrowserStack SDK:
@@ -38,7 +43,8 @@ Setup the BrowserStack SDK with framework-specific configuration:
 \`\`\`bash
 browserstack-sdk setup --framework "${framework}" --username "${username}" --key "${accessKey}"
 \`\`\`
-
+`;
+    const run = `
 ---STEP---
 
 Run your ${framework} tests on BrowserStack:
@@ -46,14 +52,17 @@ Run your ${framework} tests on BrowserStack:
 browserstack-sdk ${framework} <path-to-test-files>
 \`\`\`
 `;
-const robotInstructions = generatePythonFrameworkInstructions("robot");
-const behaveInstructions = generatePythonFrameworkInstructions("behave");
-const pytestInstructions = generatePythonFrameworkInstructions("pytest");
+    return { setup, run };
+};
+export const robotInstructions = generatePythonFrameworkInstructions("robot");
+export const behaveInstructions = generatePythonFrameworkInstructions("behave");
+export const pytestInstructions = generatePythonFrameworkInstructions("pytest");
 /**
  * ---------- JAVA INSTRUCTIONS ----------
  */
 const argsInstruction = '<argLine>-javaagent:"${com.browserstack:browserstack-java-sdk:jar}"</argLine>';
-const javaInstructions = (username, accessKey) => `
+export const javaInstructions = (username, accessKey) => {
+    const setup = `
 ---STEP---
 
 Add the BrowserStack Java SDK dependency to your \`pom.xml\`:
@@ -82,7 +91,8 @@ Export your BrowserStack credentials as environment variables:
 export BROWSERSTACK_USERNAME=${username}
 export BROWSERSTACK_ACCESS_KEY=${accessKey}
 \`\`\`
-
+`;
+    const run = `
 ---STEP---
 
 Run your tests using Maven:
@@ -95,66 +105,13 @@ Or for Gradle:
 gradle clean test
 \`\`\`
 `;
-const serenityInstructions = (username, accessKey) => `
----STEP---
-
-Set BrowserStack credentials as environment variables:
-For macOS/Linux:
-\`\`\`bash
-export BROWSERSTACK_USERNAME=${username}
-export BROWSERSTACK_ACCESS_KEY=${accessKey}
-\`\`\`
-
-For Windows Command Prompt:
-\`\`\`cmd
-set BROWSERSTACK_USERNAME=${username}
-set BROWSERSTACK_ACCESS_KEY=${accessKey}
-\`\`\`
-
----STEP---
-
-Add serenity-browserstack dependency in pom.xml:
-Add the following dependency to your pom.xml file and save it:
-\`\`\`xml
-<dependency>
-  <groupId>net.serenity-bdd</groupId>
-  <artifactId>serenity-browserstack</artifactId>
-  <version>3.3.4</version>
-</dependency>
-\`\`\`
-
----STEP---
-
-Set up serenity.conf file:
-Create or update your serenity.conf file in the project root with the following configuration:
-\`\`\`
-webdriver {
-  driver = remote
-  remote.url = "https://hub.browserstack.com/wd/hub"
-}
-browserstack.user="${username}"
-browserstack.key="${accessKey}"
-\`\`\`
-
----STEP---
-
-Run your Serenity tests:
-You can continue running your tests as you normally would. For example:
-
-Using Maven:
-\`\`\`bash
-mvn clean verify
-\`\`\`
-
-Using Gradle:
-\`\`\`bash
-gradle clean test
-\`\`\`
-`;
+    return { setup, run };
+};
 /**
  * ---------- CSharp INSTRUCTIONS ----------
  */
-const csharpCommonInstructions = (username, accessKey) => `
+export const csharpCommonInstructions = (username, accessKey) => {
+    const setup = `
 ---STEP---
 
 Install BrowserStack TestAdapter NuGet package:
@@ -203,7 +160,8 @@ Install the x64 version of .NET for BrowserStack compatibility.
   sudo dotnet browserstack-sdk setup-dotnet --dotnet-path "<your-chosen-path>" --dotnet-version "<your-dotnet-version>"
   \`\`\`
   Common paths: /usr/local/share/dotnet, ~/dotnet-x64, or /opt/dotnet-x64
-
+`;
+    const run = `
 ---STEP---
 
 Run the tests:
@@ -216,7 +174,10 @@ Run the tests:
   dotnet test
   \`\`\`
 `;
-const csharpPlaywrightCommonInstructions = (username, accessKey) => `
+    return { setup, run };
+};
+export const csharpPlaywrightCommonInstructions = (username, accessKey) => {
+    const setup = `
 ---STEP---
 
 Install BrowserStack TestAdapter NuGet package:
@@ -278,7 +239,8 @@ Fix for Playwright architecture (macOS only):
 If the folder exists:  
 \`<project-folder>/bin/Debug/net8.0/.playwright/node/darwin-arm64\`  
 Rename \`darwin-arm64\` to \`darwin-x64\`
-
+`;
+    const run = `
 ---STEP---
 
 Run the tests:
@@ -291,10 +253,13 @@ Run the tests:
   dotnet test
   \`\`\`
 `;
+    return { setup, run };
+};
 /**
  * ---------- NODEJS INSTRUCTIONS ----------
  */
-const nodejsInstructions = (username, accessKey) => `
+export const nodejsInstructions = (username, accessKey) => {
+    const setup = `
 ---STEP---
 
 Ensure \`browserstack-node-sdk\` is present in package.json with the latest version:
@@ -311,6 +276,12 @@ Add new scripts to package.json for running tests on BrowserStack:
 }
 \`\`\`
 
+Example : 
+\`\`\`json
+"scripts": {
+  "test:browserstack": "npx browserstack-node-sdk playwright test"
+}
+\`\`\`
 ---STEP---
 
 Export BrowserStack credentials as environment variables:
@@ -319,11 +290,26 @@ Set the following environment variables before running tests.
 export BROWSERSTACK_USERNAME=${username}
 export BROWSERSTACK_ACCESS_KEY=${accessKey}
 \`\`\`
+
+---STEP---
+Run your tests:
+You can now run your tests on BrowserStack using your standard command or Use the commands defined in your package.json file to run the tests.
+`;
+    const run = `
+---STEP---
+
+Run your tests on BrowserStack:
+\`\`\`bash
+npm run test:browserstack
+\`\`\`
 `;
+    return { setup, run };
+};
 /**
  * ---------- EXPORT CONFIG ----------
  */
-const webdriverioInstructions = (username, accessKey) => `
+export const webdriverioInstructions = (username, accessKey) => {
+    const setup = `
 ---STEP---
 
 Set BrowserStack Credentials:
@@ -422,13 +408,17 @@ exports.config.capabilities.forEach(function (caps) {
     caps[i] = { ...caps[i], ...exports.config.commonCapabilities[i]};
 });
 \`\`\`
-
+`;
+    const run = `
 ---STEP---
 
 Run your tests:
-You can now run your tests on BrowserStack using your standard WebdriverIO command.
+You can now run your tests on BrowserStack using your standard WebdriverIO command or Use the commands defined in your package.json file to run the tests.
 `;
-const cypressInstructions = (username, accessKey) => `
+    return { setup, run };
+};
+export const cypressInstructions = (username, accessKey) => {
+    const setup = `
 ---STEP---
 
 Install the BrowserStack Cypress CLI:
@@ -489,7 +479,8 @@ Open the generated \`browserstack.json\` file and update it with your BrowserSta
 \`\`\`
 
 **Note:** For Cypress v9 or lower, use \`"cypress_config_file": "./cypress.json"\`. The \`testObservability: true\` flag enables the [Test Reporting & Analytics dashboard](https://www.browserstack.com/docs/test-management/test-reporting-and-analytics) for deeper insights into your test runs.
-
+`;
+    const run = `
 ---STEP---
 
 Run Your Tests on BrowserStack:
@@ -498,8 +489,69 @@ Execute your tests on BrowserStack using the following command:
 npx browserstack-cypress run --sync
 \`\`\`
 
-After the tests complete, you can view the results on your [BrowserStack Automate Dashboard](https://automate.browserstack.com/dashboard/).
+After the tests complete, you can view the results on your [BrowserStack Automate Dashboard](https://automate.browserstack.com/dashboard/).`;
+    return { setup, run };
+};
+const serenityInstructions = (username, accessKey) => {
+    const setup = `
+---STEP---
+
+Set BrowserStack credentials as environment variables:
+For macOS/Linux:
+\`\`\`bash
+export BROWSERSTACK_USERNAME=${username}
+export BROWSERSTACK_ACCESS_KEY=${accessKey}
+\`\`\`
+
+For Windows Command Prompt:
+\`\`\`cmd
+set BROWSERSTACK_USERNAME=${username}
+set BROWSERSTACK_ACCESS_KEY=${accessKey}
+\`\`\`
+
+---STEP---
+
+Add serenity-browserstack dependency in pom.xml:
+Add the following dependency to your pom.xml file and save it:
+\`\`\`xml
+<dependency>
+  <groupId>net.serenity-bdd</groupId>
+  <artifactId>serenity-browserstack</artifactId>
+  <version>3.3.4</version>
+</dependency>
+\`\`\`
+
+---STEP---
+
+Set up serenity.conf file:
+Create or update your serenity.conf file in the project root with the following configuration:
+\`\`\`
+webdriver {
+  driver = remote
+  remote.url = "https://hub.browserstack.com/wd/hub"
+}
+browserstack.user="${username}"
+browserstack.key="${accessKey}"
+\`\`\`
+`;
+    const run = `
+---STEP---
+
+Run your Serenity tests:
+You can continue running your tests as you normally would. For example:
+
+Using Maven:
+\`\`\`bash
+mvn clean verify
+\`\`\`
+
+Using Gradle:
+\`\`\`bash
+gradle clean test
+\`\`\`
 `;
+    return { setup, run };
+};
 export const SUPPORTED_CONFIGURATIONS = {
     python: {
         playwright: {

package/dist/tools/sdk-utils/{constants.d.ts → bstack/frameworks.d.ts}

@@ -1,2 +1,2 @@
-import { ConfigMapping } from "./types.js";
+import { ConfigMapping } from "../common/types.js";
 export declare const SUPPORTED_CONFIGURATIONS: ConfigMapping;

package/dist/tools/sdk-utils/bstack/frameworks.js

@@ -0,0 +1,57 @@
+import * as constants from "./constants.js";
+export const SUPPORTED_CONFIGURATIONS = {
+    python: {
+        playwright: {
+            pytest: { instructions: constants.pythonInstructions },
+        },
+        selenium: {
+            pytest: { instructions: constants.pytestInstructions },
+            robot: { instructions: constants.robotInstructions },
+            behave: { instructions: constants.behaveInstructions },
+        },
+    },
+    java: {
+        playwright: {
+            junit4: { instructions: constants.javaInstructions },
+            junit5: { instructions: constants.javaInstructions },
+            testng: { instructions: constants.javaInstructions },
+        },
+        selenium: {
+            testng: { instructions: constants.javaInstructions },
+            cucumber: { instructions: constants.javaInstructions },
+            junit4: { instructions: constants.javaInstructions },
+            junit5: { instructions: constants.javaInstructions },
+        },
+    },
+    csharp: {
+        playwright: {
+            nunit: { instructions: constants.csharpPlaywrightCommonInstructions },
+            mstest: { instructions: constants.csharpPlaywrightCommonInstructions },
+        },
+        selenium: {
+            xunit: { instructions: constants.csharpCommonInstructions },
+            nunit: { instructions: constants.csharpCommonInstructions },
+            mstest: { instructions: constants.csharpCommonInstructions },
+            specflow: { instructions: constants.csharpCommonInstructions },
+            reqnroll: { instructions: constants.csharpCommonInstructions },
+        },
+    },
+    nodejs: {
+        playwright: {
+            jest: { instructions: constants.nodejsInstructions },
+            codeceptjs: { instructions: constants.nodejsInstructions },
+            playwright: { instructions: constants.nodejsInstructions },
+        },
+        selenium: {
+            jest: { instructions: constants.nodejsInstructions },
+            webdriverio: { instructions: constants.webdriverioInstructions },
+            mocha: { instructions: constants.nodejsInstructions },
+            cucumber: { instructions: constants.nodejsInstructions },
+            nightwatch: { instructions: constants.nodejsInstructions },
+            codeceptjs: { instructions: constants.nodejsInstructions },
+        },
+        cypress: {
+            cypress: { instructions: constants.cypressInstructions },
+        },
+    },
+};

package/dist/tools/sdk-utils/bstack/index.d.ts

@@ -0,0 +1,4 @@
+export { runBstackSDKOnly } from "./sdkHandler.js";
+export { getSDKPrefixCommand, getJavaFrameworkForMaven } from "./commands.js";
+export { generateBrowserStackYMLInstructions } from "./configUtils.js";
+export { SUPPORTED_CONFIGURATIONS } from "./frameworks.js";

package/dist/tools/sdk-utils/bstack/index.js

@@ -0,0 +1,5 @@
+// BrowserStack SDK utilities
+export { runBstackSDKOnly } from "./sdkHandler.js";
+export { getSDKPrefixCommand, getJavaFrameworkForMaven } from "./commands.js";
+export { generateBrowserStackYMLInstructions } from "./configUtils.js";
+export { SUPPORTED_CONFIGURATIONS } from "./frameworks.js";

package/dist/tools/sdk-utils/bstack/sdkHandler.d.ts

@@ -0,0 +1,4 @@
+import { RunTestsInstructionResult } from "../common/types.js";
+import { RunTestsOnBrowserStackInput } from "../common/schema.js";
+import { BrowserStackConfig } from "../../../lib/types.js";
+export declare function runBstackSDKOnly(input: RunTestsOnBrowserStackInput, config: BrowserStackConfig, isPercyAutomate?: boolean): RunTestsInstructionResult;