Pull request #22: Pull request #21: Added support for Email Intelligence

Merge in SDK/java_telesign from developer to master

* commit '657fbd541123130152c44de662b1e3b50bcc13b8':
  Pull request #21: Added support for Email Intelligence

Author: jramirez-telesign

RELEASE.md

@@ -1,3 +1,7 @@
+## [4.1.0](http://central.maven.org/maven2/com/telesign/telesign/4.1.0) - 2026-04-29
+- 2026-04-29
+    - Added support for Email Intelligence API.
+
 ## [4.0.1](http://central.maven.org/maven2/com/telesign/telesign/4.0.1) - 2026-04-22
 - 2026-04-22
     - Fix style for linting.

build.gradle

@@ -9,7 +9,7 @@ plugins {
 }
 
 group 'com.telesign'
-version '4.0.1'
+version '4.1.0'
 
 sourceCompatibility = JavaVersion.VERSION_1_8
 targetCompatibility = JavaVersion.VERSION_1_8
@@ -138,7 +138,7 @@ if (System.getenv('TRAVIS') == null) {
 
                 groupId = 'com.telesign'
                 artifactId = 'telesign'
-                version = '4.0.1'
+                version = '4.1.0'
 
                 pom {
                     name = 'Telesign SDK'

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

@@ -7,11 +7,12 @@
 import java.util.Map;
 
 /**
- * Score provides risk information about a specified phone number.
+ * Score provides risk information about a specified phone number or email address.
  */
 public class ScoreClient extends RestClient {
 
     private static final String INTELLIGENCE_SCORE_RESOURCE = "/intelligence/phone";
+    private static final String EMAIL_INTELLIGENCE_RESOURCE = "/intelligence/email";
 
     private static final String DETECT_REST_ENDPOINT = "https://detect.telesign.com";
 
@@ -57,4 +58,20 @@ public TelesignResponse score(String phoneNumber, String accountLifecycleEvent,
 
         return this.post(INTELLIGENCE_SCORE_RESOURCE, params);
     }
+
+    /**
+     * Obtain a risk recommendation for this email address, as well as other relevant information using Telesign Cloud API.
+     * <p>
+     * See https://developer.telesign.com/enterprise/reference/submitemailaddressforemailintelligence for detailed API documentation.
+     */
+    public TelesignResponse emailIntelligence(String emailAddress, String accountLifecycleEvent, Map<String, String> params) throws GeneralSecurityException, IOException {
+        if (params == null) {
+            params = new HashMap<>();
+        }
+        
+        params.put("email_address", emailAddress);
+        params.put("account_lifecycle_event", accountLifecycleEvent);
+
+        return this.post(EMAIL_INTELLIGENCE_RESOURCE, params);
+    }
 }

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

@@ -105,4 +105,57 @@ public void testScore() throws Exception {
         assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
                 request.getHeader("x-ts-auth-method"));
     }
+
+    public void testEmailIntelligenceWithParams() throws Exception {
+        HashMap<String, String> params = new HashMap<String, String>() {{
+            put("originating_ip", "127.0.0.1");
+        }};
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        ScoreClient client = new ScoreClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""), null, null, null);
+
+        client.emailIntelligence("support@vero-finto.com", "sign-in", params);
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "POST", request.getMethod());
+        assertEquals("path is not as expected", "/intelligence/email", request.getPath());
+
+        String body = request.getBody().readUtf8();
+        assertTrue("body does not contain email_address", body.contains("email_address=support%40vero-finto.com"));
+        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=sign-in"));
+
+        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 testEmailIntelligence() throws Exception {
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        ScoreClient client = new ScoreClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""), null, null, null);
+
+        client.emailIntelligence("support@vero-finto.com", "create", null);
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "POST", request.getMethod());
+        assertEquals("path is not as expected", "/intelligence/email", request.getPath());
+
+        String body = request.getBody().readUtf8();
+        assertTrue("body does not contain email_address", body.contains("email_address=support%40vero-finto.com"));
+        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"));
+    }
 }

src/test/java/com/telesign/example/score/CheckEmailIntelligenceRiskLevel.java

@@ -0,0 +1,41 @@
+package com.telesign.example.score;
+
+import com.google.gson.JsonObject;
+import com.telesign.RestClient;
+import com.telesign.ScoreClient;
+
+public class CheckEmailIntelligenceRiskLevel {
+
+    public static void main(String[] args) {
+
+        String customerId = "ABC1DE23-A12B-1234-56AB-AB12345678900";
+        String apiKey = "ABC12345yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
+
+        String emailAddress = "support@vero-finto.com";
+        String accountLifecycleEvent = "create";
+
+        try {
+            ScoreClient scoreClient = new ScoreClient(customerId, apiKey);
+            RestClient.TelesignResponse telesignResponse = scoreClient.emailIntelligence(emailAddress, accountLifecycleEvent, null);
+
+            if (telesignResponse.ok) {
+                JsonObject intelligenceDetails = telesignResponse.json.getAsJsonObject("intelligence_details");
+                JsonObject risk = intelligenceDetails.getAsJsonObject("risk");
+
+                System.out.printf("Email address %s intelligence report:%n",
+                        emailAddress);
+                System.out.printf("  Risk Level: %s%n",
+                        risk.get("level").getAsString());
+                System.out.printf("  Risk Score: %d%n",
+                        risk.get("score").getAsInt());
+                System.out.printf("  Recommendation: %s%n",
+                        risk.get("recommendation").getAsString());
+            } 
+            else {
+                System.out.println("Request failed with status: " + telesignResponse.statusCode);
+            }
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+    }
+}