Merge remote-tracking branch 'origin/master' into feat/cors-iframes-and-shadow-dom

Author: aryanku-dev

pom.xml

@@ -5,7 +5,7 @@
 
   <groupId>io.percy</groupId>
   <artifactId>percy-java-selenium</artifactId>
-  <version>2.1.2</version>
+  <version>2.2.0</version>
   <packaging>jar</packaging>
 
   <name>${project.groupId}:${project.artifactId}</name>
@@ -87,6 +87,19 @@
       <version>3.12.4</version>
       <scope>test</scope>
     </dependency>
+    <!-- Cucumber (optional - for BDD step definitions) -->
+    <dependency>
+      <groupId>io.cucumber</groupId>
+      <artifactId>cucumber-java</artifactId>
+      <version>7.15.0</version>
+      <scope>provided</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.cucumber</groupId>
+      <artifactId>cucumber-junit-platform-engine</artifactId>
+      <version>7.15.0</version>
+      <scope>test</scope>
+    </dependency>
 
   </dependencies>
 

src/main/java/io/percy/selenium/Environment.java

@@ -13,15 +13,24 @@ class Environment {
   private final static String SDK_VERSION = "2.1.2";
   private final static String SDK_NAME = "percy-java-selenium";
 
+  private String clientInfoOverride;
+  private String environmentInfoOverride;
+
   Environment(WebDriver driver) {
     this.driver = driver;
   }
 
   public String getClientInfo() {
+    if (clientInfoOverride != null) {
+      return clientInfoOverride;
+    }
     return SDK_NAME + "/" + SDK_VERSION;
   }
 
   public String getEnvironmentInfo() {
+    if (environmentInfoOverride != null) {
+      return environmentInfoOverride;
+    }
     // If this is a wrapped driver, get the actual driver that this one wraps.
     WebDriver innerDriver = this.driver instanceof WrapsDriver ?
       ((WrapsDriver) this.driver).getWrappedDriver()
@@ -33,4 +42,16 @@ public String getEnvironmentInfo() {
     // We don't know this type of driver. Report its classname as environment info.
     return String.format("selenium-java; %s", driverName);
   }
+
+  void setClientInfo(String clientInfo) {
+    this.clientInfoOverride = clientInfo;
+  }
+
+  void setEnvironmentInfo(String environmentInfo) {
+    this.environmentInfoOverride = environmentInfo;
+  }
+
+  public static String getSdkVersion() {
+    return SDK_VERSION;
+  }
 }

src/main/java/io/percy/selenium/Percy.java

@@ -86,6 +86,27 @@ public Percy(WebDriver driver) {
         this.env = new Environment(driver);
     }
 
+    /**
+     * Override the client info reported to Percy.
+     * Used by framework wrappers (e.g., Cucumber) to identify themselves.
+     *
+     * @param clientInfo      Client identifier (e.g., "percy-cucumber-java-selenium/2.1.2")
+     * @param environmentInfo Environment details (e.g., "cucumber-java/7.15.0; selenium-java; ChromeDriver")
+     */
+    public void setClientInfo(String clientInfo, String environmentInfo) {
+        this.env.setClientInfo(clientInfo);
+        this.env.setEnvironmentInfo(environmentInfo);
+    }
+
+    /**
+     * Get the SDK version string.
+     *
+     * @return SDK version (e.g., "2.1.2")
+     */
+    public static String getSdkVersion() {
+        return Environment.getSdkVersion();
+    }
+
     /**
      * Creates a region configuration based on the provided parameters.
      *