Web IMLib 快速开始

# 1) 创建应用（已有应用可跳过；返回 appkey 与 appSecret）
curl -sS -X POST "https://im.example.com/api/admin/apps" \
  -H "X-Admin-Secret: dev-admin" -H "content-type: application/json" \
  --data-binary '{"appkey":"demo","name":"Demo"}'

// 2) 注册用户并签发 Token（Node.js 18+；把 APP_SECRET 换成上一步返回的 appSecret）
import { createHash, randomBytes } from 'node:crypto';

const BASE = 'https://im.example.com';
const APP_KEY = 'demo';
const APP_SECRET = process.env.IM_APP_SECRET; // 仅服务端持有

function signedHeaders() {
  const nonce = randomBytes(16).toString('hex');
  const timestamp = Date.now();
  const signature = createHash('sha1').update(`${APP_SECRET}${nonce}${timestamp}`).digest('hex');
  return { 'App-Key': APP_KEY, Nonce: nonce, Timestamp: String(timestamp), Signature: signature, 'content-type': 'application/json' };
}

async function call(path, body) {
  const res = await fetch(`${BASE}/im/v2${path}`, { method: 'POST', headers: signedHeaders(), body: JSON.stringify(body) });
  return res.json();
}

console.log(await call('/user/register', { userId: 'alice', name: 'Alice' }));
const issued = await call('/user/token/issue', { userId: 'alice' });
console.log(issued); // { code: 0, data: { token, expireAt } }

# 方式 A（免构建，推荐）：从文档服务器整目录下载 SDK（rongim.mjs 依赖 src/*.mjs，
# 只下载单个 rongim.mjs 会报 ERR_MODULE_NOT_FOUND: ./src/shared.mjs）
curl -sS -O https://im.example.com/sdk/web/scripts/fetch-dist.mjs
node fetch-dist.mjs --base https://im.example.com/sdk/web --out ./vendor/im-web

# 下载 + 校验完成后直接导入（Node / 浏览器 / 打包器均适用）
# node -e "import('./vendor/im-web/rongim.mjs').then(m => console.log(Object.keys(m).length, 'exports'))"

# 方式 B（直接引用托管路径，浏览器内一行完成）
# <script type="module">
# import { createClient, Events, ConversationType } from '/sdk/web/rongim.mjs';
# </script>

# 方式 C（npm 包，当前未发布到 npm registry；发布后可用）
npm install @ni-paas/im-web

import { createClient } from '@ni-paas/im-web';

const client = createClient({
  appkey: 'YOUR_APP_KEY',
  serverUrl: 'https://im.example.com',
});

import { Events } from '@ni-paas/im-web';

client.addEventListener(Events.CONNECTED, (payload) => console.log('已连接', payload.userId));
client.addEventListener(Events.DISCONNECT, (payload) => console.warn('连接断开', payload.reason));

const res = await client.connect(TOKEN);
if (res.code !== 0) throw new Error(res.msg);

client.addEventListener(Events.MESSAGES, ({ messages }) => {
  for (const message of messages) console.log(message.conversationType, message.content);
});

const sent = await client.sendTextMessage(ConversationType.PRIVATE, 'user2', '你好，NI PaaS');
if (sent.code !== 0) throw new Error(sent.msg);

const conversations = await client.getConversationList();
await client.clearUnreadCount(ConversationType.PRIVATE, 'user2');