chore: Handle api v2 calls with api repository for api v2

STCommon/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/common/interfaces/transfers/v2/File.kt

@@ -0,0 +1,31 @@
+/*
+ * Infomaniak SwissTransfer - Multiplatform
+ * Copyright (C) 2026 Infomaniak Network SA
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.infomaniak.multiplatform_swisstransfer.common.interfaces.transfers.v2
+
+interface File {
+    val id: String
+    val path: String
+    val size: Long
+    val mimeType: String? get() = null
+
+    // Local
+    val thumbnailPath: String? get() = null
+    val isFolder: Boolean get() = false
+    // utils
+    val name get() = path.substringAfterLast("/")
+}

STCommon/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/common/interfaces/transfers/v2/Transfer.kt

@@ -0,0 +1,39 @@
+/*
+ * Infomaniak SwissTransfer - Multiplatform
+ * Copyright (C) 2026 Infomaniak Network SA
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.infomaniak.multiplatform_swisstransfer.common.interfaces.transfers.v2
+
+import com.infomaniak.multiplatform_swisstransfer.common.models.TransferDirection
+import com.infomaniak.multiplatform_swisstransfer.common.models.TransferStatus
+
+interface Transfer {
+    val id: String
+    val senderEmail: String
+    val title: String?
+    val message: String?
+    val createdAt: Long
+    val expiresAt: Long
+    val files: List<File> get() = emptyList()
+    val totalSize: Long
+
+    //region Only local
+    val password: String? get() = null
+    val transferDirection: TransferDirection? get() = null
+    val transferStatus: TransferStatus? get() = null
+    val recipientsEmails: Set<String> get() = emptySet()
+    //endregion
+}

STCommon/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/common/utils/ApiEnvironment.kt

@@ -17,9 +17,13 @@
  */
 package com.infomaniak.multiplatform_swisstransfer.common.utils
 
-sealed class ApiEnvironment(val baseUrl: String) {
+sealed class ApiEnvironment(val baseUrl: String, val baseUrlV2: String) {
     // Those urls are duplicated with the ones we have in Android so don't forget to change them also in Android
-    data object Preprod : ApiEnvironment("https://swisstransfer-legacy.preprod.dev.infomaniak.ch")
-    data object Prod : ApiEnvironment("https://www.swisstransfer.com")
-    data class Custom(private val url: String) : ApiEnvironment(url)
+    data object Preprod : ApiEnvironment(
+        baseUrl = "https://swisstransfer-legacy.preprod.dev.infomaniak.ch",
+        baseUrlV2 = "https://swisstransfer.preprod.dev.infomaniak.ch"
+    )
+
+    data object Prod : ApiEnvironment("https://www.swisstransfer.com", "https://swisstransfer.infomaniak.com")
+    data class Custom(private val url: String, private val urlV2: String) : ApiEnvironment(url, urlV2)
 }

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/ApiClientProvider.kt

@@ -22,9 +22,11 @@ import com.infomaniak.multiplatform_swisstransfer.common.interfaces.CrashReportI
 import com.infomaniak.multiplatform_swisstransfer.common.interfaces.CrashReportLevel
 import com.infomaniak.multiplatform_swisstransfer.network.exceptions.ApiException
 import com.infomaniak.multiplatform_swisstransfer.network.exceptions.ApiException.ApiErrorException
+import com.infomaniak.multiplatform_swisstransfer.network.exceptions.ApiException.ApiV2ErrorException
 import com.infomaniak.multiplatform_swisstransfer.network.exceptions.ApiException.UnexpectedApiErrorFormatException
 import com.infomaniak.multiplatform_swisstransfer.network.exceptions.NetworkException
 import com.infomaniak.multiplatform_swisstransfer.network.models.ApiError
+import com.infomaniak.multiplatform_swisstransfer.network.models.ApiResponseForError
 import com.infomaniak.multiplatform_swisstransfer.network.utils.getRequestContextId
 import io.ktor.client.HttpClient
 import io.ktor.client.HttpClientConfig
@@ -40,6 +42,7 @@ import io.ktor.client.statement.bodyAsText
 import io.ktor.client.statement.request
 import io.ktor.http.contentLength
 import io.ktor.serialization.kotlinx.json.json
+import io.ktor.util.network.UnresolvedAddressException
 import io.ktor.utils.io.CancellationException
 import kotlinx.io.IOException
 import kotlinx.serialization.json.Json
@@ -88,7 +91,7 @@ class ApiClientProvider internal constructor(
             }
             install(HttpRequestRetry) {
                 retryOnExceptionIf(maxRetries = MAX_RETRY) { _, cause ->
-                    cause.isNetworkException()
+                    cause.isRetryableNetworkException()
                 }
                 delayMillis { retry ->
                     retry * 500L
@@ -103,17 +106,24 @@ class ApiClientProvider internal constructor(
 
                     if (statusCode >= 300) {
                         val bodyResponse = response.bodyAsText()
-                        val apiError = runCatching {
-                            json.decodeFromString<ApiError>(bodyResponse)
-                        }.getOrElse {
-                            throw UnexpectedApiErrorFormatException(statusCode, bodyResponse, null, requestContextId)
+                        runCatching {
+                            if (bodyResponse.isFromApiV2()) {
+                                val error = json.decodeFromString<ApiResponseForError>(bodyResponse).error
+                                throw ApiV2ErrorException(error.code, error.description, requestContextId)
+                            } else {
+                                val error = json.decodeFromString<ApiError>(bodyResponse)
+                                throw ApiErrorException(error.errorCode, error.message, requestContextId)
+                            }
+                        }.getOrElse { exception ->
+                            if (exception is ApiException) throw exception
+                            throw UnexpectedApiErrorFormatException(statusCode, bodyResponse, exception, requestContextId)
                         }
-                        throw ApiErrorException(apiError.errorCode, apiError.message, requestContextId)
                     }
                 }
                 handleResponseExceptionWithRequest { cause, request ->
                     when (cause) {
-                        is IOException -> throw NetworkException("Network error: ${cause.message}")
+                        is UnresolvedAddressException,
+                        is IOException -> throw NetworkException("Network error: ${cause.message}", cause)
                         is ApiException, is CancellationException -> throw cause
                         else -> {
                             val response = runCatching { request.call.response }.getOrNull()
@@ -151,9 +161,12 @@ class ApiClientProvider internal constructor(
         )
     }
 
-    private fun Throwable.isNetworkException() = this is IOException
+    private fun Throwable.isRetryableNetworkException() = this is IOException
 
     companion object {
         private const val MAX_RETRY = 3
+
+        //TODO[API-V2]: Delete once the v1 api has been removed
+        private fun String.isFromApiV2() = contains("\"result\": \"error\"")
     }
 }

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/exceptions/ApiException.kt

@@ -49,6 +49,22 @@ sealed class ApiException(
         requestContextId: String,
     ) : ApiException(errorMessage, null, requestContextId)
 
+    /**
+     * Thrown when an API(v2) call fails due to an error identified by a specific error code.
+     *
+     * This exception is used to represent errors returned by an API, with an associated error code
+     * and message describing the problem.
+     *
+     * @property code The specific error code returned by the API.
+     * @property errorMessage The detailed error message explaining the cause of the failure.
+     * @param requestContextId The request context id send by the backend to track the call
+     */
+    open class ApiV2ErrorException(
+        val code: String,
+        val description: String,
+        requestContextId: String,
+    ) : ApiException(description, null, requestContextId)
+
     /**
      * Thrown when an API call returns an error in an unexpected format that cannot be parsed.
      *

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/exceptions/FetchTransferException.kt

@@ -89,6 +89,11 @@ sealed class FetchTransferException(
     class WrongPasswordFetchTransferException(requestContextId: String) :
         FetchTransferException(401, "Wrong password for this Transfer", requestContextId)
 
+    class TransferCancelledException(requestContextId: String) :
+        FetchTransferException(409, "Transfer cancelled", requestContextId)
+
+    class DownloadLimitReached(requestContextId: String) : FetchTransferException(429, "Download limit reached", requestContextId)
+
     companion object {
 
         private const val ERROR_VIRUS_CHECK = "wait_virus_check"
@@ -129,6 +134,26 @@ sealed class FetchTransferException(
             errorCode == 404 -> NotFoundFetchTransferException(requestContextId)
             else -> this
         }
+
+        /**
+         * Extension function to convert an instance of [ApiException.ApiV2ErrorException] to a specific [FetchTransferException]
+         * based on its error code.
+         *
+         * Useful to translate some correctly formatted api error exceptions as our custom type of errors we handle everywhere.
+         *
+         * @receiver An instance of [ApiException.ApiV2ErrorException].
+         * @return An instance of [FetchTransferException] or the original [ApiException.ApiV2ErrorException] if we cannot map it
+         * to a [FetchTransferException].
+         */
+        internal fun ApiV2ErrorException.toFetchTransferException() = when (code) {
+            "access_denied" -> PasswordNeededFetchTransferException(requestContextId)
+            "invalid_password" -> WrongPasswordFetchTransferException(requestContextId)
+            "object_not_found" -> NotFoundFetchTransferException(requestContextId)
+            "transfer_cancelled" -> TransferCancelledException(requestContextId)
+            "transfer_expired" -> ExpiredDateFetchTransferException(requestContextId)
+            "download_limit_reached" -> DownloadLimitReached(requestContextId)
+            else -> this
+        }
     }
 }
 

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/exceptions/NetworkException.kt

@@ -22,4 +22,4 @@ package com.infomaniak.multiplatform_swisstransfer.network.exceptions
  *
  * @param message A detailed message describing the network error.
  */
-class NetworkException(message: String) : Exception(message)
+class NetworkException(message: String, cause: Throwable?) : Exception(message, cause)

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/exceptions/TooManyRequestException.kt

@@ -0,0 +1,24 @@
+/*
+ * Infomaniak SwissTransfer - Multiplatform
+ * Copyright (C) 2026 Infomaniak Network SA
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.infomaniak.multiplatform_swisstransfer.network.exceptions
+
+class TooManyRequestException(requestContextId: String) : ApiException(
+    errorMessage = "",
+    cause = null,
+    requestContextId = requestContextId
+)

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/exceptions/UnauthorizedException.kt

@@ -0,0 +1,30 @@
+/*
+ * Infomaniak SwissTransfer - Multiplatform
+ * Copyright (C) 2026 Infomaniak Network SA
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.infomaniak.multiplatform_swisstransfer.network.exceptions
+
+/**
+ * Exception thrown when an API request fails due to missing or invalid Bearer token authorization.
+ *
+ * This exception indicates that the request requires a valid Bearer token for authentication,
+ * but either no token was provided or the token was invalid/expired.
+ */
+class UnauthorizedException(requestContextId: String) : ApiException(
+    errorMessage = "",
+    cause = null,
+    requestContextId = requestContextId
+)

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/exceptions/UploadErrorsException.kt

@@ -0,0 +1,38 @@
+/*
+ * Infomaniak SwissTransfer - Multiplatform
+ * Copyright (C) 2026 Infomaniak Network SA
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.infomaniak.multiplatform_swisstransfer.network.exceptions
+
+sealed class UploadErrorsException(requestContextId: String) : ApiException.ApiV2ErrorException(
+    code = "",
+    description = "",
+    requestContextId = requestContextId
+) {
+
+    class NotFoundException(requestContextId: String) : UploadErrorsException(requestContextId = requestContextId)
+    class TransferCancelled(requestContextId: String) : UploadErrorsException(requestContextId = requestContextId)
+    class TransferExpired(requestContextId: String) : UploadErrorsException(requestContextId = requestContextId)
+    class TransferFailed(requestContextId: String) : UploadErrorsException(requestContextId = requestContextId)
+}
+
+internal fun ApiException.ApiV2ErrorException.toUploadErrorsException() = when (code) {
+    "object_not_found" -> UploadErrorsException.NotFoundException(requestContextId)
+    "transfer_cancelled" -> UploadErrorsException.TransferCancelled(requestContextId)
+    "transfer_expired" -> UploadErrorsException.TransferExpired(requestContextId)
+    "transfer_failed" -> UploadErrorsException.TransferFailed(requestContextId)
+    else -> this
+}

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/models/ApiErrorV2.kt

@@ -0,0 +1,26 @@
+/*
+ * Infomaniak SwissTransfer - Multiplatform
+ * Copyright (C) 2024 Infomaniak Network SA
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.infomaniak.multiplatform_swisstransfer.network.models
+
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class ApiErrorV2(
+    val code: String,
+    val description: String,
+)

STNetwork/src/commonMain/kotlin/com/infomaniak/multiplatform_swisstransfer/network/models/ApiResponseForError.kt

@@ -0,0 +1,26 @@
+/*
+ * Infomaniak SwissTransfer - Multiplatform
+ * Copyright (C) 2026 Infomaniak Network SA
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.infomaniak.multiplatform_swisstransfer.network.models
+
+import kotlinx.serialization.Serializable
+
+@Serializable
+internal data class ApiResponseForError(
+    val responseStatus: ApiResponseStatus = ApiResponseStatus.ERROR,
+    val error: ApiErrorV2
+)