Devx 10057 trusted number flag (#604)

feat: Added trusted-number for SMS

Author: dragonmantank

CHANGELOG.md

@@ -2,6 +2,9 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+# [9.5.0] - 2025-12-04
+- Added `trusted-number` to SMS
+
 # [9.4.2] - 2025-10-23
 - Added missing supported languages (Lithuanian and Marathi) to `TextToSpeechLanguage` enum
 

README.md

@@ -74,7 +74,7 @@ Add the following to your `build.gradle` or `build.gradle.kts` file:
 
 ```groovy
 dependencies {
-    implementation("com.vonage:server-sdk:9.4.2")
+    implementation("com.vonage:server-sdk:9.5.0")
 }
 ```
 
@@ -85,7 +85,7 @@ Add the following to the `<dependencies>` section of your `pom.xml` file:
 <dependency>
     <groupId>com.vonage</groupId>
     <artifactId>server-sdk</artifactId>
-    <version>9.4.2</version>
+    <version>9.5.0</version>
 </dependency>
 ```
 

pom.xml

@@ -5,7 +5,7 @@
 
   <groupId>com.vonage</groupId>
   <artifactId>server-sdk</artifactId>
-  <version>9.4.2</version>
+  <version>9.5.0</version>
 
   <name>Vonage Java Server SDK</name>
   <description>Java client for Vonage APIs</description>

src/main/java/com/vonage/client/HttpWrapper.java

@@ -37,7 +37,7 @@
 public class HttpWrapper {
     private static final String
             CLIENT_NAME = "vonage-java-sdk",
-            CLIENT_VERSION = "9.4.2",
+            CLIENT_VERSION = "9.5.0",
             JAVA_VERSION = System.getProperty("java.version"),
             USER_AGENT = String.format("%s/%s java/%s", CLIENT_NAME, CLIENT_VERSION, JAVA_VERSION);
 

src/main/java/com/vonage/client/sms/messages/Message.java

@@ -28,6 +28,7 @@ public abstract class Message extends AbstractQueryParamsRequest {
     private MessageClass messageClass;
     private Long timeToLive;
     private String clientReference, callbackUrl, entityId, contentId;
+    private Boolean trustedNumber;
 
     protected Message(final MessageType type,
                       final String from,
@@ -227,6 +228,25 @@ public void setStatusReportRequired(boolean statusReportRequired) {
         this.statusReportRequired = statusReportRequired;
     }
 
+    /**
+     * Indicates whether this message is being sent from a trusted number.
+     *
+     * @return {@code true} if from a trusted number, {@code false} if not, or {@code null} if unspecified.
+     */
+    public Boolean getTrustedNumber() {
+        return trustedNumber;
+    }
+
+    /**
+     * Sets whether this message is being sent from a trusted number.
+     * This parameter is optional and will only be sent if explicitly set to {@code true} or {@code false}.
+     *
+     * @param trustedNumber {@code true} if from a trusted number, {@code false} if not, or {@code null} to omit.
+     */
+    public void setTrustedNumber(Boolean trustedNumber) {
+        this.trustedNumber = trustedNumber;
+    }
+
     @Override
     public Map<String, String> makeParams() {
         Map<String, String> params = super.makeParams();
@@ -244,6 +264,9 @@ public Map<String, String> makeParams() {
         }
         conditionalAdd("entity-id", entityId);
         conditionalAdd("content-id", contentId);
+        if (trustedNumber != null) {
+            conditionalAdd("trusted-number", trustedNumber ? "true" : "false");
+        }
         return params;
     }
 

src/test/java/com/vonage/client/sms/SmsClientTest.java

@@ -92,6 +92,9 @@ public void runTests() throws Exception {
                 testConstructParamsValidityPeriodTTL();
                 testConstructParamsContentId();
                 testConstructParamsEntityId();
+                testConstructParamsTrustedNumberTrue();
+                testConstructParamsTrustedNumberFalse();
+                testConstructParamsTrustedNumberNull();
                 testParseResponse();
                 testParseResponseInvalidStatus();
                 testParseResponseError();
@@ -228,6 +231,47 @@ void testConstructParamsEntityId() {
                 assertRequestContainsParams(params, message);
             }
 
+            void testConstructParamsTrustedNumberTrue() {
+                Message message = new TextMessage("TestSender", "not-a-number", "Test");
+                message.setTrustedNumber(true);
+                assertEquals(true, message.getTrustedNumber());
+
+                Map<String, String> params = new LinkedHashMap<>();
+                params.put("from", "TestSender");
+                params.put("to", "not-a-number");
+                params.put("type", "text");
+                params.put("text", "Test");
+                params.put("trusted-number", "true");
+                assertRequestContainsParams(params, message);
+            }
+
+            void testConstructParamsTrustedNumberFalse() {
+                Message message = new TextMessage("TestSender", "not-a-number", "Test");
+                message.setTrustedNumber(false);
+                assertEquals(false, message.getTrustedNumber());
+
+                Map<String, String> params = new LinkedHashMap<>();
+                params.put("from", "TestSender");
+                params.put("to", "not-a-number");
+                params.put("type", "text");
+                params.put("text", "Test");
+                params.put("trusted-number", "false");
+                assertRequestContainsParams(params, message);
+            }
+
+            void testConstructParamsTrustedNumberNull() {
+                Message message = new TextMessage("TestSender", "not-a-number", "Test");
+                assertNull(message.getTrustedNumber());
+
+                Map<String, String> params = new LinkedHashMap<>();
+                params.put("from", "TestSender");
+                params.put("to", "not-a-number");
+                params.put("type", "text");
+                params.put("text", "Test");
+                // trusted-number should not be in params when null
+                assertRequestParams(params, message);
+            }
+
             void testParseResponse() throws Exception {
                 SmsSubmissionResponse rs = parseResponse(
                         """