suixinkan_uikit/suixinkan/Features/Live/API/LiveAPI.swift

//
//  LiveAPI.swift
//  suixinkan
//

import Foundation

/// 直播服务协议，抽象 manual-live 与 view-album 接口。
@MainActor
protocol LiveServing {
    /// 拉取直播列表。
    func liveList(scenicId: String, page: Int, pageSize: Int) async throws -> LiveListResponse

    /// 拉取直播详情。
    func liveDetail(liveId: Int) async throws -> LiveItem

    /// 新建直播。
    func createLive(scenicId: String, title: String, coverImg: String) async throws

    /// 开始直播。
    func startLive(liveId: Int) async throws

    /// 暂停直播。
    func stopLive(liveId: Int) async throws

    /// 结束直播。
    func finishLive(liveId: Int) async throws

    /// 设置直播推流模式。
    func setPushMode(liveId: Int, mode: Int) async throws

    /// 拉取直播相册列表。
    func albumList(scenicId: String, startTime: String?, endTime: String?, page: Int, pageSize: Int) async throws -> LiveAlbumFolderListResponse

    /// 创建直播相册文件夹。
    func createAlbumFolder(scenicId: String, name: String, items: [LiveAlbumFile]) async throws

    /// 删除直播相册文件夹。
    func deleteAlbumFolder(folderId: Int) async throws

    /// 拉取直播相册详情。
    func albumFolderDetail(folderId: Int) async throws -> LiveAlbumFolder

    /// 删除直播相册素材。
    func deleteAlbumFile(folderId: Int, fileId: Int) async throws
}

/// 直播 API，封装 Android `NetworkApi` 中 alive/manual-live 与 view-album 接口。
@MainActor
final class LiveAPI: LiveServing {
    private let client: APIClient

    /// 初始化直播 API。
    init(client: APIClient) {
        self.client = client
    }

    /// 拉取直播列表。
    func liveList(scenicId: String, page: Int = 1, pageSize: Int = 10) async throws -> LiveListResponse {
        try await client.send(
            APIRequest(
                method: .get,
                path: "/api/app/manual-live/list",
                queryItems: [
                    URLQueryItem(name: "scenic_id", value: scenicId),
                    URLQueryItem(name: "page", value: String(max(page, 1))),
                    URLQueryItem(name: "page_size", value: String(max(pageSize, 1))),
                ]
            )
        )
    }

    /// 拉取直播详情。
    func liveDetail(liveId: Int) async throws -> LiveItem {
        try await client.send(
            APIRequest(
                method: .get,
                path: "/api/app/manual-live/detail",
                queryItems: [URLQueryItem(name: "live_id", value: String(liveId))]
            )
        )
    }

    /// 新建直播。
    func createLive(scenicId: String, title: String, coverImg: String) async throws {
        let _: EmptyPayload = try await client.send(
            APIRequest(
                method: .post,
                path: "/api/app/manual-live/create",
                body: LiveCreateRequest(scenicId: scenicId, title: title, coverImg: coverImg)
            )
        )
    }

    /// 开始直播。
    func startLive(liveId: Int) async throws {
        try await controlLive(path: "/api/app/manual-live/start", liveId: liveId)
    }

    /// 暂停直播。
    func stopLive(liveId: Int) async throws {
        try await controlLive(path: "/api/app/manual-live/stop", liveId: liveId)
    }

    /// 结束直播。
    func finishLive(liveId: Int) async throws {
        try await controlLive(path: "/api/app/manual-live/finish", liveId: liveId)
    }

    /// 设置直播推流模式。
    func setPushMode(liveId: Int, mode: Int) async throws {
        let _: EmptyPayload = try await client.send(
            APIRequest(
                method: .post,
                path: "/api/app/manual-live/set-push-mode",
                body: LivePushModeRequest(liveId: liveId, manualPushMode: mode)
            )
        )
    }

    /// 拉取直播相册列表。
    func albumList(
        scenicId: String,
        startTime: String? = nil,
        endTime: String? = nil,
        page: Int = 1,
        pageSize: Int = 10
    ) async throws -> LiveAlbumFolderListResponse {
        var items = [
            URLQueryItem(name: "scenic_id", value: scenicId),
            URLQueryItem(name: "page", value: String(max(page, 1))),
            URLQueryItem(name: "page_size", value: String(max(pageSize, 1))),
        ]
        if let startTime, !startTime.isEmpty {
            items.append(URLQueryItem(name: "start_time", value: startTime))
        }
        if let endTime, !endTime.isEmpty {
            items.append(URLQueryItem(name: "end_time", value: endTime))
        }
        return try await client.send(
            APIRequest(method: .get, path: "/api/app/view-album/folders", queryItems: items)
        )
    }

    /// 创建直播相册文件夹。
    func createAlbumFolder(scenicId: String, name: String, items: [LiveAlbumFile]) async throws {
        let _: EmptyPayload = try await client.send(
            APIRequest(
                method: .post,
                path: "/api/app/view-album/create-folder",
                body: LiveAlbumFolderCreateRequest(scenicId: scenicId, name: name, items: items)
            )
        )
    }

    /// 删除直播相册文件夹。
    func deleteAlbumFolder(folderId: Int) async throws {
        let _: EmptyPayload = try await client.send(
            APIRequest(
                method: .post,
                path: "/api/app/view-album/delete-folder",
                body: LiveAlbumFolderDeleteRequest(folderId: folderId)
            )
        )
    }

    /// 拉取直播相册详情。
    func albumFolderDetail(folderId: Int) async throws -> LiveAlbumFolder {
        try await client.send(
            APIRequest(
                method: .get,
                path: "/api/app/view-album/folder-detail",
                queryItems: [URLQueryItem(name: "folder_id", value: String(folderId))]
            )
        )
    }

    /// 删除直播相册素材。
    func deleteAlbumFile(folderId: Int, fileId: Int) async throws {
        let _: EmptyPayload = try await client.send(
            APIRequest(
                method: .post,
                path: "/api/app/view-album/delete-files",
                body: LiveAlbumFileDeleteRequest(folderId: folderId, fileIds: [fileId])
            )
        )
    }

    private func controlLive(path: String, liveId: Int) async throws {
        let _: EmptyPayload = try await client.send(
            APIRequest(method: .post, path: path, body: LiveControlRequest(liveId: liveId))
        )
    }
}