用途:iii-node-sdk 是 iii 引擎的 TypeScript/JavaScript SDK,用于把 worker 连接到 iii 引擎,适合在 TypeScript 或 JavaScript 中构建 worker、注册函数、调用触发器。
安装:npm install iii-sdk。完整 API 参考:https://iii.dev/docs/api-reference/sdk-node。
主要能力:registerWorker(url, { workerName }) 连接引擎并返回 iii 客户端;iii.registerFunction(id, handler, options?) 注册本地异步函数处理器;iii.registerFunction(id, httpConfig, options?) 注册由 HTTP 调用的外部函数;iii.registerTrigger({ type, function_id, config, metadata? }) 将触发器绑定到函数;iii.trigger({ function_id, payload, action? }) 调用函数;TriggerAction.Void() 为即发即弃模式,TriggerAction.Enqueue({ queue }) 为持久化异步模式;Logger 提供结构化日志;withSpan、getTracer、getMeter 提供 OpenTelemetry 埋点;iii.createChannel() 支持 worker 间二进制流;iii.createStream(name, adapter) 自定义流;iii.registerTriggerType(id, handler) 注册自定义触发器类型。
RBAC 认证结果字段:为 RBAC worker 实现认证函数时,AuthResult 支持 allowed_functions、forbidden_functions(覆盖 expose_functions)、allowed_trigger_types?、allow_trigger_type_registration、function_registration_prefix?、context。
浏览器环境:请使用 iii-browser-sdk,API 相同但适配浏览器 WebSocket 限制。
相关边界:使用模式与示例见 iii-functions-and-triggers,HTTP 端点见 iii-http-endpoints,HTTP 中间件见 iii-http-middleware,浏览器端见 iii-browser-sdk,Python 见 iii-python-sdk,Rust 见 iii-rust-sdk。
限制:该技能仅适用于 iii 引擎中与 iii-node-sdk 相关的任务,不应作为无关任务的通用回退,也不应在更具体的 iii 技能更合适时使用;应用示例前需先确认环境与安全约束。其余细节暂未提供。