feat: 添加云盘与消息中心功能

suixinkan/Features/MessageCenter/API/MessageCenterAPI.swift

@@ -0,0 +1,67 @@
+//
+//  MessageCenterAPI.swift
+//  suixinkan
+//
+
+import Foundation
+
+/// 消息中心服务协议，抽象列表、已读和删除接口。
+@MainActor
+protocol MessageCenterServing {
+    /// 拉取消息列表。
+    func list(lastId: Int, limit: Int, unread: Int) async throws -> MessageListResponse
+
+    /// 标记消息已读。
+    func markAsRead(messageId: Int) async throws
+
+    /// 删除消息。
+    func delete(messageId: Int) async throws
+}
+
+/// 消息中心 API，对齐 Android `NetworkApi` 的 msg 区域。
+@MainActor
+final class MessageCenterAPI: MessageCenterServing {
+    private let client: APIClient
+
+    /// 初始化消息中心 API。
+    init(client: APIClient) {
+        self.client = client
+    }
+
+    /// GET /api/app/msg/list
+    func list(lastId: Int = 0, limit: Int = 20, unread: Int = 0) async throws -> MessageListResponse {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/msg/list",
+                queryItems: [
+                    URLQueryItem(name: "last_id", value: String(max(lastId, 0))),
+                    URLQueryItem(name: "limit", value: String(max(limit, 1))),
+                    URLQueryItem(name: "unread", value: String(max(unread, 0))),
+                ]
+            )
+        )
+    }
+
+    /// POST /api/app/msg/read
+    func markAsRead(messageId: Int) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/msg/read",
+                queryItems: [URLQueryItem(name: "id", value: String(messageId))]
+            )
+        )
+    }
+
+    /// POST /api/app/msg/delete
+    func delete(messageId: Int) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/msg/delete",
+                body: MessageDeleteRequest(id: messageId)
+            )
+        )
+    }
+}