Pull request #17: Developer

Merge in SDK/java_telesign from developer to master

* commit '3318e5e67125f60095062ef486e61e5ee3003c6d':
  Pull request #18: Fix details version
  Pull request #14: feature/EOA-5901-SS-Intellegence-Cloud-Api
  Pull request #16: [PD-102707] Adding checkstyle and unittest tasks and fixes

Author: jmartinez-telesign

README.md

@@ -50,11 +50,19 @@ Follow these steps to add this SDK as a dependency to your project.
    ```
    implementation("com.google.code.gson:gson:2.+")
    implementation ("com.squareup.okio:okio:2.+")
-   implementation("com.telesign:telesign:3.+")
+   implementation("com.telesign:telesign:4.+")
    ```
 
    That last dependency pulls in the Telesign Self-service Java SDK.
 
+## Development tasks
+
+Use these Gradle tasks during development:
+
+- Run unit tests: `./gradlew test`
+- Run linter checks: `./gradlew lint`
+- Run CI validation (tests + linter): `./gradlew ciTest`
+
 ## Authentication
 
 If you use a Telesign SDK to make your request, authentication is handled behind-the-scenes for you. All you need to provide is your Customer ID and API Key. The SDKs apply Digest authentication whenever they make a request to a Telesign service where it is supported. When Digest authentication is not supported, the SDKs apply Basic authentication.

RELEASE.md

@@ -1,3 +1,7 @@
+## [4.0.0](http://central.maven.org/maven2/com/telesign/telesign/4.0.0) - 2026-02-06
+- 2026-02-06
+  - Added support for Intelligence Cloud to use new endpoint.
+
 ## [3.0.1](http://central.maven.org/maven2/com/telesign/telesign/3.0.1) - 2025-09-18
 - 2025-09-18
   - Updated SDK install instructions on GitHub to default to latest version for Telesign SDK

build.gradle

@@ -5,10 +5,11 @@ plugins {
     id 'maven-publish'
     id 'signing'
     id 'io.github.gradle-nexus.publish-plugin' version '2.0.0'
+    id 'checkstyle'
 }
 
 group 'com.telesign'
-version '3.0.1'
+version '4.0.0'
 
 sourceCompatibility = JavaVersion.VERSION_1_8
 targetCompatibility = JavaVersion.VERSION_1_8
@@ -17,6 +18,46 @@ repositories {
     mavenCentral()
 }
 
+checkstyle {
+    toolVersion = '10.12.5'
+    configFile = file("${rootDir}/config/checkstyle/checkstyle.xml")
+    ignoreFailures = true
+}
+
+// Test configuration
+test {
+    useJUnit()
+    testLogging {
+        events "passed", "skipped", "failed"
+        exceptionFormat "full"
+        showStandardStreams = false
+    }
+}
+
+// Task for linting
+tasks.register('lint') {
+    group = 'verification'
+    description = 'Runs checkstyle linter'
+    dependsOn 'checkstyleMain', 'checkstyleTest'
+}
+
+// Task for CI pipeline
+tasks.register('ciTest') {
+    group = 'verification'
+    description = 'Runs tests and linter for CI/CD pipeline'
+    dependsOn 'clean', 'test', 'lint'
+}
+
+// Task for release validation
+tasks.register('validateRelease') {
+    group = 'release'
+    description = 'Validates code is ready for release'
+    dependsOn 'ciTest', 'javadoc', 'sourcesJar', 'javadocJar'
+    doLast {
+        println "✓ Release validation completed successfully"
+    }
+}
+
 jar {
     manifest {
         attributes 'Implementation-Version': project.version
@@ -97,7 +138,7 @@ if (System.getenv('TRAVIS') == null) {
 
                 groupId = 'com.telesign'
                 artifactId = 'telesign'
-                version = '3.0.1'
+                version = '4.0.0'
 
                 pom {
                     name = 'Telesign SDK'

config/checkstyle/checkstyle.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+        "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+        "https://checkstyle.org/dtds/configuration_1_3.dtd">
+
+<module name="Checker">
+    <module name="TreeWalker">
+        <!-- Import checks -->
+        <module name="UnusedImports"/>
+        <module name="RedundantImport"/>
+        <module name="AvoidStarImport"/>
+
+        <!-- Coding checks -->
+        <module name="EmptyStatement"/>
+        <module name="EqualsHashCode"/>
+        <module name="SimplifyBooleanExpression"/>
+        <module name="SimplifyBooleanReturn"/>
+
+        <!-- Block checks -->
+        <module name="NeedBraces"/>
+        <module name="EmptyBlock"/>
+
+        <!-- Naming conventions -->
+        <module name="TypeName"/>
+        <module name="MethodName"/>
+        <module name="ConstantName"/>
+    </module>
+</module>
+

src/main/java/com/telesign/AppVerifyClient.java

@@ -1,9 +1,6 @@
 package com.telesign;
 
-import java.io.IOException;
 import java.net.Proxy;
-import java.security.GeneralSecurityException;
-import java.util.Map;
 
 /**
  * AppVerify is a secure, lightweight SDK that integrates a frictionless user verification process into existing

src/main/java/com/telesign/RestClient.java

@@ -4,7 +4,17 @@
 import com.google.gson.Gson;
 import com.google.gson.JsonParseException;
 import com.google.gson.JsonParser;
-import okhttp3.*;
+import okhttp3.Authenticator;
+import okhttp3.Credentials;
+import okhttp3.FormBody;
+import okhttp3.HttpUrl;
+import okhttp3.MediaType;
+import okhttp3.OkHttp;
+import okhttp3.OkHttpClient;
+import okhttp3.Request;
+import okhttp3.RequestBody;
+import okhttp3.Response;
+import okhttp3.Route;
 import okio.Buffer;
 
 import javax.crypto.Mac;
@@ -15,7 +25,15 @@
 import java.security.InvalidKeyException;
 import java.security.NoSuchAlgorithmException;
 import java.text.SimpleDateFormat;
-import java.util.*;
+import java.util.Base64;
+import java.util.Date;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Objects;
+import java.util.TimeZone;
+import java.util.UUID;
 import java.util.concurrent.TimeUnit;
 
 /**

src/main/java/com/telesign/ScoreClient.java

@@ -11,10 +11,12 @@
  */
 public class ScoreClient extends RestClient {
 
-    private static final String SCORE_RESOURCE = "/v1/score/%s";
+    private static final String INTELLIGENCE_SCORE_RESOURCE = "/intelligence/phone";
+
+    private static final String DETECT_REST_ENDPOINT = "https://detect.telesign.com";
 
     public ScoreClient(String customerId, String apiKey) {
-        super(customerId, apiKey);
+        super(customerId, apiKey, DETECT_REST_ENDPOINT);
     }
 
     public ScoreClient(String customerId, String apiKey, String restEndpoint, String source, String sdkVersionOrigin, String sdkVersionDependency) {
@@ -41,19 +43,18 @@ public ScoreClient(String customerId,
     }
 
     /**
-     * Score is an API that delivers reputation scoring based on phone number intelligence, traffic patterns, machine
-     * learning, and a global data consortium.
+     *Obtain a risk recommendation for this phone number, as well as other relevant information using Telesign Cloud API.
      * <p>
-     * See https://developer.telesign.com/docs/score-api for detailed API documentation.
+     * See https://developer.telesign.com/enterprise/reference/submitphonenumberforintelligencecloud for detailed API documentation.
      */
     public TelesignResponse score(String phoneNumber, String accountLifecycleEvent, Map<String, String> params) throws IOException, GeneralSecurityException {
-
         if (params == null) {
             params = new HashMap<>();
         }
-
+        
+        params.put("phone_number", phoneNumber);
         params.put("account_lifecycle_event", accountLifecycleEvent);
 
-        return this.post(String.format(SCORE_RESOURCE, phoneNumber), params);
+        return this.post(INTELLIGENCE_SCORE_RESOURCE, params);
     }
 }

src/test/java/com/telesign/AppVerifyClientTest.java

@@ -1,13 +1,9 @@
 package com.telesign;
 
 import junit.framework.TestCase;
-import okhttp3.mockwebserver.MockResponse;
 import okhttp3.mockwebserver.MockWebServer;
-import okhttp3.mockwebserver.RecordedRequest;
 
 import java.text.SimpleDateFormat;
-import java.util.HashMap;
-import java.util.concurrent.TimeUnit;
 
 public class AppVerifyClientTest extends TestCase {
 

src/test/java/com/telesign/JsonCreateRequestBodyTest.java

@@ -1,17 +1,13 @@
 package com.telesign;
 
 import com.google.gson.Gson;
-import com.google.gson.GsonBuilder;
-import com.google.gson.JsonElement;
-import com.google.gson.JsonObject;
 import com.google.gson.reflect.TypeToken;
 import junit.framework.TestCase;
 import okhttp3.RequestBody;
 import okio.Buffer;
 
 import java.io.IOException;
 import java.util.HashMap;
-import java.util.Map;
 
 public class JsonCreateRequestBodyTest extends TestCase {
 

src/test/java/com/telesign/ScoreClientTest.java

@@ -1,12 +1,10 @@
 package com.telesign;
 
 import junit.framework.TestCase;
-import okhttp3.OkHttpClient;
 import okhttp3.mockwebserver.MockResponse;
 import okhttp3.mockwebserver.MockWebServer;
 import okhttp3.mockwebserver.RecordedRequest;
 
-import java.text.SimpleDateFormat;
 import java.util.HashMap;
 import java.util.concurrent.TimeUnit;
 
@@ -17,14 +15,11 @@ public class ScoreClientTest extends TestCase {
     private String customerId;
     private String apiKey;
 
-    private SimpleDateFormat rfc2616 = new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss 'GMT'");
-
-
     public void setUp() throws Exception {
         super.setUp();
 
         customerId = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890";
-        apiKey = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
+        apiKey = "ABC12345yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
 
         mockServer = new MockWebServer();
         mockServer.start();
@@ -41,7 +36,6 @@ public void testScoreClientConstructorMinimal() throws Exception {
         assertNotNull(client);
     }
 
-
     public void testScoreClientConstructorFull() throws Exception {
         ScoreClient client = new ScoreClient(customerId,
                 apiKey,
@@ -59,7 +53,6 @@ public void testScoreClientConstructorFull() throws Exception {
     }
 
     public void testScoreWithParams() throws Exception {
-
         HashMap<String, String> params = new HashMap<String, String>() {{
             put("originating_ip", "127.0.0.1");
             put("account_lifecycle_event", "create");
@@ -71,24 +64,25 @@ public void testScoreWithParams() throws Exception {
                 this.apiKey,
                 this.mockServer.url("").toString().replaceAll("/$", ""), null, null, null);
 
-        client.score("18005555555", "create", params);
+        client.score("11234567890", "create", params);
 
         RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
 
         assertEquals("method is not as expected", "POST", request.getMethod());
-        assertEquals("path is not as expected", "/v1/score/18005555555", request.getPath());
-        assertEquals("body is not as expected", "originating_ip=127.0.0.1&account_lifecycle_event=create",
-                request.getBody().readUtf8());
+        assertEquals("path is not as expected", "/intelligence/phone", request.getPath());
+
+        String body = request.getBody().readUtf8();
+        assertTrue("body does not contain phone_number", body.contains("phone_number=11234567890"));
+        assertTrue("body does not contain originating_ip", body.contains("originating_ip=127.0.0.1"));
+        assertTrue("body does not contain account_lifecycle_event", body.contains("account_lifecycle_event=create"));
+
         assertEquals("Content-Type header is not as expected", "application/x-www-form-urlencoded",
                 request.getHeader("Content-Type"));
         assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
                 request.getHeader("x-ts-auth-method"));
     }
 
     public void testScore() throws Exception {
-
-        HashMap<String, Object> params = new HashMap<String, Object>();
-
         this.mockServer.enqueue(new MockResponse().setBody("{}"));
 
         ScoreClient client = new ScoreClient(this.customerId,
@@ -100,15 +94,15 @@ public void testScore() throws Exception {
         RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
 
         assertEquals("method is not as expected", "POST", request.getMethod());
-        assertEquals("path is not as expected", "/v1/score/18005555555", request.getPath());
-        assertEquals("body is not as expected", "account_lifecycle_event=create",
-                request.getBody().readUtf8());
+        assertEquals("path is not as expected", "/intelligence/phone", request.getPath());
+
+        String body = request.getBody().readUtf8();
+        assertTrue("body does not contain phone_number", body.contains("phone_number=18005555555"));
+        assertTrue("body contains account_lifecycle_event", body.contains("account_lifecycle_event=create"));
+
         assertEquals("Content-Type header is not as expected", "application/x-www-form-urlencoded",
                 request.getHeader("Content-Type"));
         assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
                 request.getHeader("x-ts-auth-method"));
     }
-
-}
-
-
+}