JavaScript SDK

TypeScript 优先的 Node.js SDK，用于连接 Croupier Agent、注册函数并处理调用。

代码位置

• sdks/js

特性

• TypeScript 优先，提供完整类型定义

• 支持现代 Node.js 运行时

• 提供函数描述符与处理器注册能力

• 面向 monorepo 统一协议演进

• 呈现 hints 便捷层（x-ui-* 契约，见 呈现 Hints 契约）：

import { setFieldWidget, setFieldHint } from "croupier-sdk";

let desc = setFieldWidget(
  { id: "player.ban", version: "1.0.0" },
  "id",
  "Select",
);
desc = setFieldHint(desc, "id", "x-options-source", {
  functionId: "player.list",
  labelPath: "/items/*/name",
  valuePath: "/items/*/id",
});

安装

npm install croupier-js-sdk

快速开始

import { CroupierClient } from "croupier-js-sdk";

const client = new CroupierClient({
  agentAddr: "127.0.0.1:19091",
  gameId: "my-game",
  env: "development",
  insecure: true,
});

await client.connect();
await client.serve();

继续阅读

• 指南
• API 参考
• 仓库 README