Add QQ bot channel

plugin-src/client/channels/qq/api.js

@@ -0,0 +1,118 @@
+export const QQ_RPC_CHANNEL = '/qq';
+
+export const QQ_ENDPOINTS = Object.freeze({
+  status: 'connection.status',
+  beginProvisioning: 'provision.begin',
+  pollProvisioning: 'provision.poll',
+  cancelProvisioning: 'provision.cancel',
+  reconnectBot: 'bot.reconnect',
+  deleteBot: 'bot.delete',
+});
+
+const PROVISION_STATES = new Set(['starting', 'pending', 'refreshing', 'connecting', 'connected', 'failed', 'cancelled']);
+const ACCOUNT_STATES = new Set(['connected', 'connecting', 'offline', 'error']);
+const QR_DATA_URL = /^data:image\/(?:png|webp);base64,[a-z\d+/]+={0,2}$/i;
+
+function isRecord(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function text(value, fallback, max = 240) {
+  return typeof value === 'string' && value.trim() ? value.trim().slice(0, max) : fallback;
+}
+
+function id(value) {
+  const result = text(value, '', 128);
+  return /^[a-z\d_-]+$/i.test(result) ? result : undefined;
+}
+
+function timestamp(value) {
+  if (typeof value === 'number' && Number.isFinite(value)) return value;
+  const parsed = typeof value === 'string' ? Date.parse(value) : Number.NaN;
+  return Number.isNaN(parsed) ? undefined : parsed;
+}
+
+export function unwrapRpcResult(result) {
+  if (!isRecord(result) || typeof result.ok !== 'boolean') throw new Error('QQ 服务返回了无法识别的响应');
+  if (!result.ok) {
+    const error = new Error(text(result.error?.message, 'QQ 操作失败'));
+    error.code = text(result.error?.code, 'QQ_RPC_ERROR', 80);
+    throw error;
+  }
+  return result.value;
+}
+
+export function safeQrSource(value) {
+  return typeof value === 'string' && value.length <= 2 * 1024 * 1024 && QR_DATA_URL.test(value)
+    ? value : undefined;
+}
+
+export function normalizeProvisioning(value, now = Date.now()) {
+  const source = isRecord(value?.provisioning) ? value.provisioning : value;
+  if (!isRecord(source)) throw new Error('QQ 服务没有返回扫码绑定进度');
+  const attemptId = id(source.attemptId);
+  if (!attemptId) throw new Error('QQ 扫码服务没有返回有效的绑定任务');
+  const reported = text(source.status, 'failed', 32);
+  const result = {
+    attemptId,
+    status: PROVISION_STATES.has(reported) ? reported : 'failed',
+    expiresAt: timestamp(source.expiresAt) ?? now + 5 * 60_000,
+    pollIntervalMs: Math.min(10_000, Math.max(500, Number(source.pollIntervalMs) || 1_000)),
+    qrRevision: Number.isSafeInteger(source.qrRevision) ? source.qrRevision : 0,
+  };
+  const qrCodeDataUrl = safeQrSource(source.qrCodeDataUrl);
+  if (qrCodeDataUrl) result.qrCodeDataUrl = qrCodeDataUrl;
+  if (id(source.botId)) result.botId = id(source.botId);
+  if (isRecord(source.error)) result.error = {
+    code: text(source.error.code, 'QQ_PROVISION_FAILED', 80),
+    message: text(source.error.message, 'QQ 机器人没有接入完成'),
+  };
+  return result;
+}
+
+function normalizeBot(value) {
+  if (!isRecord(value) || !id(value.botId)) return undefined;
+  const connected = value.connected === true;
+  const state = ACCOUNT_STATES.has(value.state) ? value.state : 'offline';
+  return {
+    botId: id(value.botId),
+    connected,
+    state: connected ? 'connected' : state,
+    bot: {
+      name: text(value.bot?.name, 'QQ机器人', 100),
+      appIdMasked: text(value.bot?.appIdMasked, '应用标识已安全保存', 140),
+    },
+    health: {
+      summary: text(value.health?.summary, connected ? 'QQ WebSocket 长连接运行正常' : 'QQ 连接尚未就绪'),
+      lastCheckedAt: timestamp(value.health?.lastCheckedAt),
+    },
+    error: isRecord(value.error) ? {
+      code: text(value.error.code, 'QQ_ACCOUNT_ERROR', 80),
+      message: text(value.error.message, 'QQ 连接尚未就绪'),
+    } : null,
+  };
+}
+
+export function normalizeSnapshot(value) {
+  const source = isRecord(value?.snapshot) ? value.snapshot : value;
+  if (!isRecord(source) || !Array.isArray(source.bots)) throw new Error('QQ 服务没有返回有效的机器人列表');
+  const bots = source.bots.map(normalizeBot).filter(Boolean);
+  return {
+    revision: Number.isSafeInteger(source.revision) ? source.revision : 0,
+    bots,
+    totals: { configured: bots.length, connected: bots.filter((bot) => bot.connected).length },
+    provisioning: source.provisioning ? normalizeProvisioning(source.provisioning) : null,
+  };
+}
+
+export function presentError(error) {
+  return {
+    code: text(error?.code, 'QQ_ERROR', 80),
+    message: text(error?.message, 'QQ 操作失败，请稍后重试'),
+  };
+}
+
+export function formatRemaining(milliseconds) {
+  const seconds = Math.max(0, Math.ceil(Number(milliseconds) / 1_000) || 0);
+  return `${String(Math.floor(seconds / 60)).padStart(2, '0')}:${String(seconds % 60).padStart(2, '0')}`;
+}