First Commit

features/preferences/api/build.gradle.kts

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2025 Element Creations Ltd.
+ * Copyright 2023-2025 New Vector Ltd.
+ *
+ * SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+ * Please see LICENSE files in the repository root for full details.
+ */
+plugins {
+    id("io.element.android-library")
+    id("kotlin-parcelize")
+}
+
+android {
+    namespace = "io.element.android.features.preferences.api"
+}
+
+dependencies {
+    implementation(projects.libraries.architecture)
+    api(projects.libraries.matrix.api)
+}

features/preferences/api/src/main/kotlin/io/element/android/features/preferences/api/CacheService.kt

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2025 Element Creations Ltd.
+ * Copyright 2023-2025 New Vector Ltd.
+ *
+ * SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+ * Please see LICENSE files in the repository root for full details.
+ */
+
+package io.element.android.features.preferences.api
+
+import io.element.android.libraries.matrix.api.core.SessionId
+import kotlinx.coroutines.flow.Flow
+
+interface CacheService {
+    /**
+     * A flow of [SessionId], can let the app to know when the
+     * cache has been cleared for a given session, for instance to restart the app.
+     */
+    val clearedCacheEventFlow: Flow<SessionId>
+}

features/preferences/api/src/main/kotlin/io/element/android/features/preferences/api/PreferencesEntryPoint.kt

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2025 Element Creations Ltd.
+ * Copyright 2023-2025 New Vector Ltd.
+ *
+ * SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+ * Please see LICENSE files in the repository root for full details.
+ */
+
+package io.element.android.features.preferences.api
+
+import android.os.Parcelable
+import com.bumble.appyx.core.modality.BuildContext
+import com.bumble.appyx.core.node.Node
+import com.bumble.appyx.core.plugin.Plugin
+import io.element.android.libraries.architecture.FeatureEntryPoint
+import io.element.android.libraries.architecture.NodeInputs
+import io.element.android.libraries.matrix.api.core.EventId
+import io.element.android.libraries.matrix.api.core.RoomId
+import kotlinx.parcelize.Parcelize
+
+interface PreferencesEntryPoint : FeatureEntryPoint {
+    sealed interface InitialTarget : Parcelable {
+        @Parcelize
+        data object Root : InitialTarget
+
+        @Parcelize
+        data object NotificationSettings : InitialTarget
+
+        @Parcelize
+        data object NotificationTroubleshoot : InitialTarget
+    }
+
+    data class Params(val initialElement: InitialTarget) : NodeInputs
+
+    fun createNode(
+        parentNode: Node,
+        buildContext: BuildContext,
+        params: Params,
+        callback: Callback,
+    ): Node
+
+    interface Callback : Plugin {
+        fun navigateToAddAccount()
+        fun navigateToBugReport()
+        fun navigateToSecureBackup()
+        fun navigateToRoomNotificationSettings(roomId: RoomId)
+        fun navigateToEvent(roomId: RoomId, eventId: EventId)
+    }
+}