rivetkit-client-javascript

RivetKit JavaScript 客户端技能为开发者提供将 Rivet Actors 集成至浏览器、Node.js 或 Bun 环境的完整指南。它支持与高性能内存内进程进行无缝通讯，促进实时状态管理、远程过程调用 (RPC) 以及双向事件流。对于构建响应式前端界面、服务端后端服务或需要地理分布式 Actor 架构的跨平台应用程序的工程师而言，此技能至关重要。

• 使用 createClient 进行客户端初始化，支持自定义端点与环境变量配置。

• 支持有状态与无状态的 Actor 交互模式，包含自动重连与事件订阅的稳健连接生命周期管理。

• 高级 RPC 能力，支持直接调用动作以及针对特定 Actor 实现的底层 WebSocket 或 HTTP fetch 交互。

• 复杂数据处理功能，通过结构化键值来防止注入攻击，并确保 Actor 实例的安全层级式寻址。

• 支持通过 params 与 getParams 进行动态身份验证与连接参数设置，适用于安全令牌轮替与 JWT 管理。

• 当您需要定义应用程序如何与 Rivet 运行时交互以确保高并发与低延迟时，请使用此技能。

• 请遵循快速失败的错误处理原则以维持应用程序稳定性；利用 ActorError 类针对失败的动作或拒绝的连接获取细部反馈。

• 实现时，请确保正确导入 Actor 注册表，以充分利用 TypeScript 的类型安全性，确保客户端与服务器边界的一致性。

• 请密切留意 onOpen、onClose 与 onStatusChange 等连接生命周期事件，以便在分布式环境中提供灵敏的用户体验。

• 使用提供的后端调用模式，将 RivetKit Actors 与现有的 HTTP 框架（如 Hono、Express 或 Elysia）进行集成。