Expand description
固定官方 CDP 快照的生成绑定及异步通信核心。
协议描述保留上游原文;生成一致性与 SDK 发布验收分别检查。 普通构建不运行生成器、不读取 schema、不访问网络。
Re-exports§
Modules§
- binding_
support - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 生成绑定共享的版本化序列化基础设施。 生成契约的序列化基础设施;不保存连接或协议域状态。
- generated
- 固定官方输入生成的全部协议域;描述保留上游原文。
Structs§
- Class
Limits - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 每个流量类别的独立资源上限。
- Close
Report - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 共享关闭结果;用户持有的数据和许可不算已回收。
- Connect
Options - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 WebSocket 连接与 TLS 信任选项。 明确 WebSocket endpoint 的连接选项;不含重试、跳过证书验证或重定向设置。
- Connection
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 可 Clone 的连接访问句柄;最后公开访问 lease 消失会请求退出。
- Connection
Key - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 本地连接身份,不写入 wire。
- Error
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 结构化通信错误与请求上下文。 拥有型错误;Clone 共享底层原因及原始帧,协议说明和上下文中的拥有型字符串会复制。
- Event
Envelope - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 已绑定本地 Session 的 typed 事件及连接接收顺序。
- Event
Stream - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 精确 typed 订阅;解码失败仅终结当前流,不影响其他 raw/typed 消费者。
- Finite
F64 - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 有限协议数值。 只持有有限 f64 的协议 number;不提供整数精度或十进制精确性保证。
- Limits
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 连接的有界资源配置;默认值见第 08 篇。
- Method
Name - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 动态命令的已校验方法名,不强制 Domain 语法。
- RawEvent
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 共享原始事件,保留未知 child 来源而不伪造 SessionKey。
- RawEvent
Stream - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 有界原始事件订阅;终态优先于积压数据,Drop 静默退订自身。
- RawJson
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 共享原始 JSON 字节视图。 已验证 JSON 的拥有型视图;Clone 共享原始帧,并延长 SDK 字节许可寿命。 Debug 仅显示长度,避免默认输出协议 payload。
- RawReply
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 原始成功响应;结果共享 backing frame,Drop 最后引用才释放 wire 配额。
- RawRequest
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 动态方法的拥有型冷 Future,与 typed Request 共享准入和取消路径。
- Receive
Seq - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 对每个合法 envelope 递增的连接内接收序号。
- Request
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 拥有参数的冷 typed Future;完成后再次 poll 返回 Pending,Drop 仅取消本地等待。
- Request
Context - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 结构化通信错误与请求上下文。 请求失败时保留的身份与提交证据;不包含参数全文。
- Request
Id - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 运行时分配的正 i32 请求标识,在连接存续期间不复用。
- Request
Options - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 创建请求时固定的本地选项。
- Runtime
Options - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 已建立传输的运行时配置。
- Session
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 异步连接、Session、请求与订阅。 只管理本地 flattened 路由的廉价 Clone 句柄;Drop 不自动 detach。
- Session
Id - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 已校验的拥有型 flattened Session 路由 ID,不是 Target ID。
- Session
Key - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 连接内不可重用的路由身份。
- Subscription
Options - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 单订阅逻辑预算,按完整 backing frame 计字节。
- TlsOptions
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 WebSocket 连接与 TLS 信任选项。 TLS 信任配置;默认使用固定依赖的 webpki 根,不修改全进程 provider。
- Transport
Error - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 完整文本消息传输契约。 传输错误;默认格式不展开可能包含凭据的底层原因。
Enums§
- Connection
State - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 本地连接的单向生命周期。
- Error
Kind - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 结构化通信错误与请求上下文。 可模式匹配的错误类别;未来版本可新增类别。
- Submission
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 请求的保守提交证据,不代表远端是否已经执行。
- Timeout
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 本地合作式期限;不抢占用户同步编解码。
- Traffic
Class - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 相互独立保留容量的流量类别。
- Transport
End - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 传输终止方式,不说明浏览器进程是否退出。
Traits§
- Command
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 命令的编译期描述;序列化与结果解码均在调用者任务执行。
- Event
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 协议身份、选项和静态 marker 契约。 事件的编译期描述;参数在消费者 poll 中解码。
- Message
Reader - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 完整文本消息传输契约。 完整消息读取边界;只有连接终结时运行时才丢弃进行中的操作。
- Message
Writer - 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 完整文本消息传输契约。 唯一 Writer owner 操作的写边界;不得在等待时阻挡 Reader。
- Transport
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 完整文本消息传输契约。 已建立的完整文本消息传输;两个方向必须可以在同一任务独立推进。
Type Aliases§
- Result
- 通用连接、Session、请求和事件契约;与独立 Vendor 绑定使用相同运行时。 结构化通信错误与请求上下文。 通信操作的分类结果;失败不隐含自动重试。