Release 2.15.2

.github/workflows/lint_unitTests_build.yml

@@ -11,6 +11,9 @@ on:
       - reopened
       - synchronize
 
+permissions:
+  contents: read
+
 jobs:
   lint:
     runs-on: ubuntu-latest
@@ -64,13 +67,34 @@ jobs:
       - name: Setup Android SDK
         uses: android-actions/setup-android@v2
 
-      - name: unit tests
-        run: ./gradlew --no-daemon --stacktrace testDebugUnitTest
+      - name: unit tests with coverage
+        run: ./gradlew --no-daemon --stacktrace testDebugUnitTest koverHtmlReport
 
       - name: test report
         uses: asadmansr/android-test-report-action@v1.2.0
         if: ${{ always() }}
 
+      - name: upload coverage report
+        uses: actions/upload-pages-artifact@v3
+        if: github.ref == 'refs/heads/develop'
+        with:
+          path: build/reports/kover/html
+
+  deploy-coverage:
+    runs-on: ubuntu-latest
+    needs: unit
+    if: github.ref == 'refs/heads/develop'
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+    steps:
+      - name: deploy to GitHub Pages
+        id: deploy
+        uses: actions/deploy-pages@v4
+
   build:
     runs-on: ubuntu-latest 
     steps:

build.gradle

@@ -22,6 +22,19 @@ allprojects {
     }
 }
 
+apply plugin: 'org.jetbrains.kotlinx.kover'
+
+dependencies {
+    kover(project(':sdk'))
+    kover(project(':mindbox-firebase'))
+    kover(project(':mindbox-huawei'))
+    kover(project(':mindbox-rustore'))
+    kover(project(':mindbox-firebase-starter'))
+    kover(project(':mindbox-huawei-starter'))
+    kover(project(':mindbox-rustore-starter'))
+    kover(project(':mindbox-sdk-starter-core'))
+}
+
 tasks.register('clean', Delete) {
     delete rootProject.getLayout().getBuildDirectory()
 }

example/app/build.gradle

@@ -87,12 +87,12 @@ dependencies {
     implementation 'com.google.firebase:firebase-analytics-ktx'
     implementation 'com.google.firebase:firebase-messaging-ktx'
     implementation 'com.huawei.hms:push:6.11.0.300'
-    implementation 'ru.rustore.sdk:pushclient:6.10.0'
+    implementation 'ru.rustore.sdk:pushclient:7.2.0'
 
     implementation 'com.google.code.gson:gson:2.11.0'
 
     //Mindbox
-    implementation 'cloud.mindbox:mobile-sdk:2.15.1'
+    implementation 'cloud.mindbox:mobile-sdk:2.15.2'
     implementation 'cloud.mindbox:mindbox-firebase'
     implementation 'cloud.mindbox:mindbox-huawei'
     implementation 'cloud.mindbox:mindbox-rustore'

gradle.properties

@@ -20,7 +20,7 @@ android.enableJetifier=true
 # Kotlin code style for this project: "official" or "obsolete":
 kotlin.code.style=official
 # SDK version property
-SDK_VERSION_NAME=2.15.1
+SDK_VERSION_NAME=2.15.2
 USE_LOCAL_MINDBOX_COMMON=true
 android.nonTransitiveRClass=false
 kotlin.mpp.androidGradlePluginCompatibility.nowarn=true

gradle/libs.versions.toml

@@ -39,8 +39,9 @@ agcp = "1.9.1.300"
 ktlint-plugin = "12.1.1"
 ksp = "1.9.22-1.0.17"
 maven_publish = "0.32.0"
+kover = "0.8.3"
 
-pushclient = "6.10.0"
+pushclient = "7.2.0"
 
 [bundles]
 buildscript-plugins = [
@@ -51,6 +52,7 @@ buildscript-plugins = [
     "ktlint_gradle_plugin",
     "ksp_gradle_plugin",
     "maven_publish_plugin",
+    "kover_gradle_plugin",
 ]
 
 test = [
@@ -116,4 +118,5 @@ google_services = { module = "com.google.gms:google-services", version.ref = "go
 agcp = { module = "com.huawei.agconnect:agcp", version.ref = "agcp" }
 ktlint_gradle_plugin = { module = "org.jlleitschuh.gradle:ktlint-gradle", version.ref = "ktlint-plugin" }
 ksp_gradle_plugin = { module = "com.google.devtools.ksp:symbol-processing-gradle-plugin", version.ref = "ksp" }
-maven_publish_plugin = { module = "com.vanniktech:gradle-maven-publish-plugin", version.ref = "maven_publish" }
+maven_publish_plugin = { module = "com.vanniktech:gradle-maven-publish-plugin", version.ref = "maven_publish" }
+kover_gradle_plugin = { module = "org.jetbrains.kotlinx:kover-gradle-plugin", version.ref = "kover" }

modulesCommon.gradle

@@ -3,6 +3,7 @@ apply plugin: 'kotlin-android'
 apply plugin: 'signing'
 apply plugin: 'org.jlleitschuh.gradle.ktlint'
 apply plugin: 'com.vanniktech.maven.publish'
+apply plugin: 'org.jetbrains.kotlinx.kover'
 
 group = 'com.github.mindbox-cloud'
 

sdk/src/androidTest/java/cloud/mindbox/mobile_sdk/InputParametersUnitTest.kt

@@ -7,13 +7,16 @@ class InputParametersUnitTest {
 
     private val wrongDomainParameter = arrayListOf(
         "",
-        "https://api.mindbox.ru",
-        "api.mindbox.ru/",
-        "https://api.mindbox.ru/",
         "hgkkjhhv",
         "4854-t789"
     )
 
+    private val normalizedDomainParameter = arrayListOf(
+        "https://api.mindbox.ru",
+        "api.mindbox.ru/",
+        "https://api.mindbox.ru/"
+    )
+
     private val wrongUuidParameters = arrayListOf(
         "ларалтка ыфдво",
         "7659d 79",
@@ -115,45 +118,22 @@ class InputParametersUnitTest {
     }
 
     @Test
-    fun domain_startsWithHttps() {
-        val errors = SdkValidation.validateConfiguration(
-            domain = wrongDomainParameter[1],
-            endpointId = rightEndpointParameter,
-            previousDeviceUUID = rightUuidParameter,
-            previousInstallationId = rightUuidParameter
-        )
-        assertEquals(1, errors.size)
-        assertEquals(SdkValidation.Error.INVALID_FORMAT_DOMAIN, errors[0])
-    }
-
-    @Test
-    fun domain_endsWithSlash() {
-        val errors = SdkValidation.validateConfiguration(
-            domain = wrongDomainParameter[2],
-            endpointId = rightEndpointParameter,
-            previousDeviceUUID = rightUuidParameter,
-            previousInstallationId = rightUuidParameter
-        )
-        assertEquals(1, errors.size)
-        assertEquals(SdkValidation.Error.INVALID_FORMAT_DOMAIN, errors[0])
-    }
-
-    @Test
-    fun domain_startsWithHttpsAndEndsWithSlash() {
-        val errors = SdkValidation.validateConfiguration(
-            domain = wrongDomainParameter[3],
-            endpointId = rightEndpointParameter,
-            previousDeviceUUID = rightUuidParameter,
-            previousInstallationId = rightUuidParameter
-        )
-        assertEquals(1, errors.size)
-        assertEquals(SdkValidation.Error.INVALID_FORMAT_DOMAIN, errors[0])
+    fun domain_withSchemeOrTrailingSlash_isNormalized() {
+        normalizedDomainParameter.forEach { input ->
+            val errors = SdkValidation.validateConfiguration(
+                domain = input,
+                endpointId = rightEndpointParameter,
+                previousDeviceUUID = rightUuidParameter,
+                previousInstallationId = rightUuidParameter
+            )
+            assertEquals("Expected 0 errors for '$input'", 0, errors.size)
+        }
     }
 
     @Test
     fun domain_InvalidFormat() {
         val errors4 = SdkValidation.validateConfiguration(
-            domain = wrongDomainParameter[4],
+            domain = wrongDomainParameter[1],
             endpointId = rightEndpointParameter,
             previousDeviceUUID = rightUuidParameter,
             previousInstallationId = rightUuidParameter
@@ -162,7 +142,7 @@ class InputParametersUnitTest {
         assertEquals(SdkValidation.Error.INVALID_DOMAIN, errors4[0])
 
         val errors5 = SdkValidation.validateConfiguration(
-            domain = wrongDomainParameter[5],
+            domain = wrongDomainParameter[2],
             endpointId = rightEndpointParameter,
             previousDeviceUUID = rightUuidParameter,
             previousInstallationId = rightUuidParameter

sdk/src/main/java/cloud/mindbox/mobile_sdk/Mindbox.kt

@@ -14,9 +14,6 @@ import androidx.lifecycle.Lifecycle.State.RESUMED
 import androidx.lifecycle.ProcessLifecycleOwner
 import androidx.work.WorkerFactory
 import cloud.mindbox.common.MindboxCommon
-import cloud.mindbox.mobile_sdk.Mindbox.disposeDeviceUuidSubscription
-import cloud.mindbox.mobile_sdk.Mindbox.disposePushTokenSubscription
-import cloud.mindbox.mobile_sdk.Mindbox.handleRemoteMessage
 import cloud.mindbox.mobile_sdk.di.MindboxDI
 import cloud.mindbox.mobile_sdk.di.mindboxInject
 import cloud.mindbox.mobile_sdk.inapp.data.managers.SessionStorageManager
@@ -735,18 +732,72 @@ public object Mindbox : MindboxLog {
     }
 
     /**
-     * Method to register callback for InApp Message
+     * Registers a callback for InApp messages.
      *
-     *  Call this method after you call [Mindbox.init]
+     * Call this method after [Mindbox.init]. The SDK holds a **strong reference** to
+     * [inAppCallback], so the callback persists until explicitly replaced or removed via
+     * [unregisterInAppCallback].
      *
-     *  @param inAppCallback used to provide required callback implementation
+     * Calling this method again replaces the previously registered callback.
+     *
+     * **Application-level callback (recommended):**
+     * Register once in `Application.onCreate` with a callback that does not reference any
+     * Activity. No cleanup needed.
+     * ```kotlin
+     * class MyApp : Application() {
+     *     override fun onCreate() {
+     *         super.onCreate()
+     *         Mindbox.init(...)
+     *         Mindbox.registerInAppCallback(MyGlobalInAppCallback())
+     *     }
+     * }
+     * ```
+     *
+     * **Per-screen callback:**
+     * If different screens require different callback behavior and the callback captures an
+     * Activity reference, use `onResume`/`onPause` — **not** `onCreate`/`onDestroy`.
+     * Android guarantees that `onPause` of the current Activity is called before `onResume`
+     * of the next, so callbacks never overlap and the Activity reference is always cleared
+     * before the Activity can be garbage-collected.
+     * ```kotlin
+     * override fun onResume() {
+     *     super.onResume()
+     *     Mindbox.registerInAppCallback(myScreenCallback)
+     * }
+     * override fun onPause() {
+     *     super.onPause()
+     *     Mindbox.unregisterInAppCallback()
+     * }
+     * ```
+     *
+     * @param inAppCallback the callback implementation to register
      **/
-
     public fun registerInAppCallback(inAppCallback: InAppCallback) {
-        MindboxLoggerImpl.d(this, "registerInAppCallback")
+        mindboxLogI("InApp callback registered: ${inAppCallback::class.simpleName}")
         inAppMessageManager.registerInAppCallback(inAppCallback)
     }
 
+    /**
+     * Unregisters the current InApp message callback and restores the default SDK behavior.
+     *
+     * The default behavior handles URL redirects, deep links, payload copying, and logging
+     * automatically — the same actions performed when no custom callback is registered.
+     *
+     * **When to call:**
+     * Only needed for per-screen callbacks registered in `onResume`. Call in the corresponding
+     * `onPause` to release the Activity reference and restore default behavior while another
+     * screen is in the foreground.
+     *
+     * Not needed if the callback was registered at the Application level and does not
+     * reference any Activity.
+     *
+     * @see registerInAppCallback
+     **/
+    public fun unregisterInAppCallback() {
+        mindboxLogI("InApp callback unregistered, default behavior restored")
+        inAppMessageManager.unregisterInAppCallback()
+    }
+
     /**
      * Method to initialise push services
      *
@@ -1386,6 +1437,7 @@ public object Mindbox : MindboxLog {
             endpointId = configuration.endpointId,
             previousDeviceUUID = configuration.previousDeviceUUID,
             previousInstallationId = configuration.previousInstallationId,
+            operationsDomain = configuration.operationsDomain,
         )
 
         return if (validationErrors.isEmpty()) {
@@ -1395,27 +1447,14 @@ public object Mindbox : MindboxLog {
                 throw InitializeMindboxException(validationErrors.toString())
             }
             MindboxLoggerImpl.e(this, "Invalid configuration parameters found: $validationErrors")
-            val isDeviceIdError = validationErrors.contains(
-                SdkValidation.Error.INVALID_DEVICE_ID,
-            )
-            val isInstallationIdError = validationErrors.contains(
-                SdkValidation.Error.INVALID_INSTALLATION_ID,
-            )
-
-            val previousDeviceUUID = if (isDeviceIdError) {
-                ""
-            } else {
-                configuration.previousDeviceUUID
-            }
-            val previousInstallationId = if (isInstallationIdError) {
-                ""
-            } else {
-                configuration.previousInstallationId
-            }
+            val isDeviceIdError = validationErrors.contains(SdkValidation.Error.INVALID_DEVICE_ID)
+            val isInstallationIdError = validationErrors.contains(SdkValidation.Error.INVALID_INSTALLATION_ID)
+            val isOperationsDomainError = validationErrors.contains(SdkValidation.Error.INVALID_OPERATIONS_DOMAIN)
 
             configuration.copy(
-                previousDeviceUUID = previousDeviceUUID,
-                previousInstallationId = previousInstallationId,
+                previousDeviceUUID = if (isDeviceIdError) "" else configuration.previousDeviceUUID,
+                previousInstallationId = if (isInstallationIdError) "" else configuration.previousInstallationId,
+                operationsDomain = if (isOperationsDomainError) null else configuration.operationsDomain,
             )
         }
     }