add top level anonymous id method (#78)

* address api discrepancies between kotlin and swift

* update java compat

* add unit tests

* correct typo

Author: wenxi-zeng

core/src/main/java/com/segment/analytics/kotlin/core/Analytics.kt

@@ -56,6 +56,12 @@ open class Analytics protected constructor(
                 SegmentLog.loggingEnabled = value
                 field = value
             }
+
+        /**
+         * Retrieve the version of this library in use.
+         * - Returns: A string representing the version in "BREAKING.FEATURE.FIX" format.
+         */
+        fun version(): String = Constants.LIBRARY_VERSION
     }
 
     init {
@@ -517,6 +523,30 @@ open class Analytics protected constructor(
         val system = store.currentState(System::class)
         return system?.settings
     }
+
+    /**
+     * Retrieve the anonymousId  in a blocking way.
+     * Note: this method invokes `runBlocking` internal, it's not recommended to be used
+     * in coroutines.
+     */
+    @BlockingApi
+    fun anonymousId(): String = runBlocking {
+        anonymousIdAsync()
+    }
+
+    /**
+     * Retrieve the anonymousId
+     */
+    suspend fun anonymousIdAsync(): String {
+        val userInfo = store.currentState(UserInfo::class)
+        return userInfo?.anonymousId ?: ""
+    }
+
+    /**
+     * Retrieve the version of this library in use.
+     * - Returns: A string representing the version in "BREAKING.FEATURE.FIX" format.
+    */
+    fun version() = Analytics.version()
 }
 
 

core/src/main/java/com/segment/analytics/kotlin/core/compat/JavaAnalytics.kt

@@ -244,6 +244,17 @@ class JavaAnalytics private constructor() {
      */
     fun settings() = analytics.settings()
 
+    /**
+     * Retrieve the anonymousId
+     */
+    fun anonymousId() = analytics.anonymousId()
+
+    /**
+     * Retrieve the version of this library in use.
+     * - Returns: A string representing the version in "BREAKING.FEATURE.FIX" format.
+     */
+    fun version() = analytics.version()
+
     private fun setup(analytics: Analytics) {
         store = analytics.store
         storage = analytics.storage

core/src/test/kotlin/com/segment/analytics/kotlin/core/AnalyticsTests.kt

@@ -3,11 +3,7 @@ package com.segment.analytics.kotlin.core
 import com.segment.analytics.kotlin.core.platform.Plugin
 import com.segment.analytics.kotlin.core.platform.plugins.ContextPlugin
 import com.segment.analytics.kotlin.core.utils.*
-import io.mockk.every
-import io.mockk.mockkStatic
-import io.mockk.slot
-import io.mockk.spyk
-import io.mockk.verify
+import io.mockk.*
 import kotlinx.coroutines.test.UnconfinedTestDispatcher
 import kotlinx.coroutines.test.TestScope
 import kotlinx.coroutines.test.runTest
@@ -391,6 +387,20 @@ class AnalyticsTests {
         }
     }
 
+    @Nested
+    inner class AnonymousId {
+        @Test
+        fun `anonymousId fetches current Analytics anonymousId`() = runTest {
+            assertEquals("qwerty-qwerty-123", analytics.anonymousIdAsync())
+        }
+
+        @Test
+        fun `anonymousId returns empty string when null`() = runTest {
+            coEvery { analytics.store.currentState(UserInfo::class) } returns null
+            assertEquals("", analytics.anonymousIdAsync())
+        }
+    }
+
     @Test
     fun `settings fetches current Analytics Settings`() = runTest {
         val settings = Settings(
@@ -405,6 +415,11 @@ class AnalyticsTests {
         assertEquals(settings, analytics.settings())
     }
 
+    @Test
+    fun `version fetches current Analytics version`() {
+        assertEquals(Constants.LIBRARY_VERSION, analytics.version())
+    }
+
     private fun BaseEvent.populate() = apply {
         anonymousId = "qwerty-qwerty-123"
         messageId = "qwerty-qwerty-123"

core/src/test/kotlin/com/segment/analytics/kotlin/core/compat/JavaAnalyticsTest.kt

@@ -464,6 +464,16 @@ internal class JavaAnalyticsTest {
         assertEquals(settings, analytics.settings())
     }
 
+    @Test
+    fun anonymousId() {
+        assertEquals("qwerty-qwerty-123", analytics.anonymousId())
+    }
+
+    @Test
+    fun version() {
+        assertEquals(Constants.LIBRARY_VERSION, analytics.version())
+    }
+
     private fun BaseEvent.populate() = apply {
         anonymousId = "qwerty-qwerty-123"
         messageId = "qwerty-qwerty-123"