youle_app_ios_v2/ylgamehall/Source/Network/VersionResolver.swift

//
//  VersionResolver.swift
//  ylgamehall
//
//  把远端 RemoteConfig 化简为 5 个目标字段（appVersion/appDownload/gameVersion/
//  gameZip/showmessage）的纯函数实现，照搬 msext chulishengji 双子树合并算法。
//  详见 docs/Development-Plan.md ADR-008-D / Design §6.3.2 / msext NewRootVC.m:1372-1538。
//

import Foundation

// MARK: - 决策输出

/// chulishengji 双子树合并后的 5 个目标字段。
public struct ResolvedVersion: Sendable, Equatable {
    /// 远端期望的原生 IPA 版本（与 BundleConfig.appVersion 比较）。0 表示远端未指定。
    public let appVersion: Int
    /// IPA 升级跳转的 Safari URL。nil 表示远端未指定。
    public let appDownload: String?
    /// 远端期望的 H5 zip 版本（与本地 version.xml /game/version@value 比较）。
    public let gameVersion: Int
    /// H5 zip 下载 URL。nil 表示远端未指定。
    public let gameZip: String?
    /// 运营公告。非空时阻塞后续升级判断（msext 杀手锏 #2）。
    public let showmessage: String?
}

// MARK: - 内部：单条子树的提取结果

/// 单条子树（agent 子树 或 game 子树）4 层逐层覆盖后的 5 字段。
private struct SubtreeExtract {
    var appVersion: Int = 0
    var appDownload: String?
    var gameVersion: Int = 0
    /// 注意字段名：agent 子树原项目用 `game_download`，game 子树用 `game_zip`，
    /// 两者本质同一字段，新外壳两 key 都查（择一非空）。
    var gameZip: String?
    var showmessage: String?
}

// MARK: - VersionResolver

public enum VersionResolver {

    /// chulishengji 双子树合并（msext `NewRootVC.m:1372-1538`）。
    ///
    /// 1. 从 agent 子树提取（`agent → channel → market → game`，game 嵌在 market 命中后才遍历）
    /// 2. 从 game 子树提取（`game → game-self → channel → market`）
    /// 3. **IPA 合并**：默认 agent 赢；`gameConfig.appVersion > agentConfig.appVersion` 时
    ///    game 赢（NewRootVC.m:1416）
    /// 4. **zip 合并**：默认 game 赢；`agentConfig.gameVersion > gameConfig.gameVersion` 时
    ///    agent 赢（NewRootVC.m:1456）
    /// 5. **showmessage**：两条子树多层多次覆盖，最后写赢；若都为 nil，回退到顶层 `config.showmessage`
    ///
    /// - Parameters:
    ///   - config: 远端 RemoteConfig（Codable 解析后）
    ///   - agentId: 当前 BundleConfig.agent
    ///   - channelId: 当前 BundleConfig.channel
    ///   - marketId: 当前 BundleConfig.market
    ///   - gameId: 当前 BundleConfig.gameId
    /// - Returns: 5 字段决策结果。任一字段缺失返回 0 / nil。
    public static func resolve(
        config: RemoteConfig,
        agentId: String,
        channelId: String,
        marketId: String,
        gameId: String
    ) -> ResolvedVersion {
        // 找当前 agent
        guard let agent = config.agentlist?.first(where: { $0.agentid == agentId }) else {
            // agent 找不到匹配（极端情况）：返回 0 / nil，让 WebContainer 走"无升级"路径
            return ResolvedVersion(
                appVersion: 0, appDownload: nil,
                gameVersion: 0, gameZip: nil,
                showmessage: config.showmessage
            )
        }

        // 找当前 agent 下的 game
        let game = agent.gamelist?.first(where: { $0.gameid == gameId })

        let agentExtract = extractAgentSubtree(
            agent: agent,
            channelId: channelId,
            marketId: marketId,
            gameId: gameId
        )

        let gameExtract: SubtreeExtract = game.map { g in
            extractGameSubtree(game: g, channelId: channelId, marketId: marketId)
        } ?? SubtreeExtract()

        let (appVer, appDL) = mergeIPA(agent: agentExtract, game: gameExtract)
        let (gameVer, gameZip) = mergeZip(agent: agentExtract, game: gameExtract)

        // showmessage：game 子树 > agent 子树 > 顶层（任意非空就用，最后写赢）
        let msg = gameExtract.showmessage
            ?? agentExtract.showmessage
            ?? config.showmessage

        return ResolvedVersion(
            appVersion: appVer,
            appDownload: appDL,
            gameVersion: gameVer,
            gameZip: gameZip,
            showmessage: msg
        )
    }

    // MARK: - agent 子树（getagentversion，NewRootVC.m:885-1013）

    /// agent 子树 4 层：agent → channel → market → game
    /// （注意：game 嵌在 market 命中后才遍历 market.gamelist；与 game 子树的结构不同）
    private static func extractAgentSubtree(
        agent: Agent,
        channelId: String,
        marketId: String,
        gameId: String
    ) -> SubtreeExtract {
        var r = SubtreeExtract()

        // 层 1：agent 自身
        applyOnto(&r, from: agent)

        // 层 2：channel
        guard let channel = agent.channellist?.first(where: { $0.channelid == channelId })
        else { return r }
        applyOnto(&r, from: channel)

        // 层 3：market
        guard let market = channel.marketlist?.first(where: { $0.marketid == marketId })
        else { return r }
        applyOnto(&r, from: market)

        // 层 4：game（嵌在 market 命中后才遍历，msext 历史结构）
        // 注：Market 模型当前不带 gamelist 字段，原项目这层在 channel 节点的 marketlist
        // 内部又嵌了一份 gamelist。如服务端有这层数据需要扩展 Market.gamelist。
        // 当前 RemoteConfig 模型未声明该字段，暂跳过——若上线时发现该层有版本数据需补。

        return r
    }

    // MARK: - game 子树（getgameversion，NewRootVC.m:1015-1180）

    /// game 子树 4 层：game → game-self → channel → market
    /// （第 2 层是把 game 自身当作 infotwo 再嵌一遍 channellist；msext 那段曾经的
    /// agentid 判断被注释掉了，等价于直接走 game.channellist）
    private static func extractGameSubtree(
        game: Game,
        channelId: String,
        marketId: String
    ) -> SubtreeExtract {
        var r = SubtreeExtract()

        // 层 1：game 自身
        applyOnto(&r, from: game)

        // 层 2：game-self（理论上同 game.channellist，等价于层 3 入口，故略）

        // 层 3：channel
        guard let channel = game.channellist?.first(where: { $0.channelid == channelId })
        else { return r }
        applyOnto(&r, from: channel)

        // 层 4：market
        guard let market = channel.marketlist?.first(where: { $0.marketid == marketId })
        else { return r }
        applyOnto(&r, from: market)

        return r
    }

    // MARK: - 字段级合并

    /// IPA 合并：默认 agent 赢；game 版本号更大时 game 赢（NewRootVC.m:1408-1447）
    private static func mergeIPA(
        agent: SubtreeExtract,
        game: SubtreeExtract
    ) -> (Int, String?) {
        // 都有：取较大版本对应的下载链
        if agent.appDownload != nil && game.appDownload != nil {
            if game.appVersion > agent.appVersion {
                return (game.appVersion, game.appDownload)
            }
            return (agent.appVersion, agent.appDownload)
        }
        // 仅一边：取那边
        if let dl = agent.appDownload {
            return (agent.appVersion, dl)
        }
        if let dl = game.appDownload {
            return (game.appVersion, dl)
        }
        return (0, nil)
    }

    /// zip 合并：默认 game 赢；agent 版本号更大时 agent 赢（NewRootVC.m:1450-1492）
    private static func mergeZip(
        agent: SubtreeExtract,
        game: SubtreeExtract
    ) -> (Int, String?) {
        if agent.gameZip != nil && game.gameZip != nil {
            if agent.gameVersion > game.gameVersion {
                return (agent.gameVersion, agent.gameZip)
            }
            return (game.gameVersion, game.gameZip)
        }
        if let zip = game.gameZip {
            return (game.gameVersion, zip)
        }
        if let zip = agent.gameZip {
            return (agent.gameVersion, zip)
        }
        return (0, nil)
    }

    // MARK: - 单层逐字段覆盖工具

    /// 从单层节点向 SubtreeExtract 累加：非空字段才覆盖，等价于 msext 的
    /// `if (xxx != "" && xxx != nil) self.xxx = xxx` 语义。
    private static func applyOnto(_ r: inout SubtreeExtract, from agent: Agent) {
        if let v = Int(agent.appVersion ?? ""), v != 0 { r.appVersion = v }
        if let s = agent.appDownload, !s.isEmpty { r.appDownload = s }
        if let v = Int(agent.gameVersion ?? ""), v != 0 { r.gameVersion = v }
        if let s = agent.gameZip, !s.isEmpty { r.gameZip = s }
        if let s = agent.showmessage, !s.isEmpty { r.showmessage = s }
    }
    private static func applyOnto(_ r: inout SubtreeExtract, from channel: Channel) {
        if let v = Int(channel.appVersion ?? ""), v != 0 { r.appVersion = v }
        if let s = channel.appDownload, !s.isEmpty { r.appDownload = s }
        if let v = Int(channel.gameVersion ?? ""), v != 0 { r.gameVersion = v }
        if let s = channel.gameZip, !s.isEmpty { r.gameZip = s }
        if let s = channel.showmessage, !s.isEmpty { r.showmessage = s }
    }
    private static func applyOnto(_ r: inout SubtreeExtract, from market: Market) {
        if let v = Int(market.appVersion ?? ""), v != 0 { r.appVersion = v }
        if let s = market.appDownload, !s.isEmpty { r.appDownload = s }
        if let v = Int(market.gameVersion ?? ""), v != 0 { r.gameVersion = v }
        if let s = market.gameZip, !s.isEmpty { r.gameZip = s }
        if let s = market.showmessage, !s.isEmpty { r.showmessage = s }
    }
    private static func applyOnto(_ r: inout SubtreeExtract, from game: Game) {
        if let v = Int(game.appVersion ?? ""), v != 0 { r.appVersion = v }
        if let s = game.appDownload, !s.isEmpty { r.appDownload = s }
        if let v = Int(game.gameVersion ?? ""), v != 0 { r.gameVersion = v }
        if let s = game.gameZip, !s.isEmpty { r.gameZip = s }
        if let s = game.showmessage, !s.isEmpty { r.showmessage = s }
    }
}