feat: InputAction.Builder#type boolean method

Author: SMadani

CHANGELOG.md

@@ -4,11 +4,12 @@ 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.0.0] - 2024-10-25 (expected)
+## [1.0.0] - 2024-10-25
 First stable GA release
 
 ### Added
 - `Voice.downloadRecording(String, Path)` method
+- `InputAction.Builder.type` Boolean overload method (preferable to the Collection method)
 
 ### Changed
 - `Sms.wasSuccessfullySent()` now an extension function rather than being part of the client

pom.xml

@@ -47,7 +47,7 @@
     <kotlin.compiler.languageVersion>2.0</kotlin.compiler.languageVersion>
     <kotlin.compiler.apiVersion>${kotlin.compiler.languageVersion}</kotlin.compiler.apiVersion>
     <kotlin.compiler.jvmTarget>1.8</kotlin.compiler.jvmTarget>
-    <kotlin.lib.version>2.0.20</kotlin.lib.version>
+    <kotlin.lib.version>2.0.21</kotlin.lib.version>
     <java.version>8</java.version>
   </properties>
 

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

@@ -217,6 +217,25 @@ fun InputAction.Builder.speech(settings: SpeechSettings.Builder.() -> Unit = {})
 fun InputAction.Builder.dtmf(settings: DtmfSettings.Builder.() -> Unit = {}): InputAction.Builder =
     dtmf(DtmfSettings.builder().apply(settings).build())
 
+/**
+ * Sets the input type(s). At least one must be specified (i.e. set to `true`).
+ *
+ * @param dtmf Whether to accept DTMF input.
+ * @param speech Whether to accept speech input.
+ *
+ * @return The updated [InputAction.Builder].
+ * @see InputAction.Builder.type(Collection)
+ */
+fun InputAction.Builder.type(dtmf: Boolean = false, speech: Boolean = false): InputAction.Builder {
+    var type = mutableListOf<String>()
+    if (dtmf) type.add("dtmf")
+    if (speech) type.add("speech")
+    if (type.isEmpty()) {
+        throw IllegalArgumentException("At least one input type must be specified.")
+    }
+    return type(type)
+}
+
 /**
  * Configure the behaviour of call recording transcription. If present (even if all settings are default),
  * transcription is activated. The [ConversationAction.Builder.record] parameter must also be set to `true`.

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

@@ -19,6 +19,7 @@ import com.vonage.client.common.HttpMethod
 import com.vonage.client.voice.*
 import com.vonage.client.voice.ncco.*
 import org.junit.jupiter.api.Assertions.assertArrayEquals
+import org.junit.jupiter.api.assertThrows
 import java.nio.file.Files
 import java.util.*
 import kotlin.io.path.deleteExisting
@@ -596,11 +597,25 @@ class VoiceTest : AbstractTest() {
 
     @Test
     fun `create call with input action required parameters only`() {
-        val types = listOf("dtmf", "speech")
         testSingleNcco(
-            additionalParams = mapOf("type" to types),
-            ncco = inputAction { type(types) }
+            additionalParams = mapOf("type" to listOf("dtmf", "speech")),
+            ncco = inputAction { type(speech = true, dtmf = true) }
         )
+        testSingleNcco(
+            additionalParams = mapOf("type" to listOf("dtmf")),
+            ncco = inputAction { type(dtmf = true) }
+        )
+        testSingleNcco(
+            additionalParams = mapOf("type" to listOf("speech")),
+            ncco = inputAction { type(speech = true) }
+        )
+    }
+
+    @Test
+    fun `at least one type should be specified in inputAction`() {
+        assertThrows<IllegalArgumentException> {
+            inputAction { type() }
+        }
     }
 
     @Test