e-party-iOS/yana/Utils/COSManager.swift

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
    }
}