Changelog

November 7, 2025

3.14.2

(fix): 修复请求体中 Optional.empty() 的双重包装问题。线路测试和动态代码片段现在正确生成 Optional.empty() 而不是 Optional.of(Optional.empty()) 用于可选请求体。

3.14.1

(fix): 通过从预期 JSON 中删除联合基础属性来修复线路测试失败。Java 生成器不为联合类型生成基础属性，因此线路测试预期现在排除这些字段以匹配实际 SDK 序列化行为。

3.14.0

(feat): 添加对具有双向通信的 WebSocket 通道的支持。生成的 WebSocket 客户端提供具有指数退避的自动重连、强类型消息处理器和断连期间的消息队列。客户端可通过子包客户端中的工厂方法访问。

1 // 使用路径和查询参数创建 WebSocket 客户端
2 RealtimeWebSocketClient ws = client.realtime().realtimeWebSocket(
3     "session-123",
4     Optional.of("gpt-4"),
5     Optional.of(0)
6 );
7 
8 // 注册处理器并连接
9 ws.onReceive(message -> System.out.println("Received: " + message.getAlpha()));
10 ws.onConnected(() -> System.out.println("Connected!"));
11 ws.connect().get();
12 
13 // 发送类型化消息
14 ws.sendSend(SendEvent.builder()
15     .sendText("Hello WebSocket!")
16     .sendParam(42)
17     .build());