OpenStats/Packages/OpenStatsKit/Sources/Cleaner/CleanModels.swift

import Foundation

public enum CleanCategory: String, Sendable, CaseIterable, Identifiable {
    case system, browser, developer, downloads, trash

    public var id: String { rawValue }

    public var title: String {
        switch self {
        case .system: "系统"
        case .browser: "浏览器"
        case .developer: "开发者"
        case .downloads: "下载"
        case .trash: "废纸篓"
        }
    }
}

public enum DeletionPolicy: Sendable {
    /// 可再生的缓存与日志：直接删除，空间立即释放
    case delete
    /// 用户文件（安装包、未完成下载）：移到废纸篓，可恢复
    case trash
}

public enum SkipReason: Sendable, Equatable, Hashable {
    case appRunning(String)
    case needsFullDiskAccess
    case recentlyModified
    case protected

    public var title: String {
        switch self {
        case .appRunning(let name): "\(name) 正在运行"
        case .needsFullDiskAccess: "需要完全磁盘访问权限"
        case .recentlyModified: "刚刚被使用"
        case .protected: "受保护"
        }
    }
}

/// 扫描所需的外部环境，便于在测试中替换
public struct CleanEnvironment: Sendable {
    public var home: String
    public var runningBundleIdentifiers: @Sendable () -> Set<String>
    public var now: @Sendable () -> Date

    public init(home: String = NSHomeDirectory(),
                runningBundleIdentifiers: @escaping @Sendable () -> Set<String>,
                now: @escaping @Sendable () -> Date = Date.init) {
        self.home = home
        self.runningBundleIdentifiers = runningBundleIdentifiers
        self.now = now
    }
}

public struct CleanRule: Sendable, Identifiable {
    public let id: String
    public let category: CleanCategory
    public let title: String
    public let detail: String
    public let symbol: String
    public let selectedByDefault: Bool
    public let policy: DeletionPolicy
    /// 这些应用运行时整条规则跳过（例如浏览器）
    public let blockingApps: [(bundleID: String, name: String)]
    /// 条目名为反向域名（如 com.foo.bar）时，对应应用运行中则跳过该条目
    public let checksOwnerApp: Bool
    /// 最近修改过的条目视为正在使用
    public let minimumAge: TimeInterval
    /// 列出候选条目（顶层文件或目录）
    let locate: @Sendable (CleanEnvironment) throws -> [URL]

    init(id: String, category: CleanCategory, title: String, detail: String, symbol: String,
         selectedByDefault: Bool = true, policy: DeletionPolicy = .delete,
         blockingApps: [(bundleID: String, name: String)] = [], checksOwnerApp: Bool = false,
         minimumAge: TimeInterval = 120,
         locate: @escaping @Sendable (CleanEnvironment) throws -> [URL]) {
        self.id = id
        self.category = category
        self.title = title
        self.detail = detail
        self.symbol = symbol
        self.selectedByDefault = selectedByDefault
        self.policy = policy
        self.blockingApps = blockingApps
        self.checksOwnerApp = checksOwnerApp
        self.minimumAge = minimumAge
        self.locate = locate
    }
}

public struct CleanItem: Sendable, Identifiable, Hashable {
    public var id: String { url.path }
    public let url: URL
    public let size: UInt64
}

public struct RuleScan: Sendable, Identifiable {
    public var id: String { rule.id }
    public let rule: CleanRule
    /// 按大小降序
    public let items: [CleanItem]
    public let skippedCount: Int
    /// 整条规则被阻止的原因（浏览器运行中、缺少权限）
    public let blocked: SkipReason?

    public var totalSize: UInt64 { items.reduce(0) { $0 + $1.size } }
    public var isCleanable: Bool { blocked == nil && !items.isEmpty }
}

public struct CleanReport: Sendable {
    public var freedBytes: UInt64 = 0
    public var removedCount = 0
    public var skippedCount = 0
    public var failures: [String] = []
    /// 移到废纸篓的大小（不会立即释放）
    public var trashedBytes: UInt64 = 0
}