[#1372] Throw if parsing configuration failed

- Closes #1372
- Follow up #1373

configuration-api-lib/src/commonMain/kotlin/co/electriccoin/zcash/configuration/api/MergingConfigurationProvider.kt

@@ -40,6 +40,8 @@ private data class MergingConfiguration(private val configurations: PersistentLi
         return null != configurations.firstWithKey(key)
     }
 
+    // TODO [#1373]: Catch and log Configuration Key Coercion Failures
+    // TODO [#1373]: https://github.com/Electric-Coin-Company/zashi-android/issues/1373
     override fun getBoolean(
         key: ConfigKey,
         defaultValue: Boolean
@@ -49,6 +51,8 @@ private data class MergingConfiguration(private val configurations: PersistentLi
         } ?: defaultValue
     }
 
+    // TODO [#1373]: Catch and log Configuration Key Coercion Failures
+    // TODO [#1373]: https://github.com/Electric-Coin-Company/zashi-android/issues/1373
     override fun getInt(
         key: ConfigKey,
         defaultValue: Int

configuration-api-lib/src/commonMain/kotlin/co/electriccoin/zcash/configuration/model/entry/BooleanConfigurationEntry.kt

@@ -6,5 +6,7 @@ data class BooleanConfigurationEntry(
     override val key: ConfigKey,
     private val defaultValue: Boolean
 ) : DefaultEntry<Boolean> {
+    // TODO [#1373]: Catch and log Configuration Key Coercion Failures
+    // TODO [#1373]: https://github.com/Electric-Coin-Company/zashi-android/issues/1373
     override fun getValue(configuration: Configuration) = configuration.getBoolean(key, defaultValue)
 }

configuration-api-lib/src/commonMain/kotlin/co/electriccoin/zcash/configuration/model/entry/IntegerConfigurationEntry.kt

@@ -6,5 +6,7 @@ data class IntegerConfigurationEntry(
     override val key: ConfigKey,
     private val defaultValue: Int
 ) : DefaultEntry<Int> {
+    // TODO [#1373]: Catch and log Configuration Key Coercion Failures
+    // TODO [#1373]: https://github.com/Electric-Coin-Company/zashi-android/issues/1373
     override fun getValue(configuration: Configuration) = configuration.getInt(key, defaultValue)
 }

configuration-api-lib/src/commonMain/kotlin/co/electriccoin/zcash/configuration/model/exception/ConfigurationParseException.kt

@@ -0,0 +1,7 @@
+package co.electriccoin.zcash.configuration.model.exception
+
+/**
+ * Exception that may occur when parsing a value from the remote configuration. This could mean that someone made an
+ * error in the remote config console.
+ */
+class ConfigurationParseException(message: String, cause: Throwable?) : IllegalArgumentException(message, cause)

configuration-api-lib/src/commonMain/kotlin/co/electriccoin/zcash/configuration/model/map/StringConfiguration.kt

@@ -1,6 +1,7 @@
 package co.electriccoin.zcash.configuration.model.map
 
 import co.electriccoin.zcash.configuration.model.entry.ConfigKey
+import co.electriccoin.zcash.configuration.model.exception.ConfigurationParseException
 import kotlinx.collections.immutable.PersistentMap
 import kotlinx.datetime.Instant
 
@@ -10,31 +11,35 @@ data class StringConfiguration(
     val configurationMapping: PersistentMap<String, String>,
     override val updatedAt: Instant?
 ) : Configuration {
+    @Throws(ConfigurationParseException::class)
     override fun getBoolean(
         key: ConfigKey,
         defaultValue: Boolean
     ) = configurationMapping[key.key]?.let {
         try {
             it.toBooleanStrict()
-        } catch (
+        } catch (e: IllegalArgumentException) {
-            @Suppress("SwallowedException") e: IllegalArgumentException
+            throw ConfigurationParseException(
-        ) {
+                "Failed while parsing String value to Boolean. This could mean " +
-            // In the future, log coercion failure as this could mean someone made an error in the remote config console
+                    "someone made an error in the remote config console",
-            defaultValue
+                e
+            )
         }
     } ?: defaultValue
 
+    @Throws(ConfigurationParseException::class)
     override fun getInt(
         key: ConfigKey,
         defaultValue: Int
     ) = configurationMapping[key.key]?.let {
         try {
             it.toInt()
-        } catch (
+        } catch (e: IllegalArgumentException) {
-            @Suppress("SwallowedException") e: NumberFormatException
+            throw ConfigurationParseException(
-        ) {
+                "Failed while parsing String value to Int. This could mean " +
-            // In the future, log coercion failure as this could mean someone made an error in the remote config console
+                    "someone made an error in the remote config console",
-            defaultValue
+                e
+            )
         }
     } ?: defaultValue
 

configuration-api-lib/src/commonTest/kotlin/co/electriccoin/zcash/configuration/test/MockConfiguration.kt

@@ -1,6 +1,7 @@
 package co.electriccoin.zcash.configuration.test
 
 import co.electriccoin.zcash.configuration.model.entry.ConfigKey
+import co.electriccoin.zcash.configuration.model.exception.ConfigurationParseException
 import co.electriccoin.zcash.configuration.model.map.Configuration
 import kotlinx.datetime.Instant
 
@@ -13,31 +14,35 @@ import kotlinx.datetime.Instant
 class MockConfiguration(private val configurationMapping: Map<String, String> = emptyMap()) : Configuration {
     override val updatedAt: Instant? = null
 
+    @Throws(ConfigurationParseException::class)
     override fun getBoolean(
         key: ConfigKey,
         defaultValue: Boolean
     ) = configurationMapping[key.key]?.let {
         try {
             it.toBooleanStrict()
-        } catch (
+        } catch (e: IllegalArgumentException) {
-            @Suppress("SwallowedException") e: IllegalArgumentException
+            throw ConfigurationParseException(
-        ) {
+                "Failed while parsing String value to Boolean. This could mean " +
-            // In the future, log coercion failure as this could mean someone made an error in the remote config console
+                    "someone made an error in the remote config console",
-            defaultValue
+                e
+            )
         }
     } ?: defaultValue
 
+    @Throws(ConfigurationParseException::class)
     override fun getInt(
         key: ConfigKey,
         defaultValue: Int
     ) = configurationMapping[key.key]?.let {
         try {
             it.toInt()
-        } catch (
+        } catch (e: IllegalArgumentException) {
-            @Suppress("SwallowedException") e: NumberFormatException
+            throw ConfigurationParseException(
-        ) {
+                "Failed while parsing String value to Int. This could mean " +
-            // In the future, log coercion failure as this could mean someone made an error in the remote config console
+                    "someone made an error in the remote config console",
-            defaultValue
+                e
+            )
         }
     } ?: defaultValue