@huyooo/ones-api

ONES 分服务 vafast API 类型包（与 ones/src/types/api/*.generated.ts 同源约定）。

供 Ones 控制台、SuperX、第三方扩展等共用；契约变更只发本包，不必连带发 CLI。

安装

npm i @huyooo/ones-api
npm i @vafast/api-client   # peer

使用（推荐：默认生产 URL）

大多数租户只打生产，只需提供 appId + getToken：

import { createOnesCoreClients } from '@huyooo/ones-api'

// getToken 由宿主注入（内存 / 安全存储 / sessionStorage 等均可；勿默认等同于 localStorage）
const clients = createOnesCoreClients({
  appId: 'your-app-id',
  getToken: () => getAccessToken(),
})

const { data, error } = await clients.ai.billing.balance.post({})
if (error || data == null) {
  throw new Error(error?.message || '请求失败')
}

本地联调再覆盖 URL：

createOnesCoreClients({
  appId: '...',
  getToken: () => getAccessToken(),
  bases: { ai: 'http://localhost:9007/aiRestfulApi' },
})

也可只用工厂自己装配：createAiApiClient / @huyooo/ones-api/ai。

手动同步（禁止 CI 自动）

本地起好对应服务后：

npm run sync:types   # auth + ones + billing + log + webhook + ai
# 或单独：npm run sync:ai
npm run build

审阅 src/*.generated.ts diff 后再发版：

npm run release

服务列表

| 入口 | 服务 | |---|---| | @huyooo/ones-api | 聚合 OnesClients / OnesCoreClients | | @huyooo/ones-api/ai | ai-server | | @huyooo/ones-api/ones | ones-server | | @huyooo/ones-api/billing | billing-server | | @huyooo/ones-api/auth | auth-server | | @huyooo/ones-api/log | log-server | | @huyooo/ones-api/webhook | webhook-server |