punchnet-macos/Tun/Punchnet/SDLIPV6AssistClient.swift

//
//  SDLDNSClient 2.swift
//  punchnet
//
//  Created by 安礼成 on 2026/4/9.
//
import Foundation
import Network

actor SDLIPV6AssistClient {
    
    private enum State {
        case idle
        case running
        case stopped
    }
    
    private var state: State = .idle
    private var connection: NWConnection?
    private var receiveTask: Task<Void, Never>?
    private let assistServerAddress: NWEndpoint
    
    // 用于对外输出收到的原始 IP 响应包
    let packetFlow: AsyncStream<SDLV6AssistProbeReply>
    private let packetContinuation: AsyncStream<SDLV6AssistProbeReply>.Continuation
    private var didFinishPacketFlow = false
    
    // 用来处理关闭事件
    private let closeStream: AsyncStream<Void>
    private let closeContinuation: AsyncStream<Void>.Continuation
    private var didFinishCloseStream = false
    
    init?(assistServerInfo: SDLV6Info) {
        guard assistServerInfo.port <= UInt32(UInt16.max), let host = SDLUtil.ipv6DataToString(assistServerInfo.v6) else {
            return nil
        }
        
        let (packetStream, packetContinuation) = AsyncStream.makeStream(of: SDLV6AssistProbeReply.self, bufferingPolicy: .bufferingNewest(256))
        self.packetFlow = packetStream
        self.packetContinuation = packetContinuation
        
        let (closeStream, closeContinuation) = AsyncStream.makeStream(of: Void.self, bufferingPolicy: .bufferingNewest(1))
        self.closeStream = closeStream
        self.closeContinuation = closeContinuation
        
        self.assistServerAddress = .hostPort(host: NWEndpoint.Host(host), port: NWEndpoint.Port(integerLiteral: UInt16(assistServerInfo.port)))
    }
    
    func start() {
        guard case .idle = self.state else {
            return
        }
        
        self.state = .running
        
        // 1. 配置参数：这是解决环路的关键
        let parameters = NWParameters.udp
        
        // 禁止此连接走 TUN 网卡（在 NE 中 TUN 通常被归类为 .other）
        parameters.prohibitedInterfaceTypes = [.other]
        // 2. 增强健壮性：启用多路径切换（替代 pathSelectionOptions 的意图）
        parameters.multipathServiceType = .handover
        
        // 只允许走 IPv6，避免在 assist 通道上退回到 IPv4 或双栈协商。
        if let ipOptions = parameters.defaultProtocolStack.internetProtocol as? NWProtocolIP.Options {
            ipOptions.version = .v6
        }
        
        // 2. 创建连接
        let connection = NWConnection(to: self.assistServerAddress, using: parameters)
        self.connection = connection
        
        connection.stateUpdateHandler = { [weak self] state in
            Task {
                await self?.handleConnectionStateUpdate(state, for: connection)
            }
        }
        
        // 启动连接队列
        connection.start(queue: .global())
    }
    
    public func waitClose() async {
        for await _ in self.closeStream { }
    }
    
    /// 接收数据的递归循环
    private static func makeReceiveStream(for connection: NWConnection) -> AsyncStream<Data> {
        return AsyncStream(bufferingPolicy: .bufferingNewest(256)) { continuation in
            func receiveNext() {
                connection.receiveMessage { content, _, _, error in
                    if let data = content, !data.isEmpty {
                        // 将收到的 DNS 响应写回 AsyncStream
                        continuation.yield(data)
                    }
                    
                    if error == nil && connection.state == .ready {
                        receiveNext() // 继续监听下一个包
                    } else {
                        continuation.finish()
                    }
                }
            }
            
            receiveNext()
        }
    }
    
    func probe() {
        guard case .running = self.state, let connection = self.connection, connection.state == .ready else {
            return
        }
        var assistProbe = SDLV6AssistProbe()
        assistProbe.assistToken = Data()
        
        if let data = try? assistProbe.serializedData() {
            connection.send(content: data, completion: .contentProcessed { _ in})
        }
    }
    
    func stop() {
        guard self.state != .stopped else {
            return
        }
        
        self.state = .stopped
        self.receiveTask?.cancel()
        self.receiveTask = nil
        self.connection?.cancel()
        self.connection = nil
        self.finishPacketFlowIfNeeded()
        self.finishCloseStreamIfNeeded()
    }
    
    private func handleConnectionStateUpdate(_ state: NWConnection.State, for connection: NWConnection) {
        guard case .running = self.state else {
            return
        }
        
        switch state {
        case .ready:
            SDLLogger.log("[SDLIPV6AssistClient] Connection ready", for: .debug)
            self.startReceiveTask(for: connection)
        case .failed(let error):
            SDLLogger.log("[SDLIPV6AssistClient] Connection failed: \(error)", for: .debug)
            self.stop()
        case .cancelled:
            self.stop()
        default:
            break
        }
    }
    
    private func startReceiveTask(for connection: NWConnection) {
        guard self.receiveTask == nil else {
            return
        }
        
        let stream = Self.makeReceiveStream(for: connection)
        self.receiveTask = Task { [weak self] in
            for await data in stream {
                guard let self else {
                    break
                }
                await self.handleReceivedPacket(data)
            }
            
            await self?.didFinishReceiving(for: connection)
        }
    }
    
    private func handleReceivedPacket(_ data: Data) {
        guard case .running = self.state else {
            return
        }
        
        do {
            let packet = try SDLV6AssistProbeReply(serializedBytes: data)
            self.packetContinuation.yield(packet)
        } catch {
            SDLLogger.log("[SDLIPV6AssistClient] Receive error: \(error)", for: .debug)
        }
    }
    
    private func didFinishReceiving(for connection: NWConnection) {
        guard case .running = self.state else {
            return
        }
        
        if self.connection === connection, connection.state != .ready {
            self.stop()
        } else {
            self.receiveTask = nil
        }
    }
    
    private func finishPacketFlowIfNeeded() {
        guard !self.didFinishPacketFlow else {
            return
        }
        
        self.didFinishPacketFlow = true
        self.packetContinuation.finish()
    }
    
    private func finishCloseStreamIfNeeded() {
        guard !self.didFinishCloseStream else {
            return
        }
        
        self.didFinishCloseStream = true
        self.closeContinuation.finish()
    }
    
    deinit {
        self.connection?.cancel()
    }
}