refactor: uri parameter extraction into its own function.

Author: didiergarcia

android/src/main/java/com/segment/analytics/kotlin/android/utilities/DeepLinkUtils.kt

@@ -1,7 +1,9 @@
 package com.segment.analytics.kotlin.android.utilities
 
 import android.content.Intent
+import android.net.Uri
 import com.segment.analytics.kotlin.core.Analytics
+import kotlinx.serialization.json.JsonObject
 import kotlinx.serialization.json.buildJsonObject
 import kotlinx.serialization.json.put
 
@@ -13,13 +15,32 @@ class DeepLinkUtils(val analytics: Analytics) {
             return
         }
 
-        val properties = buildJsonObject {
+        val properties = extractLinkProperties(referrer, intent.data)
+        analytics.track("Deep Link Opened", properties)
+    }
 
+    /**
+     * Builds a JsonObject with the parameters of a given Uri.
+     *
+     * Note: The Uri must be hierarchical (myUri.isHierarchical == true) for parameters to be
+     * extracted.
+     *
+     * Example hierarchical Uri: http://example.com/
+     * Example non-hierarchical Uri: mailto:[email protected]
+     *
+     * Note: we return the given Uri as a property named: "url" since this is what is expected
+     * upstream.
+     */
+    fun extractLinkProperties(
+        referrer: String?,
+        uri: Uri?
+    ): JsonObject {
+        val properties = buildJsonObject {
             referrer?.let {
                 put("referrer", it)
             }
 
-            intent.data?.let { uri ->
+            if (uri != null) {
                 if (uri.isHierarchical) {
                     for (parameter in uri.queryParameterNames) {
                         val value = uri.getQueryParameter(parameter)
@@ -31,6 +52,7 @@ class DeepLinkUtils(val analytics: Analytics) {
                 put("url", uri.toString())
             }
         }
-        analytics.track("Deep Link Opened", properties)
+
+        return properties
     }
 }