SPB Git

Repository Public

SSE.swift 4.2 KB 95 lines swift

1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: Packages/LocalChatNetworking/Sources/SSE.swift3// Description: Server-Sent Events: an incremental parser (bytes in, events out) and a writer used by the Local API server.4import Foundation56public struct SSEEvent: Sendable, Hashable {7    public var event: String?8    public var data: String9    public var id: String?10    public init(event: String? = nil, data: String, id: String? = nil) { self.event = event; self.data = data; self.id = id }11    /// The OpenAI end-of-stream sentinel.12    public var isDone: Bool { data.trimmingCharacters(in: .whitespaces) == "[DONE]" }13}1415/// Incremental parser following the WHATWG event-stream rules: LF, CRLF or CR line ends, multi-line `data:`, comments, optional space after the colon.16public struct SSEParser: Sendable {17    private var buffer: [UInt8] = []18    private var dataLines: [String] = []19    private var eventName: String?20    private var lastID: String?21    private var sawCR = false22    private var hasFields = false2324    public init() {}2526    public mutating func feed(_ data: Data) -> [SSEEvent] { feed(bytes: [UInt8](data)) }27    public mutating func feed(_ text: String) -> [SSEEvent] { feed(bytes: [UInt8](text.utf8)) }2829    public mutating func feed(bytes: [UInt8]) -> [SSEEvent] {30        var events: [SSEEvent] = []31        for byte in bytes {32            if sawCR {33                sawCR = false34                if byte == 0x0A { continue }   // CRLF: the LF belongs to the line already ended35            }36            if byte == 0x0D { sawCR = true; endLine(&events) }37            else if byte == 0x0A { endLine(&events) }38            else { buffer.append(byte) }39        }40        return events41    }4243    /// Flushes an event left without its terminating blank line (a server that closes right after the last `data:`).44    public mutating func finish() -> [SSEEvent] {45        var events: [SSEEvent] = []46        if !buffer.isEmpty { endLine(&events) }47        dispatch(&events)48        return events49    }5051    private mutating func endLine(_ events: inout [SSEEvent]) {52        var line = String(decoding: buffer, as: UTF8.self)53        buffer.removeAll(keepingCapacity: true)54        if line.hasPrefix("\u{FEFF}") { line.removeFirst() }55        if line.isEmpty { dispatch(&events); return }56        if line.hasPrefix(":") { return }   // comment / keep-alive57        let field: String; var value: String58        if let colon = line.firstIndex(of: ":") {59            field = String(line[..<colon]); value = String(line[line.index(after: colon)...])60            if value.hasPrefix(" ") { value.removeFirst() }61        } else { field = line; value = "" }62        switch field {63        case "data": dataLines.append(value); hasFields = true64        case "event": eventName = value; hasFields = true65        case "id": if !value.contains("\0") { lastID = value }; hasFields = true66        default: break   // "retry" and unknown fields are ignored67        }68    }6970    private mutating func dispatch(_ events: inout [SSEEvent]) {71        defer { dataLines.removeAll(); eventName = nil; hasFields = false }72        guard hasFields, !dataLines.isEmpty else { return }73        events.append(SSEEvent(event: eventName, data: dataLines.joined(separator: "\n"), id: lastID))74    }75}7677public enum SSEWriter {78    /// Encodes one event. Multi-line payloads become several `data:` lines.79    public static func event(_ data: String, event: String? = nil, id: String? = nil) -> Data {80        var out = ""81        if let event { out += "event: \(event)\n" }82        if let id { out += "id: \(id)\n" }83        for line in data.split(separator: "\n", omittingEmptySubsequences: false) { out += "data: \(line)\n" }84        out += "\n"85        return Data(out.utf8)86    }87    public static func json<T: Encodable>(_ value: T, event: String? = nil) -> Data {88        let encoder = JSONEncoder(); encoder.outputFormatting = [.withoutEscapingSlashes]89        let text = (try? encoder.encode(value)).map { String(decoding: $0, as: UTF8.self) } ?? "{}"90        return self.event(text, event: event)91    }92    public static let done = Data("data: [DONE]\n\n".utf8)93    public static func comment(_ text: String = "keep-alive") -> Data { Data(": \(text)\n\n".utf8) }94}95
Files main
Menu

Theme