[MW-225] feat(auth): Implement full Sign In & Sign Up flow with validation (#1872)

Author: HekmatullahAmin

.run/mifospay-ios.run.xml

@@ -1,5 +1,5 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="mifospay-ios" type="KmmRunConfiguration" factoryName="iOS Application" CONFIG_VERSION="1" XCODE_PROJECT="$PROJECT_DIR$/mifospay-ios/iosApp.xcodeproj">
+  <configuration default="false" name="mifospay-ios" type="KmmRunConfiguration" factoryName="iOS Application" CONFIG_VERSION="1" XCODE_PROJECT="$PROJECT_DIR$/mifospay-ios/iosApp.xcodeproj" XCODE_CONFIGURATION="Debug" XCODE_SCHEME="iosApp">
     <method v="2">
       <option name="com.jetbrains.kmm.ios.BuildIOSAppTask" enabled="true" />
     </method>

core/common/build.gradle.kts

@@ -10,6 +10,8 @@
 plugins {
     alias(libs.plugins.mifospay.kmp.library)
     alias(libs.plugins.kotlin.parcelize)
+    alias(libs.plugins.compose.compiler)
+    alias(libs.plugins.jetbrainsCompose)
 }
 
 android {
@@ -40,6 +42,8 @@ kotlin {
             api(libs.squareup.okio)
             api(libs.jb.kotlin.stdlib)
             api(libs.kotlinx.datetime)
+            implementation(compose.components.resources)
+            implementation(libs.jb.composeRuntime)
         }
 
         androidMain.dependencies {

core/common/src/commonMain/kotlin/org/mifospay/core/common/dialogManager/DialogManager.kt

@@ -0,0 +1,98 @@
+/*
+ * 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-wallet/blob/master/LICENSE.md
+ */
+package org.mifospay.core.common.dialogManager
+
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import org.jetbrains.compose.resources.StringResource
+
+/**
+ * A singleton for managing dialog state across the app.
+ * It works with [DialogMessage] to determine what kind of dialog should be shown.
+ *
+ * This is typically observed in the UI to display a loading spinner or error message.
+ */
+object DialogManager {
+
+    private val _dialogMessage = MutableStateFlow<DialogMessage>(DialogMessage.None)
+
+    /**
+     * Public read-only dialog message flow.
+     * UI layers should collect this to react to dialog state changes.
+     */
+    val dialogMessage: StateFlow<DialogMessage> = _dialogMessage.asStateFlow()
+
+    /**
+     * Dismisses any currently shown dialog.
+     *
+     * ### Example:
+     * ```
+     * DialogManager.dismissDialog()
+     * ```
+     */
+    fun dismissDialog() {
+        _dialogMessage.value = DialogMessage.None
+    }
+
+    /**
+     * Shows a loading dialog.
+     *
+     * ### Example:
+     * ```
+     * DialogManager.showLoading()
+     * ```
+     */
+    fun showLoading() {
+        _dialogMessage.value = DialogMessage.Loading
+    }
+
+    /**
+     * Shows a plain string message in a dialog.
+     *
+     * @param message The text to display.
+     *
+     * ### Example:
+     * ```
+     * DialogManager.showMessage("Invalid email address.")
+     * ```
+     */
+    fun showMessage(message: String) {
+        _dialogMessage.value = DialogMessage.StringMessage(message)
+    }
+
+    /**
+     * Shows a localized string resource message in a dialog.
+     *
+     * @param message The resource ID to display.
+     *
+     * ### Example:
+     * ```
+     * DialogManager.showMessage(Res.string.feature_auth_error_email_required)
+     * ```
+     */
+    fun showMessage(message: StringResource) {
+        _dialogMessage.value = DialogMessage.ResourceMessage(message)
+    }
+
+    /**
+     * Allows setting any [DialogMessage] manually.
+     *
+     * @param message The [DialogMessage] to show.
+     *
+     * ### Example:
+     * ```
+     * DialogManager.showMessage(DialogMessage.Loading)
+     * ```
+     */
+    fun showMessage(message: DialogMessage) {
+        _dialogMessage.value = message
+    }
+}

core/common/src/commonMain/kotlin/org/mifospay/core/common/dialogManager/DialogMessage.kt

@@ -0,0 +1,68 @@
+/*
+ * 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-wallet/blob/master/LICENSE.md
+ */
+package org.mifospay.core.common.dialogManager
+
+import org.jetbrains.compose.resources.StringResource
+
+/**
+ * Represents the possible types of dialog messages shown in the application.
+ * Used in combination with [DialogManager] to control dialog visibility and content.
+ */
+sealed interface DialogMessage {
+
+    /**
+     * Represents the absence of a dialog message.
+     * Used to indicate that no dialog should be displayed.
+     */
+    data object None : DialogMessage
+
+    /**
+     * Represents a loading dialog.
+     * Used to indicate an ongoing operation to the user.
+     */
+    data object Loading : DialogMessage
+
+    /**
+     * Represents a dialog that shows a plain string message.
+     *
+     * @property message The message to be displayed in the dialog.
+     */
+    class StringMessage(val message: String) : DialogMessage
+
+    /**
+     * Represents a dialog that shows a localized string resource message.
+     *
+     * @property message A [StringResource] ID for localization.
+     */
+    class ResourceMessage(val message: StringResource) : DialogMessage
+
+    companion object {
+
+        /**
+         * Converts a [Throwable] into a [DialogMessage].
+         * Uses [StringMessage] if the exception has a non-blank message,
+         * otherwise falls back to a generic error.
+         *
+         * @return [StringMessage] based on content.
+         *
+         * ### Example:
+         * ```
+         * try {
+         *     doSomethingRisky()
+         * } catch (e: Exception) {
+         *     DialogManager.showMessage(e.toDialogMessage())
+         * }
+         * ```
+         */
+        fun Throwable.toDialogMessage(): DialogMessage {
+            return StringMessage(message ?: "Unknown error occurred.")
+        }
+    }
+}

core/common/src/commonMain/kotlin/org/mifospay/core/common/utils/ListExtensions.kt

@@ -0,0 +1,43 @@
+/*
+ * 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-wallet/blob/master/LICENSE.md
+ */
+package org.mifospay.core.common.utils
+
+/**
+ * Formats a list of strings into a bullet-pointed multiline string.
+ *
+ * Each non-blank line is trimmed and prefixed with a Unicode bullet (•) followed by a space.
+ * Empty or whitespace-only strings are ignored.
+ *
+ * @param lines A list of strings to be formatted.
+ * @return A single string where each line is prefixed with a bullet point and separated by a newline.
+ *
+ * ### Example:
+ * ```
+ * val feedback = listOf(
+ *     "The password must be at least 12 characters long",
+ *     "Include at least one number"
+ * )
+ *
+ * val result = formatAsBulletPoints(feedback)
+ * println(result)
+ * ```
+ *
+ * ### Output:
+ * ```
+ * • The password must be at least 12 characters long
+ * • Include at least one number
+ * ```
+ */
+fun formatAsBulletPoints(lines: List<String>): String {
+    return lines
+        .map { it.trim() }
+        .filter { it.isNotEmpty() }
+        .joinToString(separator = "\n") { "• $it" }
+}

core/data/build.gradle.kts

@@ -11,6 +11,8 @@ plugins {
     alias(libs.plugins.mifospay.kmp.library)
     alias(libs.plugins.kotlin.parcelize)
     id("kotlinx-serialization")
+    alias(libs.plugins.compose.compiler)
+    alias(libs.plugins.jetbrainsCompose)
 }
 
 android {
@@ -32,6 +34,8 @@ kotlin {
             implementation(projects.core.network)
             implementation(projects.core.analytics)
             implementation(libs.kotlinx.serialization.json)
+            implementation(libs.jb.composeRuntime)
+            implementation(compose.components.resources)
         }
 
         androidMain.dependencies {