commands.ts

import { SDKSupportedLanguage } from "../common/types.js";

// 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: Record<string, string> = {
  testng: "testng",
  junit5: "junit5",
  junit4: "junit4",
  cucumber: "cucumber-testng",
} as const;

// The literal access key is never echoed into tool output; users substitute
// this placeholder locally. See PMAA-100 security review.
const ACCESS_KEY_PLACEHOLDER = "<your BrowserStack access key>";

// Template for Node.js SDK setup instructions
const NODEJS_SDK_INSTRUCTIONS = (username: string): string => `---STEP---
Install BrowserStack Node SDK using command:
\`\`\`bash
npm i -D browserstack-node-sdk@latest
\`\`\`
---STEP---
Run the following command to setup browserstack sdk (replace the placeholder with your BrowserStack access key):
\`\`\`bash
npx setup --username ${username} --key "${ACCESS_KEY_PLACEHOLDER}"
\`\`\``;

// 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(
  username: string,
  mavenFramework: string,
): string {
  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="${ACCESS_KEY_PLACEHOLDER}" ` +
    `-DBROWSERSTACK_FRAMEWORK="${mavenFramework}"`
  );
}

// Generates Maven archetype command for Unix-like platforms (macOS/Linux)
function getMavenCommandForUnix(
  username: string,
  mavenFramework: string,
): string {
  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="${ACCESS_KEY_PLACEHOLDER}" \\
-DBROWSERSTACK_FRAMEWORK="${mavenFramework}"`;
}

// Generates Java SDK setup instructions with Maven/Gradle options
function getJavaSDKInstructions(framework: string, username: string): string {
  const mavenFramework = getJavaFrameworkForMaven(framework);
  const isWindows = process.platform === "win32";
  const platformLabel = isWindows ? "Windows" : "macOS/Linux";

  const mavenCommand = isWindows
    ? getMavenCommandForWindows(username, mavenFramework)
    : getMavenCommandForUnix(username, 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: SDKSupportedLanguage,
  framework: string,
  username: string,
): string {
  switch (language) {
    case "nodejs":
      return NODEJS_SDK_INSTRUCTIONS(username);

    case "java":
      return getJavaSDKInstructions(framework, username);

    default:
      return "";
  }
}

export function getJavaFrameworkForMaven(framework: string): string {
  return JAVA_FRAMEWORK_MAP[framework] || framework;
}