Repository Public
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