First Commit

libraries/voiceplayer/api/build.gradle.kts

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2025 Element Creations Ltd.
+ * Copyright 2024, 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-compose-library")
+}
+
+android {
+    namespace = "io.element.android.libraries.voiceplayer.api"
+}
+
+dependencies {
+    implementation(libs.androidx.annotationjvm)
+    implementation(libs.coroutines.core)
+    implementation(projects.libraries.matrix.api)
+}

libraries/voiceplayer/api/src/main/kotlin/io/element/android/libraries/voiceplayer/api/VoiceMessageEvents.kt

@@ -0,0 +1,14 @@
+/*
+ * 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.libraries.voiceplayer.api
+
+sealed interface VoiceMessageEvents {
+    data object PlayPause : VoiceMessageEvents
+    data class Seek(val percentage: Float) : VoiceMessageEvents
+}

libraries/voiceplayer/api/src/main/kotlin/io/element/android/libraries/voiceplayer/api/VoiceMessageException.kt

@@ -0,0 +1,26 @@
+/*
+ * 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.libraries.voiceplayer.api
+
+sealed class VoiceMessageException : Exception() {
+    data class FileException(
+        override val message: String?,
+        override val cause: Throwable? = null
+    ) : VoiceMessageException()
+
+    data class PermissionMissing(
+        override val message: String?,
+        override val cause: Throwable?
+    ) : VoiceMessageException()
+
+    data class PlayMessageError(
+        override val message: String?,
+        override val cause: Throwable?
+    ) : VoiceMessageException()
+}

libraries/voiceplayer/api/src/main/kotlin/io/element/android/libraries/voiceplayer/api/VoiceMessagePresenterFactory.kt

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2025 Element Creations Ltd.
+ * Copyright 2024, 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.libraries.voiceplayer.api
+
+import io.element.android.libraries.architecture.Presenter
+import io.element.android.libraries.matrix.api.core.EventId
+import io.element.android.libraries.matrix.api.media.MediaSource
+import kotlin.time.Duration
+
+interface VoiceMessagePresenterFactory {
+    fun createVoiceMessagePresenter(
+        eventId: EventId?,
+        mediaSource: MediaSource,
+        mimeType: String?,
+        filename: String?,
+        duration: Duration,
+    ): Presenter<VoiceMessageState>
+}

libraries/voiceplayer/api/src/main/kotlin/io/element/android/libraries/voiceplayer/api/VoiceMessageState.kt

@@ -0,0 +1,25 @@
+/*
+ * 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.libraries.voiceplayer.api
+
+data class VoiceMessageState(
+    val button: Button,
+    val progress: Float,
+    val time: String,
+    val showCursor: Boolean,
+    val eventSink: (event: VoiceMessageEvents) -> Unit,
+) {
+    enum class Button {
+        Play,
+        Pause,
+        Downloading,
+        Retry,
+        Disabled,
+    }
+}

libraries/voiceplayer/api/src/main/kotlin/io/element/android/libraries/voiceplayer/api/VoiceMessageStateProvider.kt

@@ -0,0 +1,57 @@
+/*
+ * 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.libraries.voiceplayer.api
+
+import androidx.compose.ui.tooling.preview.PreviewParameterProvider
+
+open class VoiceMessageStateProvider : PreviewParameterProvider<VoiceMessageState> {
+    override val values: Sequence<VoiceMessageState>
+        get() = sequenceOf(
+            aVoiceMessageState(
+                VoiceMessageState.Button.Downloading,
+                progress = 0f,
+                time = "0:00",
+            ),
+            aVoiceMessageState(
+                VoiceMessageState.Button.Retry,
+                progress = 0.5f,
+                time = "0:01",
+            ),
+            aVoiceMessageState(
+                VoiceMessageState.Button.Play,
+                progress = 1f,
+                time = "1:00",
+                showCursor = true,
+            ),
+            aVoiceMessageState(
+                VoiceMessageState.Button.Pause,
+                progress = 0.2f,
+                time = "10:00",
+                showCursor = true,
+            ),
+            aVoiceMessageState(
+                VoiceMessageState.Button.Disabled,
+                progress = 0.2f,
+                time = "30:00",
+            ),
+        )
+}
+
+fun aVoiceMessageState(
+    button: VoiceMessageState.Button = VoiceMessageState.Button.Play,
+    progress: Float = 0f,
+    time: String = "1:00",
+    showCursor: Boolean = false,
+) = VoiceMessageState(
+    button = button,
+    progress = progress,
+    time = time,
+    showCursor = showCursor,
+    eventSink = {},
+)