ax-networking

Network.framework Networking

Quick Patterns

NetworkConnection with TLS (iOS 26+)

let connection = NetworkConnection(
    to: .hostPort(host: "example.com", port: 1029)
) { TLS() }

func communicate() async throws {
    try await connection.send(Data("Hello".utf8))
    let data = try await connection.receive(exactly: 98).content
}

Task { for await state in connection.states {
    switch state {
    case .ready: print("Connected")
    case .waiting(let e): print("Waiting: \(e)")
    case .failed(let e): print("Failed: \(e)")
    default: break
    }
}}

NetworkConnection UDP (iOS 26+)

let connection = NetworkConnection(
    to: .hostPort(host: "game.example.com", port: 9000)
) { UDP() }

func sendUpdate() async throws { try await connection.send(gameState) }

TLV Framing (iOS 26+)

let connection = NetworkConnection(
    to: .hostPort(host: "example.com", port: 1029)
) { TLV { TLS() } }

try await connection.send(data, type: MessageType.chat.rawValue)
let (data, metadata) = try await connection.receive()
// metadata.type gives you the message type (UInt32)

Coder Protocol (iOS 26+)

let connection = NetworkConnection(
    to: .hostPort(host: "example.com", port: 1029)
) { Coder(GameMessage.self, using: .json) { TLS() } }

try await connection.send(GameMessage.move(row: 1, col: 2)) // No JSON boilerplate
let msg = try await connection.receive().content // Returns GameMessage directly

NWConnection with TLS (iOS 12-25)

let connection = NWConnection(host: "mail.example.com", port: 993, using: .tls)
connection.stateUpdateHandler = { [weak self] state in
    switch state {
    case .ready: self?.sendData()
    case .waiting(let e): print("Waiting: \(e)") // Don't fail here
    case .failed(let e): print("Failed: \(e)")
    default: break
    }
}
connection.start(queue: .main)

connection.send(content: data, completion: .contentProcessed { [weak self] error in
    self?.sendNextChunk() // Pace with contentProcessed
})