import Foundation import ComposableArchitecture // MARK: - 腾讯云 COS 管理器 /// 腾讯云 COS 管理器 /// /// 负责管理腾讯云 COS 相关的操作,包括: /// - Token 获取和缓存 /// - 文件上传、下载、删除 /// - 凭证管理和过期处理 @MainActor class COSManager: ObservableObject { static let shared = COSManager() private init() {} // MARK: - Token 管理 /// 当前缓存的 Token 信息 private var cachedToken: TcTokenData? private var tokenExpirationDate: Date? /// 获取腾讯云 COS Token /// - Parameter apiService: API 服务实例 /// - Returns: Token 数据,如果获取失败返回 nil func getToken(apiService: any APIServiceProtocol & Sendable) async -> TcTokenData? { // 检查缓存是否有效 if let cached = cachedToken, let expiration = tokenExpirationDate, Date() < expiration { debugInfoSync("🔐 使用缓存的 COS Token") return cached } // 清除过期缓存 clearCachedToken() // 请求新的 Token debugInfoSync("🔐 开始请求腾讯云 COS Token...") do { let request = TcTokenRequest() let response: TcTokenResponse = try await apiService.request(request) guard response.code == 200, let tokenData = response.data else { debugInfoSync("❌ COS Token 请求失败: \(response.message)") return nil } // 缓存 Token 和过期时间 cachedToken = tokenData tokenExpirationDate = tokenData.expirationDate debugInfoSync("✅ COS Token 获取成功") debugInfoSync(" - 存储桶: \(tokenData.bucket)") debugInfoSync(" - 地域: \(tokenData.region)") debugInfoSync(" - 过期时间: \(tokenData.expirationDate)") debugInfoSync(" - 剩余时间: \(tokenData.remainingTime)秒") return tokenData } catch { debugInfoSync("❌ COS Token 请求异常: \(error.localizedDescription)") return nil } } /// 缓存 Token 信息 /// - Parameter tokenData: Token 数据 private func cacheToken(_ tokenData: TcTokenData) async { cachedToken = tokenData // 解析过期时间(假设 expiration 是 ISO 8601 格式) if let expirationDate = ISO8601DateFormatter().date(from: String(tokenData.expireTime)) { // 提前 5 分钟过期,确保安全 tokenExpirationDate = expirationDate.addingTimeInterval(-300) } else { // 如果解析失败,设置默认过期时间(1小时) tokenExpirationDate = Date().addingTimeInterval(3600) } debugInfoSync("💾 COS Token 已缓存,过期时间: \(tokenExpirationDate?.description ?? "未知")") } /// 清除缓存的 Token private func clearCachedToken() { cachedToken = nil tokenExpirationDate = nil debugInfoSync("🗑️ 清除缓存的 COS Token") } /// 强制刷新 Token func refreshToken(apiService: any APIServiceProtocol & Sendable) async -> TcTokenData? { clearCachedToken() return await getToken(apiService: apiService) } // MARK: - 只读属性 /// 外部安全访问 Token var token: TcTokenData? { cachedToken } // MARK: - 调试信息 /// 获取当前 Token 状态信息 func getTokenStatus() -> String { if let cached = cachedToken, let expiration = tokenExpirationDate { let isExpired = Date() >= expiration return "Token 状态: \(isExpired ? "已过期" : "有效"), 过期时间: \(expiration)" } else { return "Token 状态: 未缓存" } } } // MARK: - 调试扩展 extension COSManager { /// 测试 Token 获取功能(仅用于调试) func testTokenRetrieval(apiService: any APIServiceProtocol & Sendable) async { #if DEBUG debugInfoSync("\n🧪 开始测试腾讯云 COS Token 获取功能") let token = await getToken(apiService: apiService) if let tokenData = token { debugInfoSync("✅ Token 获取成功") debugInfoSync(" bucket: \(tokenData.bucket)") debugInfoSync(" Expiration: \(tokenData.expireTime)") debugInfoSync(" Token: \(tokenData.sessionToken.prefix(20))...") debugInfoSync(" SecretId: \(tokenData.secretId.prefix(20))...") } else { debugInfoSync("❌ Token 获取失败") } debugInfoSync("📊 Token 状态: \(getTokenStatus())") debugInfoSync("✅ 腾讯云 COS Token 测试完成\n") #endif } }