Bug Fix: Fix change passcode and logout functionality (#64)

* Integrate Koin for dependency injection and refactor PasscodeManager

* Implement Koin dependency injection across Android, iOS, Desktop, and Web sample modules.
* Introduce `passcodeModule` and `initKoin` to manage dependencies for `PasscodeManager`, `PasscodeStorageAdapter`, and ViewModels.
* Refactor `SampleAppNavigation` and `App.kt` to use `koinInject()` and `koinViewModel()` instead of manual dependency passing.
* Update `PasscodeManager` to use `MutableStateFlow.update` for thread-safe state mutations and ensure proper state clearing during initialization and deletion.
* Enhance `PasscodeManager` to automatically save new passcodes to the adapter upon successful confirmation.
* Update `libs.versions.toml` with Koin and KSP dependencies and apply necessary plugins in `build.gradle.kts`.
* Initialize Koin in platform-specific entry points (`SampleApplication`, `MainViewController.kt`, `main.kt`).

* Update passcode actions and handling in navigation and passcode manager

* Refactor `PasscodeAction` by renaming `DeletePasscode` to `ForgetPasscode` and adding `LogOutErasePasscode`.
* Update `PasscodeManager` to handle the new `LogOutErasePasscode` action by invoking `adapter.deletePasscode()` and handle `ForgetPasscode` instead of the former `DeletePasscode`.
* Update `SampleAppNavigation` to inject `PasscodeStorageAdapter` and use `PasscodeAction.LogOutErasePasscode` for session clearing.
* Update `PasscodeScreen` to use `PasscodeAction.ForgetPasscode` when the forgot button is clicked.

* Clean up unused imports and update PasscodeModule header

* Removed unused imports in `SampleAppNavigation.kt`, `SampleApplication.kt`, and `App.kt`.
* Added license header to `PasscodeModule.kt`.
* Applied minor formatting fixes, including trailing commas and whitespace cleanup in `SampleAppNavigation.kt`, `SampleApplication.kt`, `PasscodeModule.kt`, and `PasscodeManager.kt`.

* Update dependency information in module READMEs

* Updated the installation instructions in `mifos-authenticator-biometrics/README.md` to specify the full dependency notation `io.github.openmf:mifos-authenticator-passcode` and simplified the code examples.
* Updated the prerequisites in `mifos-authenticator-passcode/README.md` to use the full Maven coordinate `io.github.openmf:mifos-authenticator-passcode`.

* Rename authentication composition providers and locals

*   Renamed `LibraryLocalCompositionProvider` to `PlatformAuthenticatorLocalCompositionProvider` across all platforms (Android, iOS, Desktop, JS, WasmJS).
*   Renamed `libraryLocalPlatformAuthenticationProvider` to `platformAuthenticationProvider`.
*   Renamed `libraryPlatformAvailableAuthenticationOption` to `platformAvailableAuthenticationOption`.
*   Updated references in `App.kt`, `ChooseAuthOptionScreen.kt`, and `AuthenticationScreen.kt` to reflect the new names.

Author: TheKalpeshPawar

build-logic/convention/src/main/kotlin/KMPLibraryConventionPlugin.kt

@@ -38,6 +38,7 @@ class KMPLibraryConventionPlugin : Plugin<Project> {
 
             dependencies {
                 add("commonMainImplementation", libs.findLibrary("kotlinx.coroutines.core").get())
+                add("commonMainImplementation", libs.findLibrary("koin.core").get())
             }
         }
     }

build.gradle.kts

@@ -10,6 +10,7 @@ plugins {
     alias(libs.plugins.android.lint) apply false
     alias(libs.plugins.kotlin.android) apply false
 
+    alias(libs.plugins.ksp) apply false
     alias(libs.plugins.jetbrains.kotlin.serialization) apply false
     alias(libs.plugins.dependencyGuard) apply false
     alias(libs.plugins.detekt) apply false

cmp-sample-android/build.gradle.kts

@@ -55,6 +55,8 @@ dependencies {
     testImplementation(libs.junit)
     androidTestImplementation(libs.androidx.junit)
     androidTestImplementation(libs.androidx.espresso.core)
-
+    implementation(libs.koin.android)
+    implementation(libs.koin.androidx.compose)
+    implementation(libs.koin.core)
     implementation(libs.androidx.activity.compose)
 }

cmp-sample-android/src/main/kotlin/cmp/sample/android/SampleApplication.kt

@@ -10,5 +10,17 @@
 package cmp.sample.android
 
 import android.app.Application
+import cmp.sample.shared.di.passcodeModule
+import org.koin.android.ext.koin.androidContext
+import org.koin.core.context.startKoin
 
-class SampleApplication : Application()
+class SampleApplication : Application() {
+
+    override fun onCreate() {
+        super.onCreate()
+        startKoin {
+            androidContext(this@SampleApplication)
+            modules(passcodeModule)
+        }
+    }
+}

cmp-sample-desktop/src/desktopMain/kotlin/cmp/sample/desktop/main.kt

@@ -3,9 +3,12 @@ package cmp.sample.desktop
 import androidx.compose.ui.window.Window
 import androidx.compose.ui.window.application
 import cmp.sample.shared.App
+import cmp.sample.shared.di.initKoin
 
 fun main(vararg args: String) = application {
 
+    initKoin()
+
     Window(
         onCloseRequest = ::exitApplication,
         title = "mifos-passcode-sample",

cmp-sample-ios/src/iosMain/kotlin/cmp/sample/ios/MainViewController.kt

@@ -2,7 +2,9 @@ package cmp.sample.ios
 
 import androidx.compose.ui.window.ComposeUIViewController
 import cmp.sample.shared.App
+import cmp.sample.shared.di.initKoin
 
 fun MainViewController() = ComposeUIViewController {
+    initKoin()
     App()
 }

cmp-sample-shared/build.gradle.kts

@@ -20,15 +20,22 @@ kotlin {
 
 
     sourceSets {
-
         commonMain.dependencies {
             implementation(projects.mifosAuthenticatorBiometrics)
             implementation(projects.mifosAuthenticatorPasscode)
 
+            implementation(libs.koin.core)
+            implementation(libs.koin.compose)
+            implementation(libs.koin.compose.viewmodel)
+
             implementation(libs.multiplatform.settings.no.arg)
             implementation(libs.multiplatform.settings.serialization)
             implementation(libs.multiplatform.settings.coroutines)
         }
+        androidMain.dependencies {
+            implementation(libs.koin.android)
+            implementation(libs.koin.androidx.compose)
+        }
     }
 
 }

cmp-sample-shared/src/commonMain/kotlin/cmp/sample/shared/App.kt

@@ -11,36 +11,14 @@ package cmp.sample.shared
 
 import androidx.compose.material3.MaterialTheme
 import androidx.compose.runtime.Composable
-import cmp.sample.shared.chooseAuthOption.ChooseAuthOptionRepository
-import cmp.sample.shared.chooseAuthOption.ChooseAuthOptionScreenViewmodel
 import cmp.sample.shared.navigation.SampleAppNavigation
-import cmp.sample.shared.platformAuthentication.AuthenticationScreenViewModel
-import com.russhwolf.settings.Settings
-import org.mifos.authenticator.biometrics.LibraryLocalCompositionProvider
+import org.mifos.authenticator.biometrics.PlatformAuthenticatorLocalCompositionProvider
 
 @Composable
 fun App() {
-    LibraryLocalCompositionProvider {
+    PlatformAuthenticatorLocalCompositionProvider {
         MaterialTheme {
-            val settings = Settings()
-
-            val chooseAuthOptionRepository = ChooseAuthOptionRepository(settings)
-            val chooseAuthOptionScreenViewmodel = ChooseAuthOptionScreenViewmodel(
-                chooseAuthOptionRepository,
-            )
-
-            val platformAuthOptionScreenViewmodel = AuthenticationScreenViewModel(
-                chooseAuthOptionRepository = chooseAuthOptionRepository,
-                settings = settings,
-            )
-
-            val passcodeStorageAdapter = PasscodeStorageAdapterImpl(settings)
-
-            SampleAppNavigation(
-                passcodeStorageAdapter,
-                chooseAuthOptionScreenViewmodel,
-                platformAuthOptionScreenViewmodel,
-            )
+            SampleAppNavigation()
         }
     }
 }

cmp-sample-shared/src/commonMain/kotlin/cmp/sample/shared/chooseAuthOption/ChooseAuthOptionScreen.kt

@@ -49,13 +49,17 @@ import cmp.sample.shared.chooseAuthOption.components.AuthOptionCard
 import cmp.sample.shared.navigation.Route
 import cmp.sample.shared.theme.blueTint
 import kotlinx.coroutines.launch
-import org.mifos.authenticator.biometrics.libraryLocalPlatformAuthenticationProvider
+import org.koin.compose.koinInject
+import org.koin.compose.viewmodel.koinViewModel
+import org.mifos.authenticator.biometrics.platformAuthenticationProvider
 import org.mifos.authenticator.biometrics.platformAuthenticator.RegistrationResult
+import org.mifos.authenticator.passcode.PasscodeManager
 
 @OptIn(ExperimentalMaterial3Api::class)
 @Composable
 fun ChooseAuthOptionScreen(
-    chooseAuthOptionScreenViewmodel: ChooseAuthOptionScreenViewmodel,
+    chooseAuthOptionScreenViewmodel: ChooseAuthOptionScreenViewmodel = koinViewModel(),
+    passcodeManager: PasscodeManager = koinInject(),
     navController: NavController,
 ) {
     val registrationResult by chooseAuthOptionScreenViewmodel.registrationResult.collectAsState()
@@ -64,7 +68,7 @@ fun ChooseAuthOptionScreen(
         mutableStateOf(AppLockOption.None)
     }
 
-    val platformAuthenticationProvider = libraryLocalPlatformAuthenticationProvider.current
+    val platformAuthenticationProvider = platformAuthenticationProvider.current
 
     var dialogBoxType by rememberSaveable {
         mutableStateOf(DialogBoxType.None)
@@ -187,6 +191,7 @@ fun ChooseAuthOptionScreen(
                         whenPasscodeSelected = {
                             platformAuthenticationProvider.updateAuthenticatorStatus()
                             chooseAuthOptionScreenViewmodel.saveAppLockOption(AppLockOption.MifosPasscode)
+                            passcodeManager.initialize()
                             navController.popBackStack()
                             navController.navigate(Route.PasscodeScreen) {
                                 popUpTo(0)

cmp-sample-shared/src/commonMain/kotlin/cmp/sample/shared/di/PasscodeModule.kt

@@ -0,0 +1,43 @@
+/*
+ * Copyright 2026 Mifos Initiative
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * See https://github.com/openMF/mifos-passcode-cmp/blob/development/LICENSE
+ */
+package cmp.sample.shared.di
+
+import cmp.sample.shared.PasscodeStorageAdapterImpl
+import cmp.sample.shared.chooseAuthOption.ChooseAuthOptionRepository
+import cmp.sample.shared.chooseAuthOption.ChooseAuthOptionScreenViewmodel
+import cmp.sample.shared.platformAuthentication.AuthenticationScreenViewModel
+import com.russhwolf.settings.Settings
+import kotlinx.coroutines.MainScope
+import org.koin.core.context.startKoin
+import org.koin.core.module.dsl.singleOf
+import org.koin.core.module.dsl.viewModelOf
+import org.koin.dsl.KoinAppDeclaration
+import org.koin.dsl.bind
+import org.koin.dsl.module
+import org.mifos.authenticator.passcode.PasscodeManager
+import org.mifos.authenticator.passcode.PasscodeStorageAdapter
+
+val passcodeModule = module {
+    singleOf(::PasscodeStorageAdapterImpl).bind<PasscodeStorageAdapter>()
+    single {
+        PasscodeManager(get(), MainScope()).initialize()
+    }
+    single { Settings() }
+    single { ChooseAuthOptionRepository(get()) }
+    viewModelOf(::ChooseAuthOptionScreenViewmodel)
+    viewModelOf(::AuthenticationScreenViewModel)
+}
+
+fun initKoin(config: KoinAppDeclaration? = null) {
+    startKoin {
+        config?.invoke(this)
+        modules(passcodeModule)
+    }
+}