feat: recover password ui and viewModel (#2856)

Author: Nagarjuna0033

feature/auth/src/commonMain/composeResources/values/strings.xml

@@ -146,4 +146,19 @@
 
     <string name="feature_otp_required_error">OTP is required</string>
     <string name="feature_otp_invalid_error">Enter valid OTP</string>
+
+    <!--Recover Password-->
+    <string name="feature_recover_now_title">Recover Now</string>
+    <string name="feature_recover_now_message">Forgot your password, don’t worry!, we got you covered. Reset your password now!</string>
+    <string name="feature_recover_now_phone_number_label">Phone Number</string>
+    <string name="feature_recover_now_email_label">Email</string>
+    <string name="feature_recover_now_verifying">Verifying</string>
+    <string name="feature_recover_now_email_required">Email is Required</string>
+    <string name="feature_recover_now_phone_number_required">Phone number is Required</string>
+    <string name="feature_recover_now_email_format_error">Invalid Email</string>
+    <string name="feature_recover_now_phone_number_error">Invalid Phone Number</string>
+    <string name="feature_recover_now_invalid_phone_number_error">Phone number can not contain letters or symbols</string>
+    <string name="feature_recover_now_remember_your_password">Remember your password?</string>
+    <string name="feature_recover_now_log_in">Log in!</string>
+
 </resources>

feature/auth/src/commonMain/kotlin/org/mifos/mobile/feature/auth/di/AuthModule.kt

@@ -13,6 +13,7 @@ import org.koin.core.module.dsl.viewModelOf
 import org.koin.dsl.module
 import org.mifos.mobile.feature.auth.login.LoginViewModel
 import org.mifos.mobile.feature.auth.otpAuthentication.OtpAuthenticationViewModel
+import org.mifos.mobile.feature.auth.recoverPassword.RecoverPasswordViewModel
 import org.mifos.mobile.feature.auth.registration.RegistrationViewModel
 import org.mifos.mobile.feature.auth.uploadId.UploadIdViewModel
 
@@ -21,4 +22,5 @@ val AuthModule = module {
     viewModelOf(::RegistrationViewModel)
     viewModelOf(::UploadIdViewModel)
     viewModelOf(::OtpAuthenticationViewModel)
+    viewModelOf(::RecoverPasswordViewModel)
 }

feature/auth/src/commonMain/kotlin/org/mifos/mobile/feature/auth/login/LogInNavigation.kt

@@ -29,11 +29,13 @@ fun NavController.navigateToLoginScreen(navOptions: NavOptions? = null) {
 fun NavGraphBuilder.loginDestination(
     navigateToRegisterScreen: () -> Unit,
     navigateToPasscodeScreen: () -> Unit,
+    navigateToForgotPasswordScreen: () -> Unit,
 ) {
     composableWithStayTransitions<LoginRoute> {
         LoginScreen(
             navigateToRegisterScreen = navigateToRegisterScreen,
             navigateToPasscodeScreen = navigateToPasscodeScreen,
+            navigateToForgotPasswordScreen = navigateToForgotPasswordScreen,
         )
     }
 }

feature/auth/src/commonMain/kotlin/org/mifos/mobile/feature/auth/login/LoginScreen.kt

@@ -74,6 +74,7 @@ import org.mifos.mobile.core.ui.utils.EventsEffect
 @Composable
 internal fun LoginScreen(
     navigateToRegisterScreen: () -> Unit,
+    navigateToForgotPasswordScreen: () -> Unit,
     navigateToPasscodeScreen: () -> Unit,
     modifier: Modifier = Modifier,
     viewModel: LoginViewModel = koinViewModel(),
@@ -87,7 +88,9 @@ internal fun LoginScreen(
         when (event) {
             is LoginEvent.NavigateToSignup -> navigateToRegisterScreen.invoke()
 
-            is LoginEvent.NavigateToPasscodeScreen -> navigateToPasscodeScreen.invoke()
+            is LoginEvent.NavigateToPasscode -> navigateToPasscodeScreen.invoke()
+
+            is LoginEvent.NavigateToForgotPassword -> navigateToForgotPasswordScreen.invoke()
 
             is LoginEvent.ShowToast -> {
                 scope.launch {
@@ -288,6 +291,7 @@ fun InputBox(
             modifier = Modifier
                 .align(Alignment.End)
                 .clickable(true) {
+                    onAction(LoginAction.NavigateToForgotPassword)
                 },
             text = stringResource(Res.string.feature_sign_in_forgot_password),
             style = MifosTypography.labelMedium,

feature/auth/src/commonMain/kotlin/org/mifos/mobile/feature/auth/login/LoginViewModel.kt

@@ -75,17 +75,13 @@ class LoginViewModel(
                 updateState { it.copy(isPasswordVisible = !it.isPasswordVisible) }
             }
 
-            is LoginAction.LoginClicked -> {
-                loginUser(state.username, state.password)
-            }
+            is LoginAction.LoginClicked -> loginUser(state.username, state.password)
 
-            is LoginAction.Internal.ReceiveLoginResult -> {
-                handleLoginResult(action)
-            }
+            is LoginAction.Internal.ReceiveLoginResult -> handleLoginResult(action)
 
-            is LoginAction.SignupClicked -> {
-                sendEvent(LoginEvent.NavigateToSignup)
-            }
+            is LoginAction.SignupClicked -> sendEvent(LoginEvent.NavigateToSignup)
+
+            is LoginAction.NavigateToForgotPassword -> sendEvent(LoginEvent.NavigateToForgotPassword)
 
             is LoginAction.ErrorDialogDismiss -> {
                 updateState { it.copy(dialogState = null) }
@@ -126,7 +122,7 @@ class LoginViewModel(
                 viewModelScope.launch {
                     userPreferencesRepositoryImpl.updateUser(userData)
                 }
-                sendEvent(LoginEvent.NavigateToPasscodeScreen)
+                sendEvent(LoginEvent.NavigateToPasscode)
             }
         }
     }
@@ -177,7 +173,8 @@ data class LoginState(
 
 sealed interface LoginEvent {
     data object NavigateToSignup : LoginEvent
-    data object NavigateToPasscodeScreen : LoginEvent
+    data object NavigateToPasscode : LoginEvent
+    data object NavigateToForgotPassword : LoginEvent
     data class ShowToast(val message: String) : LoginEvent
 }
 
@@ -188,6 +185,7 @@ sealed interface LoginAction {
     data object ErrorDialogDismiss : LoginAction
     data object LoginClicked : LoginAction
     data object SignupClicked : LoginAction
+    data object NavigateToForgotPassword : LoginAction
 
     sealed class Internal : LoginAction {
         data class ReceiveLoginResult(

feature/auth/src/commonMain/kotlin/org/mifos/mobile/feature/auth/navigation/AuthenticationNavGraph.kt

@@ -23,6 +23,8 @@ import org.mifos.mobile.feature.auth.login.loginDestination
 import org.mifos.mobile.feature.auth.login.navigateToLoginScreen
 import org.mifos.mobile.feature.auth.otpAuthentication.navigateToOtpAuthScreen
 import org.mifos.mobile.feature.auth.otpAuthentication.otpAuthenticationDestination
+import org.mifos.mobile.feature.auth.recoverPassword.navigateToRecoverPasswordScreen
+import org.mifos.mobile.feature.auth.recoverPassword.recoverPasswordDestination
 import org.mifos.mobile.feature.auth.registration.navigateToRegisterScreen
 import org.mifos.mobile.feature.auth.registration.registrationDestination
 import org.mifos.mobile.feature.auth.status.navigateToStatusScreen
@@ -49,6 +51,7 @@ fun NavGraphBuilder.authenticationNavGraph(
 //            navigateToRegisterScreen = navController::navigateToRegisterScreen,
             navigateToRegisterScreen = navController::navigateToOtpAuthScreen,
             navigateToPasscodeScreen = navigateToPasscodeScreen,
+            navigateToForgotPasswordScreen = navController::navigateToRecoverPasswordScreen,
         )
 
         registrationDestination(
@@ -70,5 +73,10 @@ fun NavGraphBuilder.authenticationNavGraph(
                 navController.navigate(it)
             },
         )
+
+        recoverPasswordDestination(
+            navigateToLoginScreen = navController::navigateToLoginScreen,
+            navigateToOtpAuthenticationScreen = navController::navigateToOtpAuthScreen,
+        )
     }
 }

feature/auth/src/commonMain/kotlin/org/mifos/mobile/feature/auth/recoverPassword/RecoverPasswordNavigation.kt

@@ -0,0 +1,37 @@
+/*
+ * Copyright 2025 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/mobile-mobile/blob/master/LICENSE.md
+ */
+@file:Suppress("MatchingDeclarationName")
+
+package org.mifos.mobile.feature.auth.recoverPassword
+
+import androidx.navigation.NavController
+import androidx.navigation.NavGraphBuilder
+import androidx.navigation.NavOptions
+import kotlinx.serialization.Serializable
+import org.mifos.mobile.core.ui.composableWithSlideTransitions
+
+@Serializable
+data object RecoverPasswordRoute
+
+fun NavController.navigateToRecoverPasswordScreen(navOptions: NavOptions? = null) {
+    this.navigate(RecoverPasswordRoute, navOptions)
+}
+
+fun NavGraphBuilder.recoverPasswordDestination(
+    navigateToOtpAuthenticationScreen: () -> Unit,
+    navigateToLoginScreen: () -> Unit,
+) {
+    composableWithSlideTransitions<RecoverPasswordRoute> {
+        RecoverPasswordScreen(
+            navigateToOtpAuthenticationScreen = navigateToOtpAuthenticationScreen,
+            navigateToLoginScreen = navigateToLoginScreen,
+        )
+    }
+}