release 1.2.0

CHANGES.txt

@@ -1,6 +1,8 @@
-1.2.0 (August XX, 2025)
+1.2.0 (September 3, 2025)
  - Updated `io.split.client` dependency to 4.16.1
  - Updated `dev.openfeature` dependency to 1.17.0
+ - Added tracking support
+ - Added “evaluate with details” support
 
 1.1.0
  - Up tp date with spec v0.5.0 and java sdk v0.3.1

README.md

@@ -13,7 +13,7 @@ This SDK is compatible with Java 11 and higher.
 <dependency>
     <groupId>io.split.openfeature</groupId>
     <artifactId>split-openfeature-provider</artifactId>
-    <version>1.1.0</version>
+    <version>1.2.0</version>
 </dependency>
 ```
 ### Configure it
@@ -24,7 +24,7 @@ import dev.openfeature.sdk.OpenFeatureAPI;
 import io.split.openfeature.SplitProvider;
 
 OpenFeatureAPI api = OpenFeatureAPI.getInstance();
-api.setProvider(new SplitProvider("YOUR_API_KEY"));
+api.setProviderAndWait(new SplitProvider("YOUR_API_KEY"));
 ```
 
 If you are more familiar with Split or want access to other initialization options, you can provide a `SplitClient` to the constructor. See the [Split Java SDK Documentation](https://help.split.io/hc/en-us/articles/360020405151-Java-SDK) for more information.
@@ -42,7 +42,7 @@ SplitClientConfig config = SplitClientConfig.builder()
    .setBlockUntilReadyTimeout(10000)
    .build();
 SplitClient splitClient = SplitFactoryBuilder.build("YOUR_API_KEY", config).client();
-api.setProvider(new SplitProvider(splitClient));
+api.setProviderAndWait(new SplitProvider(splitClient));
 ```
 
 ## Use of OpenFeature with Split
@@ -67,6 +67,52 @@ OpenFeatureAPI.getInstance().setEvaluationContext(context)
 ````
 If the context was set at the client or api level, it is not required to provide it during flag evaluation.
 
+## Evaluate with details
+
+Use the get*Details(...) APIs to get the value and rich context (variant, reason, error code, metadata).
+This provider includes the Split treatment config as a raw JSON string under flagMetadata["config"]
+```java
+// boolean/string/number/object all have *Details variants:
+FlagEvaluationDetails<String> details =
+    client.getStringDetails("my-flag", "fallback", ctx);
+
+Metadata md = details.getFlagMetadata();
+if (md != null) {
+
+  Map<String, Value> meta = md.asMap();
+
+  Value config = meta.get("config"); // ← Split treatment config 
+}
+```
+
+## Tracking
+To use track(eventName, context, details) you must provide:
+
+- targetingKey on the EvaluationContext (non-blank).
+
+- trafficType in the context (string, e.g. "user" or "account").
+
+- A non-blank eventName.
+
+Optional:
+
+- details.value: numeric event value (defaults to 0).
+
+- details.properties: map of attributes (prefer primitives: string/number/boolean/null).
+
+Example:
+
+```java
+MutableContext ctx = new MutableContext("user-123");
+ctx.add("trafficType", new Value("user"));
+
+TrackingEventDetails details = new MutableTrackingEventDetails(19.99)
+    .add("plan", new Value("pro"))
+    .add("coupon", new Value("WELCOME10"));
+
+client.track("checkout.completed", ctx, details);
+```
+
 ## Submitting issues
 
 The Split team monitors all issues submitted to this [issue tracker](https://github.com/splitio/split-openfeature-provider-java/issues). We encourage you to use this issue tracker to submit any bug reports, feedback, and feature enhancements. We'll do our best to respond in a timely manner.

pom.xml

@@ -34,7 +34,7 @@
 	<properties>
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 		<maven.compiler.release>11</maven.compiler.release>
-		<junit.jupiter.version>5.10.2</junit.jupiter.version>
+		<junit.jupiter.version>5.13.4</junit.jupiter.version>
 		<maven.surefire.version>3.2.5</maven.surefire.version>
 	</properties>
 	<dependencies>
@@ -47,29 +47,34 @@
 		<dependency>
 			<groupId>io.split.client</groupId>
 			<artifactId>java-client</artifactId>
-			<version>4.16.1</version>
+			<version>4.17.0</version>
 		</dependency>
 		<dependency>
 			<groupId>org.apache.httpcomponents</groupId>
 			<artifactId>httpclient</artifactId>
 			<version>4.5.14</version>
 		</dependency>
-		<dependency>
-			<groupId>io.split.integrations.azure</groupId>
-			<artifactId>impressions-listener</artifactId>
-			<version>0.9.1</version>
-		</dependency>
 		<dependency>
 			<groupId>org.mockito</groupId>
 			<artifactId>mockito-core</artifactId>
-			<version>3.4.6</version>
+			<version>5.19.0</version>
 			<scope>test</scope>
 		</dependency>
 		<dependency>
 			<groupId>dev.openfeature</groupId>
 			<artifactId>sdk</artifactId>
 			<version>1.17.0</version>
 		</dependency>
+		<dependency>
+			<groupId>com.fasterxml.jackson.core</groupId>
+			<artifactId>jackson-core</artifactId>
+			<version>2.20.0</version>
+		</dependency>
+		<dependency>
+			<groupId>com.fasterxml.jackson.core</groupId>
+			<artifactId>jackson-databind</artifactId>
+			<version>2.20.0</version>
+		</dependency>
 	</dependencies>
 	<build>
 		<pluginManagement>
@@ -78,49 +83,49 @@
 				<!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
 				<plugin>
 					<artifactId>maven-clean-plugin</artifactId>
-					<version>3.1.0</version>
+					<version>3.5.0</version>
 				</plugin>
 				<!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
 				<plugin>
 					<artifactId>maven-resources-plugin</artifactId>
-					<version>3.0.2</version>
+					<version>3.3.1</version>
 				</plugin>
 				<plugin>
 					<artifactId>maven-compiler-plugin</artifactId>
-					<version>3.8.0</version>
+					<version>3.14.0</version>
 				</plugin>
 				<plugin>
 					<artifactId>maven-surefire-plugin</artifactId>
-					<version>2.22.1</version>
+					<version>3.5.3</version>
 				</plugin>
 				<plugin>
 					<artifactId>maven-jar-plugin</artifactId>
-					<version>3.0.2</version>
+					<version>3.4.2</version>
 				</plugin>
 				<plugin>
 					<artifactId>maven-install-plugin</artifactId>
-					<version>2.5.2</version>
+					<version>3.1.4</version>
 				</plugin>
 				<plugin>
 					<artifactId>maven-deploy-plugin</artifactId>
-					<version>2.8.2</version>
+					<version>3.1.4</version>
 				</plugin>
 				<!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
 				<plugin>
 					<artifactId>maven-site-plugin</artifactId>
-					<version>3.7.1</version>
+					<version>3.21.0</version>
 				</plugin>
 				<plugin>
 					<artifactId>maven-project-info-reports-plugin</artifactId>
-					<version>3.0.0</version>
+					<version>3.9.0</version>
 				</plugin>
 			</plugins>
 		</pluginManagement>
 		<plugins>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-compiler-plugin</artifactId>
-				<version>3.13.0</version>
+				<version>3.14.0</version>
 				<configuration>
 					<source>11</source>
 					<target>11</target>
@@ -143,15 +148,6 @@
 					</execution>
 				</executions>
 			</plugin>
-			<plugin>
-				<groupId>org.sonatype.plugins</groupId>
-				<artifactId>nexus-staging-maven-plugin</artifactId>
-				<version>1.6.13</version>
-				<extensions>true</extensions>
-				<configuration>
-					<skipNexusStagingDeployMojo>true</skipNexusStagingDeployMojo>
-				</configuration>
-			</plugin>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-source-plugin</artifactId>
@@ -168,7 +164,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-gpg-plugin</artifactId>
-				<version>1.5</version>
+				<version>3.2.8</version>
 				<executions>
 					<execution>
 						<id>sign-artifacts</id>
@@ -179,6 +175,17 @@
 					</execution>
 				</executions>
 			</plugin>
+			<plugin>
+				<groupId>org.sonatype.central</groupId>
+				<artifactId>central-publishing-maven-plugin</artifactId>
+				<version>0.7.0</version>
+				<extensions>true</extensions>
+				<configuration>
+					<publishingServerId>central</publishingServerId>
+					<autoPublish>false</autoPublish>
+					<waitUntil>published</waitUntil>
+				</configuration>
+			</plugin>
 		</plugins>
 	</build>
 </project>