Asynchronous method wrappers.

Various method wrappers which enable calls in fashion of modern concurrency.

Signed-off-by: Iva Horn <iva.horn@icloud.com>

Author: i2h3

Sources/NextcloudKit/NKError.swift

@@ -32,7 +32,7 @@ extension OCSPath {
     static var ocsXMLMsg: Self { ["d:error", "s:message"] }
 }
 
-public struct NKError: Sendable, Equatable {
+public struct NKError: Error, Equatable {
     static let internalError = -9999
     // Chunk error
     public static let chunkNoEnoughMemory = -9998

Sources/NextcloudKit/NextcloudKit+API.swift

@@ -151,6 +151,17 @@ public extension NextcloudKit {
         case failure(NKError)
     }
 
+    ///
+    /// Asynchronous method wrapper for ``getServerStatus(serverUrl:options:taskHandler:completion:)``.
+    ///
+    func getServerStatus(serverUrl: String, options: NKRequestOptions = NKRequestOptions(), taskHandler: @escaping (_ task: URLSessionTask) -> Void = { _ in }) async -> ServerInfoResult {
+        await withCheckedContinuation { continuation in
+            getServerStatus(serverUrl: serverUrl, options: options, taskHandler: taskHandler) { _, serverInfoResult in
+                continuation.resume(returning: serverInfoResult)
+            }
+        }
+    }
+
     func getServerStatus(serverUrl: String,
                          options: NKRequestOptions = NKRequestOptions(),
                          taskHandler: @escaping (_ task: URLSessionTask) -> Void = { _ in },

Sources/NextcloudKit/NextcloudKit+Login.swift

@@ -99,6 +99,39 @@ public extension NextcloudKit {
 
     // MARK: - Login Flow V2
 
+    ///
+    /// Requests the initiation of a login process and retrieves required information.
+    ///
+    /// - Returns: A tuple consisting of the `endpoint` to poll for the login status with the `token`. Additionally, the `login` to open for the user to log in.
+    ///
+    func getLoginFlowV2(serverUrl: String, options: NKRequestOptions = NKRequestOptions(), taskHandler: @escaping (_ task: URLSessionTask) -> Void = { _ in }) async throws -> (endpoint: URL, login: URL, token: String) {
+        try await withCheckedThrowingContinuation { continuation in
+            getLoginFlowV2(serverUrl: serverUrl, options: options, taskHandler: taskHandler) { token, endpointString, loginString, _, error in
+                if error != .success {
+                    continuation.resume(throwing: error)
+                    return
+                }
+
+                guard let endpointString, let endpointURL = URL(string: endpointString) else {
+                    continuation.resume(throwing: NKError.urlError)
+                    return
+                }
+
+                guard let loginString, let loginURL = URL(string: loginString) else {
+                    continuation.resume(throwing: NKError.urlError)
+                    return
+                }
+
+                guard let token else {
+                    continuation.resume(throwing: NKError.invalidData)
+                    return
+                }
+
+                continuation.resume(returning: (endpointURL, loginURL, token))
+            }
+        }
+    }
+
     func getLoginFlowV2(serverUrl: String,
                         options: NKRequestOptions = NKRequestOptions(),
                         taskHandler: @escaping (_ task: URLSessionTask) -> Void = { _ in },