feat: Add MMS text/file/content messages (#27)

Author: SMadani

CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [1.2.0] - 2025-03-05
+
+### Added
+- Support for MMS text, file and multimedia content types in `Messages`
+
+### Changed
+- Bumped Java SDK version to 8.18.0
+
 ## [1.1.4] - 2025-02-28
 
 ### Added

README.md

@@ -53,7 +53,7 @@ See all of our SDKs and integrations on the [Vonage Developer portal](https://de
 ## Installation
 Releases are published to [Maven Central](https://central.sonatype.com/artifact/com.vonage/server-sdk-kotlin).
 Instructions for your build system can be found in the snippets section.
-They're also available from [here](https://search.maven.org/artifact/com.vonage/server-sdk-kotlin/1.1.4/jar).
+They're also available from [here](https://search.maven.org/artifact/com.vonage/server-sdk-kotlin/1.2.0/jar).
 Release notes for each version can be found in the [changelog](CHANGELOG.md).
 
 Here are the instructions for including the SDK in your project:
@@ -63,7 +63,7 @@ Add the following to your `build.gradle` or `build.gradle.kts` file:
 
 ```groovy
 dependencies {
-    implementation("com.vonage:server-sdk-kotlin:1.1.4")
+    implementation("com.vonage:server-sdk-kotlin:1.2.0")
 }
 ```
 
@@ -74,7 +74,7 @@ Add the following to the `<dependencies>` section of your `pom.xml` file:
 <dependency>
     <groupId>com.vonage</groupId>
     <artifactId>server-sdk-kotlin</artifactId>
-    <version>1.1.4</version>
+    <version>1.2.0</version>
 </dependency>
 ```
 
@@ -160,8 +160,8 @@ including [**a searchable list of snippets**](https://github.com/Vonage/vonage-k
 
 The SDK is fully documented with [KDocs](https://kotlinlang.org/docs/kotlin-doc.html), so you should have complete
 documentation from your IDE. You may need to click "Download Sources" in IntelliJ to get the full documentation.
-Alternatively, you can browse the documentation  using a service like [Javadoc.io](https://javadoc.io/doc/com.vonage/server-sdk-kotlin/1.1.4/index.html),
-which renders the documentation for you from [the artifacts on Maven Central](https://repo.maven.apache.org/maven2/com/vonage/server-sdk-kotlin/1.1.4/).
+Alternatively, you can browse the documentation  using a service like [Javadoc.io](https://javadoc.io/doc/com.vonage/server-sdk-kotlin/1.2.0/index.html),
+which renders the documentation for you from [the artifacts on Maven Central](https://repo.maven.apache.org/maven2/com/vonage/server-sdk-kotlin/1.2.0/).
 
 For help with any specific APIs, refer to the relevant documentation on our [developer portal](https://developer.vonage.com/en/documentation),
 using the links provided in the [Supported APIs](#supported-apis) section. For completeness, you can also consult the

pom.xml

@@ -5,7 +5,7 @@
 
   <groupId>com.vonage</groupId>
   <artifactId>server-sdk-kotlin</artifactId>
-  <version>1.1.4</version>
+  <version>1.2.0</version>
 
   <name>Vonage Kotlin Server SDK</name>
   <description>Kotlin client for Vonage APIs</description>
@@ -55,7 +55,7 @@
     <dependency>
       <groupId>com.vonage</groupId>
       <artifactId>server-sdk</artifactId>
-      <version>8.17.0</version>
+      <version>8.18.0</version>
     </dependency>
     <dependency>
       <groupId>org.jetbrains.kotlin</groupId>
@@ -77,7 +77,7 @@
     <dependency>
       <groupId>org.wiremock</groupId>
       <artifactId>wiremock-standalone</artifactId>
-      <version>3.12.0</version>
+      <version>3.12.1</version>
       <scope>test</scope>
     </dependency>
   </dependencies>

src/main/kotlin/com/vonage/client/kt/Messages.kt

@@ -113,6 +113,18 @@ class Messages internal constructor(private val client: MessagesClient) {
 fun smsText(properties: SmsTextRequest.Builder.() -> Unit): SmsTextRequest =
     SmsTextRequest.builder().apply(properties).build()
 
+/**
+ * Create an MMS text message.
+ *
+ * @param properties A lambda function for setting the message's parameters.
+ *
+ * @return An [MmsTextRequest] object with the specified properties.
+ *
+ * @since 1.2.0
+ */
+fun mmsText(properties: MmsTextRequest.Builder.() -> Unit): MmsTextRequest =
+    MmsTextRequest.builder().apply(properties).build()
+
 /**
  * Creates an MMS vCard message.
  *
@@ -153,6 +165,30 @@ fun mmsAudio(properties: MmsAudioRequest.Builder.() -> Unit): MmsAudioRequest =
 fun mmsVideo(properties: MmsVideoRequest.Builder.() -> Unit): MmsVideoRequest =
     MmsVideoRequest.builder().apply(properties).build()
 
+/**
+ * Creates an MMS file message.
+ *
+ * @param properties A lambda function for setting the message's parameters.
+ *
+ * @return An [MmsFileRequest] object with the specified properties.
+ *
+ * @since 1.2.0
+ */
+fun mmsFile(properties: MmsFileRequest.Builder.() -> Unit): MmsFileRequest =
+    MmsFileRequest.builder().apply(properties).build()
+
+/**
+ * Creates an MMS content message for sending multiple media files.
+ *
+ * @param properties A lambda function for setting the message's parameters.
+ *
+ * @return An [MmsContentRequest] object with the specified properties.
+ *
+ * @since 1.2.0
+ */
+fun mmsContent(properties: MmsContentRequest.Builder.() -> Unit): MmsContentRequest =
+    MmsContentRequest.builder().apply(properties).build()
+
 /**
  * Creates a WhatsApp text message.
  *

src/main/kotlin/com/vonage/client/kt/Vonage.kt

@@ -21,7 +21,7 @@ import com.vonage.client.VonageClient
 /**
  * Denotes the version of the Vonage Kotlin SDK being used, in SemVer format.
  */
-const val VONAGE_KOTLIN_SDK_VERSION = "1.1.4"
+const val VONAGE_KOTLIN_SDK_VERSION = "1.2.0"
 
 /**
  * The non-overridable user agent string used by the SDK.

src/test/kotlin/com/vonage/client/kt/AbstractTest.kt

@@ -105,6 +105,7 @@ abstract class AbstractTest {
     protected val audioUrl = "$exampleUrlBase/audio.mp3"
     protected val videoUrl = "$exampleUrlBase/video.mp4"
     protected val fileUrl = "$exampleUrlBase/file.pdf"
+    protected val vcardUrl = "$exampleUrlBase/contact.vcf"
 
     private val port = 8081
     protected val wmBaseUrl = "http://localhost:$port"

src/test/kotlin/com/vonage/client/kt/MessagesTest.kt

@@ -27,6 +27,7 @@ import java.net.URI
 import java.util.*
 import kotlin.test.assertEquals
 import kotlin.test.assertNotNull
+import kotlin.test.assertNull
 
 class MessagesTest : AbstractTest() {
     private val client = vonage.messages
@@ -117,6 +118,14 @@ class MessagesTest : AbstractTest() {
         })
     }
 
+    @Test
+    fun `send MMS text with TTL`() {
+        val ttl = 600
+        testSend(textBody(mmsChannel) + mapOf("ttl" to ttl), mmsText {
+            from(altNumber); to(toNumber); text(text); ttl(ttl)
+        })
+    }
+
     @Test
     fun `send RCS text`() {
         testSend(textBody(rcsChannel), rcsText {
@@ -147,7 +156,6 @@ class MessagesTest : AbstractTest() {
 
     @Test
     fun `send MMS vCard`() {
-        val vcardUrl = "https://example.com/conatact.vcf"
         testSend(mediaBody(mmsChannel, "vcard", vcardUrl, captionMap), mmsVcard {
             from(altNumber); to(toNumber); url(vcardUrl); caption(caption)
         })
@@ -257,6 +265,13 @@ class MessagesTest : AbstractTest() {
         })
     }
 
+    @Test
+    fun `send MMS file`() {
+        testSend(fileBody(mmsChannel, captionMap), mmsFile {
+            from(altNumber); to(toNumber); url(fileUrl); caption(caption)
+        })
+    }
+
     @Test
     fun `send RCS file`() {
         testSend(fileBody(rcsChannel), rcsFile {
@@ -287,6 +302,28 @@ class MessagesTest : AbstractTest() {
         })
     }
 
+    @Test
+    fun `send MMS content`() {
+        testSend(baseBody("content", mmsChannel) + mapOf(
+            "content" to listOf(
+                mapOf("type" to "file", "url" to fileUrl, "caption" to caption),
+                mapOf("type" to "image", "url" to imageUrl, "caption" to caption),
+                mapOf("type" to "audio", "url" to audioUrl, "caption" to caption),
+                mapOf("type" to "video", "url" to videoUrl, "caption" to caption),
+                mapOf("type" to "vcard", "url" to vcardUrl, "caption" to caption)
+            )
+        ),
+            mmsContent {
+                from(altNumber); to(toNumber)
+                addFile(fileUrl, caption)
+                addImage(imageUrl, caption)
+                addAudio(audioUrl, caption)
+                addVideo(videoUrl, caption)
+                addVcard(vcardUrl, caption)
+            }
+        )
+    }
+
     @Test
     fun `send WhatsApp reaction`() {
         val emoji = "😍"
@@ -591,7 +628,14 @@ class MessagesTest : AbstractTest() {
                       "url": "$imageUrl",
                       "name": "image.jpg",
                       "caption": "$caption"
-                   }
+                   },
+                   "content": [
+                      {
+                         "type": "image",
+                         "url": "$imageUrl",
+                         "caption": "$caption"
+                      }
+                   ]
                 }
             """
         )
@@ -605,6 +649,13 @@ class MessagesTest : AbstractTest() {
         assertEquals(MessageType.IMAGE, parsed.messageType)
         assertEquals(URI.create(imageUrl), parsed.imageUrl)
         assertEquals(caption, parsed.imageCaption)
+        val content = parsed.content
+        assertNotNull(content)
+        assertEquals(1, content.size)
+        val contentImage = content[0]
+        assertEquals(MessageType.IMAGE, contentImage.type)
+        assertEquals(URI.create(imageUrl), contentImage.url)
+        assertEquals(caption, contentImage.caption)
     }
 
     @Test

src/test/kotlin/com/vonage/client/kt/VoiceTest.kt

@@ -16,6 +16,7 @@
 package com.vonage.client.kt
 
 import com.vonage.client.common.HttpMethod
+import com.vonage.client.common.SortOrder
 import com.vonage.client.voice.*
 import com.vonage.client.voice.ncco.*
 import org.junit.jupiter.api.Assertions.assertArrayEquals
@@ -244,7 +245,7 @@ class VoiceTest : AbstractTest() {
         )
 
         testCreateCall(requestParams) {
-            ncco(ncco); fromRandomNumber(true);
+            ncco(ncco); fromRandomNumber(true)
             to(com.vonage.client.voice.WebSocketEndpoint(websocketUri, null, null))
         }
     }
@@ -415,7 +416,7 @@ class VoiceTest : AbstractTest() {
             status(CallStatus.UNANSWERED)
             dateStart(startTime); dateEnd(endTime)
             pageSize(pageSize); recordIndex(recordIndex)
-            order(CallOrder.DESCENDING); conversationUuid(conversationId)
+            order(SortOrder.DESCENDING); conversationUuid(conversationId)
         }
 
         assertEqualsSampleCallsPage(callsPage)
@@ -579,7 +580,7 @@ class VoiceTest : AbstractTest() {
             "ringing_timer" to ringingTimer
         )) {
             answerUrl(answerUrl); answerMethod(answerMethod)
-            from(fromPstn); fromRandomNumber(false);
+            from(fromPstn); fromRandomNumber(false)
             eventUrl(eventUrl); eventMethod(eventMethod)
             lengthTimer(lengthTimer); ringingTimer(ringingTimer)
             advancedMachineDetection {
@@ -824,7 +825,7 @@ class VoiceTest : AbstractTest() {
         val premium = true
         val loop = 2
         val style = 1
-        val level = -0.5f
+        val level = -0.5
         val canHearId = UUID.randomUUID().toString()
         val canSpeakId = UUID.randomUUID().toString()
         val conversationEventMethod = EventMethod.POST
@@ -839,7 +840,7 @@ class VoiceTest : AbstractTest() {
         val record = true
         val endOnExit = true
         val startOnEnter = true
-        val inputActionTypes = listOf("dtmf", "speech")
+        val inputActionTypes = listOf("speech", "dtmf")
         val dtmfTimeout = 7
         val maxDigits = 16
         val submitOnHash = true
@@ -994,17 +995,17 @@ class VoiceTest : AbstractTest() {
                     addCanHear(canHearId); addCanSpeak(canSpeakId)
                     addCanHear(testUuidStr); addCanSpeak(testUuidStr)
                     eventMethod(conversationEventMethod); eventUrl(eventUrl)
-                    musicOnHoldUrl(musicOnHoldUrl); record(record); mute(mute);
+                    musicOnHoldUrl(musicOnHoldUrl); record(record); mute(mute)
                     startOnEnter(startOnEnter); endOnExit(endOnExit)
                     transcription {
                         eventMethod(transcriptionEventMethod); eventUrl(transcriptionEventUrl)
-                        language(SpeechSettings.Language.SPANISH_DOMINICAN_REPUBLIC);
+                        language(SpeechSettings.Language.SPANISH_DOMINICAN_REPUBLIC)
                         sentimentAnalysis(true)
                     }
                 },
                 inputAction {
                     eventUrl(eventUrl); eventMethod(inputEventMethod)
-                    type(inputActionTypes); speech {
+                    speech {
                         uuid(speechUuid); context(speechContext); saveAudio(saveAudio)
                         language(SpeechSettings.Language.UKRAINIAN)
                         endOnSilence(endOnSilenceSpeech); maxDuration(maxDuration)
@@ -1019,15 +1020,15 @@ class VoiceTest : AbstractTest() {
                     timeOut(recordingTimeout); channels(recordingChannels)
                     endOnKey(endOnKey); endOnSilence(endOnSilenceRecording)
                     eventUrl(recordEventUrl); eventMethod(recordEventMethod)
-                    split(splitRecording); beepStart(beepStart); transcription {
+                    beepStart(beepStart); transcription {
                         language(SpeechSettings.Language.ENGLISH_SOUTH_AFRICA)
                         eventUrl(eventUrl); eventMethod(transcriptionEventMethod)
                         sentimentAnalysis(false)
                     }
                 },
                 connectAction(com.vonage.client.voice.ncco.PhoneEndpoint.builder(altNumber).dtmfAnswer(dtmf).build()) {
                     eventUrl(eventUrl); eventMethod(connectEventMethod); limit(limit)
-                    eventType(eventType); timeOut(connectTimeout); ringbackTone(ringbackTone);
+                    eventType(eventType); timeOut(connectTimeout); ringbackTone(ringbackTone)
                     randomFromNumber(true); advancedMachineDetection {
                         beepTimeout(beepTimeout)
                     }