@kizunajs/swift 2.0.0-beta.20 → 2.0.0-beta.21

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_generator = require("./generator-Bk6JRrTJ.cjs");
+const require_generator = require("./generator-D8fdPAdY.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_util = require("node:util");

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as generateSwiftClient } from "./generator-2GeebFHv.mjs";
+import { t as generateSwiftClient } from "./generator-BQDx47ez.mjs";
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { parseArgs } from "node:util";

package/dist/{generator-2GeebFHv.mjs → generator-BQDx47ez.mjs}

@@ -1341,6 +1341,11 @@ const emitKizunaStreaming = (writer, clientName) => {
 		writer.line("let retry: Int?");
 	});
 	writer.blank();
+	writer.block("struct Reconnection: Sendable", () => {
+		writer.line(`let policy: ${clientName}.ReconnectPolicy`);
+		writer.line("let reopen: @Sendable (String) async throws -> URLSession.AsyncBytes?");
+	});
+	writer.blank();
 	writer.block(`static func open<Failure: KizunaFailure>(_ request: inout URLRequest, session: URLSession, retry: ${clientName}.RetryPolicy?, requestMiddleware: (@Sendable (inout URLRequest) async throws -> Void)?, responseMiddleware: (@Sendable (URLRequest, Foundation.Data, URLResponse) async -> Void)?, failure: Failure.Type) async throws(Failure) -> (URLSession.AsyncBytes, Int, HTTPURLResponse)`, () => {
 		writer.line("if let requestMiddleware {");
 		writer.line("    do { try await requestMiddleware(&request) }");
@@ -1433,56 +1438,97 @@ const emitKizunaStreaming = (writer, clientName) => {
 		});
 	});
 	writer.blank();
-	writer.block("static func serverSentEvents(_ bytes: URLSession.AsyncBytes) -> AsyncThrowingStream<ServerSentEvent, Swift.Error>", () => {
+	writer.block("static func serverSentEvents(_ first: URLSession.AsyncBytes, reconnect: Reconnection?) -> AsyncThrowingStream<ServerSentEvent, Swift.Error>", () => {
 		closure(writer, "AsyncThrowingStream { continuation in", () => {
 			writer.block("let task = Task", () => {
-				writer.line("var eventType = \"\"");
-				writer.line("var dataLines: [String] = []");
 				writer.line("var lastEventId = \"\"");
-				writer.line("var retry: Int? = nil");
-				writer.block("do", () => {
-					writer.block("for try await line in lines(bytes)", () => {
-						writer.line("if line.isEmpty {");
-						writer.line("    if !dataLines.isEmpty {");
-						writer.line("        continuation.yield(ServerSentEvent(event: eventType.isEmpty ? nil : eventType, data: dataLines.joined(separator: \"\\n\"), id: lastEventId.isEmpty ? nil : lastEventId, retry: retry))");
-						writer.line("        dataLines = []");
-						writer.line("        retry = nil");
-						writer.line("    }");
-						writer.line("    eventType = \"\"");
-						writer.line("    continue");
-						writer.line("}");
-						writer.line("if line.hasPrefix(\":\") { continue }");
-						writer.line("let field: Substring");
-						writer.line("var value: Substring");
-						writer.line("if let separator = line.firstIndex(of: \":\") {");
-						writer.line("    field = line[..<separator]");
-						writer.line("    value = line[line.index(after: separator)...]");
-						writer.line("    if value.hasPrefix(\" \") { value = value.dropFirst() }");
-						writer.line("} else {");
-						writer.line("    field = Substring(line)");
-						writer.line("    value = \"\"");
-						writer.line("}");
-						writer.line("switch field {");
-						writer.line("case \"event\": eventType = String(value)");
-						writer.line("case \"data\": dataLines.append(String(value))");
-						writer.line("case \"id\": if !value.contains(\"\\0\") { lastEventId = String(value) }");
-						writer.line("case \"retry\": if !value.isEmpty, value.allSatisfy(\\.isNumber), let milliseconds = Int(value) { retry = milliseconds }");
-						writer.line("default: break");
+				writer.line("var reconnectionTime = reconnect?.policy.reconnectionTime ?? 3");
+				writer.line("var bytes: URLSession.AsyncBytes? = first");
+				writer.line("var attempts = 0");
+				writer.line("var failure: Swift.Error? = nil");
+				writer.block("while true", () => {
+					writer.block("if let current = bytes", () => {
+						writer.line("var eventType = \"\"");
+						writer.line("var dataLines: [String] = []");
+						writer.line("var pendingId = lastEventId");
+						writer.line("var retry: Int? = nil");
+						writer.line("var firstLine = true");
+						writer.block("do", () => {
+							writer.block("for try await received in lines(current)", () => {
+								writer.line("let line = firstLine && received.hasPrefix(\"\\u{FEFF}\") ? String(received.dropFirst()) : received");
+								writer.line("firstLine = false");
+								writer.line("if line.isEmpty {");
+								writer.line("    lastEventId = pendingId");
+								writer.line("    if !dataLines.isEmpty {");
+								writer.line("        continuation.yield(ServerSentEvent(event: eventType.isEmpty ? nil : eventType, data: dataLines.joined(separator: \"\\n\"), id: lastEventId.isEmpty ? nil : lastEventId, retry: retry))");
+								writer.line("        attempts = 0");
+								writer.line("        failure = nil");
+								writer.line("        dataLines = []");
+								writer.line("        retry = nil");
+								writer.line("    }");
+								writer.line("    eventType = \"\"");
+								writer.line("    continue");
+								writer.line("}");
+								writer.line("if line.hasPrefix(\":\") { continue }");
+								writer.line("let field: Substring");
+								writer.line("var value: Substring");
+								writer.line("if let separator = line.firstIndex(of: \":\") {");
+								writer.line("    field = line[..<separator]");
+								writer.line("    value = line[line.index(after: separator)...]");
+								writer.line("    if value.hasPrefix(\" \") { value = value.dropFirst() }");
+								writer.line("} else {");
+								writer.line("    field = Substring(line)");
+								writer.line("    value = \"\"");
+								writer.line("}");
+								writer.line("switch field {");
+								writer.line("case \"event\": eventType = String(value)");
+								writer.line("case \"data\": dataLines.append(String(value))");
+								writer.line("case \"id\": if !value.contains(\"\\0\") { pendingId = String(value) }");
+								writer.line("case \"retry\": if !value.isEmpty, value.allSatisfy({ $0.isASCII && $0.isNumber }), let milliseconds = Int(value) { retry = milliseconds; reconnectionTime = min(TimeInterval(milliseconds) / 1000, 3600) }");
+								writer.line("default: break");
+								writer.line("}");
+							});
+						});
+						writer.line("catch { failure = error }");
+					});
+					writer.line("guard let reconnect, !Task.isCancelled, attempts < reconnect.policy.maximumAttempts else {");
+					writer.line("    continuation.finish(throwing: failure)");
+					writer.line("    return");
+					writer.line("}");
+					writer.line("attempts += 1");
+					writer.line("let ceiling = min(reconnect.policy.maximumDelay, reconnectionTime * pow(2, Double(attempts - 1)))");
+					writer.line("let delay = max(0, reconnectionTime) + Double.random(in: 0...max(0, ceiling - reconnectionTime))");
+					writer.line("do { try await Task.sleep(nanoseconds: UInt64(delay * 1_000_000_000)) }");
+					writer.line("catch {");
+					writer.line("    continuation.finish(throwing: failure)");
+					writer.line("    return");
+					writer.line("}");
+					writer.block("do", () => {
+						writer.line("guard let reopened = try await reconnect.reopen(lastEventId) else {");
+						writer.line("    continuation.finish()");
+						writer.line("    return");
 						writer.line("}");
+						writer.line("bytes = reopened");
+					});
+					writer.block("catch let error as URLError", () => {
+						writer.line("failure = error");
+						writer.line("bytes = nil");
+					});
+					writer.block("catch", () => {
+						writer.line("continuation.finish(throwing: error)");
+						writer.line("return");
 					});
-					writer.line("continuation.finish()");
 				});
-				writer.line("catch { continuation.finish(throwing: error) }");
 			});
 			writer.line("continuation.onTermination = { _ in task.cancel() }");
 		});
 	});
 	writer.blank();
-	writer.block("static func events<Event: Sendable>(_ bytes: URLSession.AsyncBytes, using decoder: JSONDecoder, _ decode: @escaping @Sendable (ServerSentEvent, JSONDecoder) throws -> Event?) -> AsyncThrowingStream<Event, Swift.Error>", () => {
+	writer.block("static func events<Event: Sendable>(_ bytes: URLSession.AsyncBytes, using decoder: JSONDecoder, reconnect: Reconnection? = nil, _ decode: @escaping @Sendable (ServerSentEvent, JSONDecoder) throws -> Event?) -> AsyncThrowingStream<Event, Swift.Error>", () => {
 		closure(writer, "AsyncThrowingStream { continuation in", () => {
 			writer.block("let task = Task", () => {
 				writer.block("do", () => {
-					writer.block("for try await event in serverSentEvents(bytes)", () => {
+					writer.block("for try await event in serverSentEvents(bytes, reconnect: reconnect)", () => {
 						writer.line("if let decoded = try decode(event, decoder) { continuation.yield(decoded) }");
 					});
 					writer.line("continuation.finish()");
@@ -1865,6 +1911,35 @@ const emitErrorCases = (writer, method, context, receiver, prelude) => {
 		}
 	}
 };
+const IDEMPOTENT_METHODS = new Set([
+	"GET",
+	"HEAD",
+	"OPTIONS",
+	"PUT",
+	"DELETE"
+]);
+/**
+* Writes the closure that reopens an event stream and returns the argument handing it to `Kizuna.events`, or nothing
+* for a method a client may not resend.
+*/
+const emitReopen = (writer, method, receiver, failure, status) => {
+	if (!IDEMPOTENT_METHODS.has(method.method)) return "";
+	closure(writer, `let reopen: @Sendable (String) async throws -> URLSession.AsyncBytes? = { [request, session = ${receiver}session, retry = ${receiver}retry, requestMiddleware = ${receiver}requestMiddleware, responseMiddleware = ${receiver}responseMiddleware] lastEventId in`, () => {
+		writer.line("var again = request");
+		writer.line("if !lastEventId.isEmpty { again.setValue(lastEventId, forHTTPHeaderField: \"Last-Event-ID\") }");
+		writer.line("let reopened: (URLSession.AsyncBytes, Int, HTTPURLResponse)");
+		writer.line(`do { reopened = try await Kizuna.open(&again, session: session, retry: retry, requestMiddleware: requestMiddleware, responseMiddleware: responseMiddleware, failure: ${failure}.self) }`);
+		writer.line(`catch let failure as ${failure} {`);
+		writer.line("    if case .requestFailed(let underlying) = failure { throw underlying }");
+		writer.line("    throw failure");
+		writer.line("}");
+		writer.line("if reopened.1 == 204 { return nil }");
+		writer.line(`guard reopened.1 == ${status} else { throw ${failure}.unexpectedStatus(reopened.1, Foundation.Data()) }`);
+		writer.line(`guard reopened.2.value(forHTTPHeaderField: "Content-Type")?.lowercased().hasPrefix("text/event-stream") == true else { throw ${failure}.invalidResponse }`);
+		writer.line("return reopened.0");
+	});
+	return `, reconnect: ${receiver}reconnect.map { Kizuna.Reconnection(policy: $0, reopen: reopen) }`;
+};
 const emitStreamMethodTail = (writer, method, context, receiver, responseBinding) => {
 	const failure = failureRef(method, context);
 	const stream = method.stream;
@@ -1880,7 +1955,8 @@ const emitStreamMethodTail = (writer, method, context, receiver, responseBinding
 		else if (stream.mode === "binary") writer.line("let body = Kizuna.chunks(bytes)");
 		else if (stream.events) {
 			const events = stream.events;
-			closure(writer, `let body = Kizuna.events(bytes, using: ${receiver}decoder) { event, decoder -> ${streamElementType(method, context, "actor")}? in`, () => {
+			const elementType = streamElementType(method, context, "actor");
+			closure(writer, `let body = Kizuna.events(bytes, using: ${receiver}decoder${emitReopen(writer, method, receiver, failure, stream.status)}) { event, decoder -> ${elementType}? in`, () => {
 				writer.line("switch event.event {");
 				for (const event of events) {
 					const payloadType = resolveType(event.type, method.operationName, context);
@@ -1891,7 +1967,7 @@ const emitStreamMethodTail = (writer, method, context, receiver, responseBinding
 			});
 		} else {
 			const elementType = streamElementType(method, context, "actor");
-			closure(writer, `let body = Kizuna.events(bytes, using: ${receiver}decoder) { event, decoder -> ${elementType}? in`, () => {
+			closure(writer, `let body = Kizuna.events(bytes, using: ${receiver}decoder${emitReopen(writer, method, receiver, failure, stream.status)}) { event, decoder -> ${elementType}? in`, () => {
 				writer.line(`try decoder.decode(${elementType}.self, from: Foundation.Data(event.data.utf8))`);
 			});
 		}
@@ -2022,6 +2098,22 @@ const emitClient = (writer, config, partition, context, typesByOperation) => {
 				writer.line("self.maximumDelay = maximumDelay");
 			});
 		});
+		writer.blank();
+		writer.docComment("Reconnects an event stream on a GET, HEAD, OPTIONS, PUT or DELETE when its connection drops, sending the id of the last event as Last-Event-ID.");
+		writer.block("public struct ReconnectPolicy: Sendable", () => {
+			writer.docComment("Reconnections in a row before the stream fails. An event received resets the count.");
+			writer.line("public var maximumAttempts: Int");
+			writer.docComment("Seconds to wait before reconnecting, until the server sends a retry field.");
+			writer.line("public var reconnectionTime: TimeInterval");
+			writer.docComment("Seconds the wait may grow to after reconnections in a row that fail.");
+			writer.line("public var maximumDelay: TimeInterval");
+			writer.blank();
+			writer.block("public init(maximumAttempts: Int = 5, reconnectionTime: TimeInterval = 3, maximumDelay: TimeInterval = 30)", () => {
+				writer.line("self.maximumAttempts = maximumAttempts");
+				writer.line("self.reconnectionTime = reconnectionTime");
+				writer.line("self.maximumDelay = maximumDelay");
+			});
+		});
 		if (usesMultipart) {
 			writer.blank();
 			writer.block("public struct MultipartFile: Sendable, Equatable", () => {
@@ -2120,15 +2212,17 @@ const emitClient = (writer, config, partition, context, typesByOperation) => {
 		writer.line("public let requestMiddleware: (@Sendable (inout URLRequest) async throws -> Void)?");
 		writer.line("public let responseMiddleware: (@Sendable (URLRequest, Foundation.Data, URLResponse) async -> Void)?");
 		writer.line("public let retry: RetryPolicy?");
+		writer.line("public let reconnect: ReconnectPolicy?");
 		writer.line("let encoder: JSONEncoder");
 		writer.line("let decoder: JSONDecoder");
 		writer.blank();
 		const contextInitParam = contextFields.length > 0 ? `, requestContext: RequestContext${contextRequired ? "" : " = RequestContext()"}` : "";
-		writer.block(`public init(baseURL: URL, session: URLSession = .shared, timeout: TimeInterval = 30, retry: RetryPolicy? = nil${contextInitParam}, requestMiddleware: (@Sendable (inout URLRequest) async throws -> Void)? = nil, responseMiddleware: (@Sendable (URLRequest, Foundation.Data, URLResponse) async -> Void)? = nil)`, () => {
+		writer.block(`public init(baseURL: URL, session: URLSession = .shared, timeout: TimeInterval = 30, retry: RetryPolicy? = nil, reconnect: ReconnectPolicy? = nil${contextInitParam}, requestMiddleware: (@Sendable (inout URLRequest) async throws -> Void)? = nil, responseMiddleware: (@Sendable (URLRequest, Foundation.Data, URLResponse) async -> Void)? = nil)`, () => {
 			writer.line("self.baseURL = baseURL");
 			writer.line("self.session = session");
 			writer.line("self.timeout = timeout");
 			writer.line("self.retry = retry");
+			writer.line("self.reconnect = reconnect");
 			if (contextFields.length > 0) writer.line("self.requestContextHeaders = requestContext.headerFields");
 			writer.line("self.requestMiddleware = requestMiddleware");
 			writer.line("self.responseMiddleware = responseMiddleware");

package/dist/{generator-Bk6JRrTJ.cjs → generator-D8fdPAdY.cjs}

@@ -1341,6 +1341,11 @@ const emitKizunaStreaming = (writer, clientName) => {
 		writer.line("let retry: Int?");
 	});
 	writer.blank();
+	writer.block("struct Reconnection: Sendable", () => {
+		writer.line(`let policy: ${clientName}.ReconnectPolicy`);
+		writer.line("let reopen: @Sendable (String) async throws -> URLSession.AsyncBytes?");
+	});
+	writer.blank();
 	writer.block(`static func open<Failure: KizunaFailure>(_ request: inout URLRequest, session: URLSession, retry: ${clientName}.RetryPolicy?, requestMiddleware: (@Sendable (inout URLRequest) async throws -> Void)?, responseMiddleware: (@Sendable (URLRequest, Foundation.Data, URLResponse) async -> Void)?, failure: Failure.Type) async throws(Failure) -> (URLSession.AsyncBytes, Int, HTTPURLResponse)`, () => {
 		writer.line("if let requestMiddleware {");
 		writer.line("    do { try await requestMiddleware(&request) }");
@@ -1433,56 +1438,97 @@ const emitKizunaStreaming = (writer, clientName) => {
 		});
 	});
 	writer.blank();
-	writer.block("static func serverSentEvents(_ bytes: URLSession.AsyncBytes) -> AsyncThrowingStream<ServerSentEvent, Swift.Error>", () => {
+	writer.block("static func serverSentEvents(_ first: URLSession.AsyncBytes, reconnect: Reconnection?) -> AsyncThrowingStream<ServerSentEvent, Swift.Error>", () => {
 		closure(writer, "AsyncThrowingStream { continuation in", () => {
 			writer.block("let task = Task", () => {
-				writer.line("var eventType = \"\"");
-				writer.line("var dataLines: [String] = []");
 				writer.line("var lastEventId = \"\"");
-				writer.line("var retry: Int? = nil");
-				writer.block("do", () => {
-					writer.block("for try await line in lines(bytes)", () => {
-						writer.line("if line.isEmpty {");
-						writer.line("    if !dataLines.isEmpty {");
-						writer.line("        continuation.yield(ServerSentEvent(event: eventType.isEmpty ? nil : eventType, data: dataLines.joined(separator: \"\\n\"), id: lastEventId.isEmpty ? nil : lastEventId, retry: retry))");
-						writer.line("        dataLines = []");
-						writer.line("        retry = nil");
-						writer.line("    }");
-						writer.line("    eventType = \"\"");
-						writer.line("    continue");
-						writer.line("}");
-						writer.line("if line.hasPrefix(\":\") { continue }");
-						writer.line("let field: Substring");
-						writer.line("var value: Substring");
-						writer.line("if let separator = line.firstIndex(of: \":\") {");
-						writer.line("    field = line[..<separator]");
-						writer.line("    value = line[line.index(after: separator)...]");
-						writer.line("    if value.hasPrefix(\" \") { value = value.dropFirst() }");
-						writer.line("} else {");
-						writer.line("    field = Substring(line)");
-						writer.line("    value = \"\"");
-						writer.line("}");
-						writer.line("switch field {");
-						writer.line("case \"event\": eventType = String(value)");
-						writer.line("case \"data\": dataLines.append(String(value))");
-						writer.line("case \"id\": if !value.contains(\"\\0\") { lastEventId = String(value) }");
-						writer.line("case \"retry\": if !value.isEmpty, value.allSatisfy(\\.isNumber), let milliseconds = Int(value) { retry = milliseconds }");
-						writer.line("default: break");
+				writer.line("var reconnectionTime = reconnect?.policy.reconnectionTime ?? 3");
+				writer.line("var bytes: URLSession.AsyncBytes? = first");
+				writer.line("var attempts = 0");
+				writer.line("var failure: Swift.Error? = nil");
+				writer.block("while true", () => {
+					writer.block("if let current = bytes", () => {
+						writer.line("var eventType = \"\"");
+						writer.line("var dataLines: [String] = []");
+						writer.line("var pendingId = lastEventId");
+						writer.line("var retry: Int? = nil");
+						writer.line("var firstLine = true");
+						writer.block("do", () => {
+							writer.block("for try await received in lines(current)", () => {
+								writer.line("let line = firstLine && received.hasPrefix(\"\\u{FEFF}\") ? String(received.dropFirst()) : received");
+								writer.line("firstLine = false");
+								writer.line("if line.isEmpty {");
+								writer.line("    lastEventId = pendingId");
+								writer.line("    if !dataLines.isEmpty {");
+								writer.line("        continuation.yield(ServerSentEvent(event: eventType.isEmpty ? nil : eventType, data: dataLines.joined(separator: \"\\n\"), id: lastEventId.isEmpty ? nil : lastEventId, retry: retry))");
+								writer.line("        attempts = 0");
+								writer.line("        failure = nil");
+								writer.line("        dataLines = []");
+								writer.line("        retry = nil");
+								writer.line("    }");
+								writer.line("    eventType = \"\"");
+								writer.line("    continue");
+								writer.line("}");
+								writer.line("if line.hasPrefix(\":\") { continue }");
+								writer.line("let field: Substring");
+								writer.line("var value: Substring");
+								writer.line("if let separator = line.firstIndex(of: \":\") {");
+								writer.line("    field = line[..<separator]");
+								writer.line("    value = line[line.index(after: separator)...]");
+								writer.line("    if value.hasPrefix(\" \") { value = value.dropFirst() }");
+								writer.line("} else {");
+								writer.line("    field = Substring(line)");
+								writer.line("    value = \"\"");
+								writer.line("}");
+								writer.line("switch field {");
+								writer.line("case \"event\": eventType = String(value)");
+								writer.line("case \"data\": dataLines.append(String(value))");
+								writer.line("case \"id\": if !value.contains(\"\\0\") { pendingId = String(value) }");
+								writer.line("case \"retry\": if !value.isEmpty, value.allSatisfy({ $0.isASCII && $0.isNumber }), let milliseconds = Int(value) { retry = milliseconds; reconnectionTime = min(TimeInterval(milliseconds) / 1000, 3600) }");
+								writer.line("default: break");
+								writer.line("}");
+							});
+						});
+						writer.line("catch { failure = error }");
+					});
+					writer.line("guard let reconnect, !Task.isCancelled, attempts < reconnect.policy.maximumAttempts else {");
+					writer.line("    continuation.finish(throwing: failure)");
+					writer.line("    return");
+					writer.line("}");
+					writer.line("attempts += 1");
+					writer.line("let ceiling = min(reconnect.policy.maximumDelay, reconnectionTime * pow(2, Double(attempts - 1)))");
+					writer.line("let delay = max(0, reconnectionTime) + Double.random(in: 0...max(0, ceiling - reconnectionTime))");
+					writer.line("do { try await Task.sleep(nanoseconds: UInt64(delay * 1_000_000_000)) }");
+					writer.line("catch {");
+					writer.line("    continuation.finish(throwing: failure)");
+					writer.line("    return");
+					writer.line("}");
+					writer.block("do", () => {
+						writer.line("guard let reopened = try await reconnect.reopen(lastEventId) else {");
+						writer.line("    continuation.finish()");
+						writer.line("    return");
 						writer.line("}");
+						writer.line("bytes = reopened");
+					});
+					writer.block("catch let error as URLError", () => {
+						writer.line("failure = error");
+						writer.line("bytes = nil");
+					});
+					writer.block("catch", () => {
+						writer.line("continuation.finish(throwing: error)");
+						writer.line("return");
 					});
-					writer.line("continuation.finish()");
 				});
-				writer.line("catch { continuation.finish(throwing: error) }");
 			});
 			writer.line("continuation.onTermination = { _ in task.cancel() }");
 		});
 	});
 	writer.blank();
-	writer.block("static func events<Event: Sendable>(_ bytes: URLSession.AsyncBytes, using decoder: JSONDecoder, _ decode: @escaping @Sendable (ServerSentEvent, JSONDecoder) throws -> Event?) -> AsyncThrowingStream<Event, Swift.Error>", () => {
+	writer.block("static func events<Event: Sendable>(_ bytes: URLSession.AsyncBytes, using decoder: JSONDecoder, reconnect: Reconnection? = nil, _ decode: @escaping @Sendable (ServerSentEvent, JSONDecoder) throws -> Event?) -> AsyncThrowingStream<Event, Swift.Error>", () => {
 		closure(writer, "AsyncThrowingStream { continuation in", () => {
 			writer.block("let task = Task", () => {
 				writer.block("do", () => {
-					writer.block("for try await event in serverSentEvents(bytes)", () => {
+					writer.block("for try await event in serverSentEvents(bytes, reconnect: reconnect)", () => {
 						writer.line("if let decoded = try decode(event, decoder) { continuation.yield(decoded) }");
 					});
 					writer.line("continuation.finish()");
@@ -1865,6 +1911,35 @@ const emitErrorCases = (writer, method, context, receiver, prelude) => {
 		}
 	}
 };
+const IDEMPOTENT_METHODS = new Set([
+	"GET",
+	"HEAD",
+	"OPTIONS",
+	"PUT",
+	"DELETE"
+]);
+/**
+* Writes the closure that reopens an event stream and returns the argument handing it to `Kizuna.events`, or nothing
+* for a method a client may not resend.
+*/
+const emitReopen = (writer, method, receiver, failure, status) => {
+	if (!IDEMPOTENT_METHODS.has(method.method)) return "";
+	closure(writer, `let reopen: @Sendable (String) async throws -> URLSession.AsyncBytes? = { [request, session = ${receiver}session, retry = ${receiver}retry, requestMiddleware = ${receiver}requestMiddleware, responseMiddleware = ${receiver}responseMiddleware] lastEventId in`, () => {
+		writer.line("var again = request");
+		writer.line("if !lastEventId.isEmpty { again.setValue(lastEventId, forHTTPHeaderField: \"Last-Event-ID\") }");
+		writer.line("let reopened: (URLSession.AsyncBytes, Int, HTTPURLResponse)");
+		writer.line(`do { reopened = try await Kizuna.open(&again, session: session, retry: retry, requestMiddleware: requestMiddleware, responseMiddleware: responseMiddleware, failure: ${failure}.self) }`);
+		writer.line(`catch let failure as ${failure} {`);
+		writer.line("    if case .requestFailed(let underlying) = failure { throw underlying }");
+		writer.line("    throw failure");
+		writer.line("}");
+		writer.line("if reopened.1 == 204 { return nil }");
+		writer.line(`guard reopened.1 == ${status} else { throw ${failure}.unexpectedStatus(reopened.1, Foundation.Data()) }`);
+		writer.line(`guard reopened.2.value(forHTTPHeaderField: "Content-Type")?.lowercased().hasPrefix("text/event-stream") == true else { throw ${failure}.invalidResponse }`);
+		writer.line("return reopened.0");
+	});
+	return `, reconnect: ${receiver}reconnect.map { Kizuna.Reconnection(policy: $0, reopen: reopen) }`;
+};
 const emitStreamMethodTail = (writer, method, context, receiver, responseBinding) => {
 	const failure = failureRef(method, context);
 	const stream = method.stream;
@@ -1880,7 +1955,8 @@ const emitStreamMethodTail = (writer, method, context, receiver, responseBinding
 		else if (stream.mode === "binary") writer.line("let body = Kizuna.chunks(bytes)");
 		else if (stream.events) {
 			const events = stream.events;
-			closure(writer, `let body = Kizuna.events(bytes, using: ${receiver}decoder) { event, decoder -> ${streamElementType(method, context, "actor")}? in`, () => {
+			const elementType = streamElementType(method, context, "actor");
+			closure(writer, `let body = Kizuna.events(bytes, using: ${receiver}decoder${emitReopen(writer, method, receiver, failure, stream.status)}) { event, decoder -> ${elementType}? in`, () => {
 				writer.line("switch event.event {");
 				for (const event of events) {
 					const payloadType = resolveType(event.type, method.operationName, context);
@@ -1891,7 +1967,7 @@ const emitStreamMethodTail = (writer, method, context, receiver, responseBinding
 			});
 		} else {
 			const elementType = streamElementType(method, context, "actor");
-			closure(writer, `let body = Kizuna.events(bytes, using: ${receiver}decoder) { event, decoder -> ${elementType}? in`, () => {
+			closure(writer, `let body = Kizuna.events(bytes, using: ${receiver}decoder${emitReopen(writer, method, receiver, failure, stream.status)}) { event, decoder -> ${elementType}? in`, () => {
 				writer.line(`try decoder.decode(${elementType}.self, from: Foundation.Data(event.data.utf8))`);
 			});
 		}
@@ -2022,6 +2098,22 @@ const emitClient = (writer, config, partition, context, typesByOperation) => {
 				writer.line("self.maximumDelay = maximumDelay");
 			});
 		});
+		writer.blank();
+		writer.docComment("Reconnects an event stream on a GET, HEAD, OPTIONS, PUT or DELETE when its connection drops, sending the id of the last event as Last-Event-ID.");
+		writer.block("public struct ReconnectPolicy: Sendable", () => {
+			writer.docComment("Reconnections in a row before the stream fails. An event received resets the count.");
+			writer.line("public var maximumAttempts: Int");
+			writer.docComment("Seconds to wait before reconnecting, until the server sends a retry field.");
+			writer.line("public var reconnectionTime: TimeInterval");
+			writer.docComment("Seconds the wait may grow to after reconnections in a row that fail.");
+			writer.line("public var maximumDelay: TimeInterval");
+			writer.blank();
+			writer.block("public init(maximumAttempts: Int = 5, reconnectionTime: TimeInterval = 3, maximumDelay: TimeInterval = 30)", () => {
+				writer.line("self.maximumAttempts = maximumAttempts");
+				writer.line("self.reconnectionTime = reconnectionTime");
+				writer.line("self.maximumDelay = maximumDelay");
+			});
+		});
 		if (usesMultipart) {
 			writer.blank();
 			writer.block("public struct MultipartFile: Sendable, Equatable", () => {
@@ -2120,15 +2212,17 @@ const emitClient = (writer, config, partition, context, typesByOperation) => {
 		writer.line("public let requestMiddleware: (@Sendable (inout URLRequest) async throws -> Void)?");
 		writer.line("public let responseMiddleware: (@Sendable (URLRequest, Foundation.Data, URLResponse) async -> Void)?");
 		writer.line("public let retry: RetryPolicy?");
+		writer.line("public let reconnect: ReconnectPolicy?");
 		writer.line("let encoder: JSONEncoder");
 		writer.line("let decoder: JSONDecoder");
 		writer.blank();
 		const contextInitParam = contextFields.length > 0 ? `, requestContext: RequestContext${contextRequired ? "" : " = RequestContext()"}` : "";
-		writer.block(`public init(baseURL: URL, session: URLSession = .shared, timeout: TimeInterval = 30, retry: RetryPolicy? = nil${contextInitParam}, requestMiddleware: (@Sendable (inout URLRequest) async throws -> Void)? = nil, responseMiddleware: (@Sendable (URLRequest, Foundation.Data, URLResponse) async -> Void)? = nil)`, () => {
+		writer.block(`public init(baseURL: URL, session: URLSession = .shared, timeout: TimeInterval = 30, retry: RetryPolicy? = nil, reconnect: ReconnectPolicy? = nil${contextInitParam}, requestMiddleware: (@Sendable (inout URLRequest) async throws -> Void)? = nil, responseMiddleware: (@Sendable (URLRequest, Foundation.Data, URLResponse) async -> Void)? = nil)`, () => {
 			writer.line("self.baseURL = baseURL");
 			writer.line("self.session = session");
 			writer.line("self.timeout = timeout");
 			writer.line("self.retry = retry");
+			writer.line("self.reconnect = reconnect");
 			if (contextFields.length > 0) writer.line("self.requestContextHeaders = requestContext.headerFields");
 			writer.line("self.requestMiddleware = requestMiddleware");
 			writer.line("self.responseMiddleware = responseMiddleware");

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_generator = require("./generator-Bk6JRrTJ.cjs");
+const require_generator = require("./generator-D8fdPAdY.cjs");
 let kizunajs_generator = require("kizunajs/generator");
 let zod = require("zod");
 //#region src/client-target.ts

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { n as swiftClientWalk, t as generateSwiftClient } from "./generator-2GeebFHv.mjs";
+import { n as swiftClientWalk, t as generateSwiftClient } from "./generator-BQDx47ez.mjs";
 import { defineClient } from "kizunajs/generator";
 import { z } from "zod";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kizunajs/swift",
-  "version": "2.0.0-beta.20",
+  "version": "2.0.0-beta.21",
   "description": "Swift client generation for Kizuna.js APIs",
   "keywords": [
     "kizunajs",
@@ -59,14 +59,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@kizunajs/cli": "2.0.0-beta.20"
+    "@kizunajs/cli": "2.0.0-beta.21"
   },
   "peerDependencies": {
-    "kizunajs": "2.0.0-beta.20",
+    "kizunajs": "2.0.0-beta.21",
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "kizunajs": "2.0.0-beta.20",
+    "kizunajs": "2.0.0-beta.21",
     "@types/node": "^24",
     "tsdown": "^0.21.0",
     "typescript": "^6.0.3",