Node.js App Server SDK

# 在仓库内（相对路径）
npm install ../ni-paas-im/sdk/server-node

# 或 package.json
# "dependencies": { "@ni-paas-im/server-sdk": "file:../ni-paas-im/sdk/server-node" }

import { AppClient } from '@ni-paas-im/server-sdk';

const app = new AppClient({
  appKey: process.env.IM_APP_KEY,        // 控制台/Admin API 创建应用后获得
  appSecret: process.env.IM_APP_SECRET,  // 只放服务端
  baseUrl: 'http://127.0.0.1:8080',
});

await app.registerUser({ userId: 'alice', name: 'Alice' });
const { token, expireAt } = await app.issueToken({ userId: 'alice' });
const message = await app.sendPrivateMessage({
  fromUserId: 'alice',
  toUserId: 'bob',
  content: { type: 'text', text: 'hello' },
  clientMsgId: 'biz-1',
});

console.log(message.messageId, token.length, expireAt);

// 任意 operationId（路径来自 IDL 生成的 operations.mjs）
const history = await app.openApi('message.history.get', {
  conversationType: 1, targetId: 'bob', userId: 'alice', limit: 20,
});

// 需要 requestId 时用信封版本
const envelope = await app.requestEnvelope('user.get', { userId: 'alice' });
console.log(envelope.code, envelope.requestId);

import { AdminClient } from '@ni-paas-im/server-sdk';

const admin = new AdminClient({
  baseUrl: 'http://127.0.0.1:8080',
  adminSecret: process.env.IM_ADMIN_SECRET,
});

const app = await admin.createApp({ appkey: 'demo2', name: 'Demo 2' }); // appSecret 仅本次返回
await admin.registerUser({ appkey: 'demo2', userId: 'alice', name: 'Alice' });
const users = await admin.listUsers({ appkey: 'demo2', limit: 20 });
await admin.banUser({ appkey: 'demo2', userId: 'alice', banned: true, reason: 'policy' });

// 任意 Admin operation（路径参数自动 URL 编码）
const user = await admin.call('admin.users.get', { pathParams: { appkey: 'demo2', userId: 'alice' } });
console.log(app.appkey, users.total, user.userId);

import { ImApiError } from '@ni-paas-im/server-sdk';

try {
  await app.getUser({ userId: 'ghost' });
} catch (error) {
  if (error instanceof ImApiError && error.code === 1004) {
    console.error(error.codeName, error.requestId); // USER_NOT_FOUND req_xxx
  }
}

health: {"status":200}
admin.createApp: {"appkey":"smoke-1793059388884","secretLength":32}
user.register(alice): {"userId":"alice","name":"Alice","banned":false}
user.token.issue(alice): {"userId":"alice","expireAt":1793664188931,"tokenLength":203}
message.private.publish: {"messageId":"m_1793059388933_aaa452563c45451192bede3cf18f1a34","seq":1}
group.create: {"groupId":"smoke-group","memberCount":2}
message.translate (expected 1021): {"code":1021,"codeName":"SERVICE_NOT_ACTIVATED","msg":"translate service not configured (IM_TRANSLATE_ENDPOINT)"}
admin.users.list: {"total":2,"userIds":["alice","bob"]}
admin.push.deliveries.create: {"requested":1,"sent":0,"status":"no_token"}

# 1) 下载当前契约导出物
curl -sS -o openapi-v1.json http://127.0.0.1:8080/docs/assets/openapi-v1.json

# 2) 3.1 → 3.0（openapi-generator 等仍要求 3.0）
npx openapi-down-convert --input openapi-v1.json --output /tmp/im-openapi-3.0.json

# 3) 以 Java 为例
npx @openapitools/openapi-generator-cli generate \
  -i /tmp/im-openapi-3.0.json -g java -o /tmp/im-java-sdk \
  --additional-properties=library=okhttp-gson,artifactId=im-server-sdk

# Go / PHP / Python 换 -g：go / php / python