@zhin.js/adapter-napcat 3.0.2 → 5.0.0

package/src/endpoint-http.ts

@@ -1,95 +0,0 @@
-/**
- * NapCat HTTP 连接方式
- * 出站：HTTP POST 调用 NapCat API
- * 入站：挂载 webhook 路由接收 NapCat 的 HTTP POST 事件上报
- */
-import { formatCompact } from 'zhin.js';
-import { NapCatEndpointBase } from './endpoint-base.js';
-import type { NapCatHttpConfig, ApiResponse } from './types.js';
-import type { NapCatAdapter } from './adapter.js';
-import { registerFetchRoute, type Router, type RouterContext } from '@zhin.js/host-router/router';
-import * as crypto from 'crypto';
-
-export class NapCatHttpEndpoint extends NapCatEndpointBase {
-  private pollTimer?: NodeJS.Timeout;
-
-  declare $config: NapCatHttpConfig;
-
-  constructor(adapter: NapCatAdapter, public router: Router, config: NapCatHttpConfig) {
-    super(adapter, config);
-  }
-
-  async $connect(): Promise<void> {
-    this.mountWebhook();
-    await this.checkConnection();
-    this.startPoll();
-    this.$connected = true;
-    this.logger.debug(formatCompact({ endpoint: this.$id, mode: 'http' }));
-  }
-
-  async $disconnect(): Promise<void> {
-    if (this.pollTimer) { clearInterval(this.pollTimer); this.pollTimer = undefined; }
-    this.inboundDeduper.clear();
-    this.$connected = false;
-  }
-
-  async callApi<T = any>(action: string, params: Record<string, any> = {}): Promise<T> {
-    const url = `${this.$config.http_url.replace(/\/$/, '')}/${action}`;
-    const headers: Record<string, string> = { 'Content-Type': 'application/json' };
-    if (this.$config.access_token) headers['Authorization'] = `Bearer ${this.$config.access_token}`;
-
-    const resp = await fetch(url, { method: 'POST', headers, body: JSON.stringify(params) });
-    if (!resp.ok) throw new Error(`HTTP ${resp.status} ${resp.statusText} for ${action}`);
-    const json = await resp.json() as ApiResponse<T>;
-    if (json.status !== 'ok' && json.retcode !== 0) {
-      throw new Error(`API error [${json.retcode}]: ${json.message || json.wording || 'unknown'}`);
-    }
-    return json.data;
-  }
-
-  private mountWebhook(): void {
-    const postPath = this.$config.post_path;
-    registerFetchRoute(this.router, 'POST', postPath, async (ctx: RouterContext) => {
-      const body = ctx.request.body;
-      if (!body || typeof body !== 'object') { ctx.status = 400; ctx.body = { error: 'invalid body' }; return; }
-
-      if (this.$config.access_token) {
-        const sig = ctx.get('x-signature');
-        const authHeader = ctx.get('authorization');
-        if (sig) {
-          const expected = 'sha1=' + crypto.createHmac('sha1', this.$config.access_token).update(JSON.stringify(body)).digest('hex');
-          if (sig !== expected) { ctx.status = 403; ctx.body = { error: 'signature mismatch' }; return; }
-        } else if (authHeader) {
-          if (authHeader !== `Bearer ${this.$config.access_token}`) { ctx.status = 403; ctx.body = { error: 'auth failed' }; return; }
-        }
-      }
-
-      ctx.status = 204;
-      ctx.body = '';
-      try { this.dispatchEvent(body); } catch (e) {
-        this.logger.warn(formatCompact( { op: 'recv', endpoint: this.$id, ok: false, error: String(e) }));
-      }
-    });
-    this.logger.debug(formatCompact( { op: 'webhook', endpoint: this.$id, path: postPath }));
-  }
-
-  private async checkConnection(): Promise<void> {
-    try {
-      await this.callApi('get_login_info');
-    } catch (e) {
-      throw new Error(`${this.$id} cannot connect to NapCat HTTP API at ${this.$config.http_url}: ${e}`);
-    }
-  }
-
-  private startPoll(): void {
-    const interval = this.$config.poll_interval || 30000;
-    this.pollTimer = setInterval(async () => {
-      try {
-        await this.callApi('get_status');
-      } catch {
-        this.$connected = false;
-        this.logger.warn(formatCompact( { op: 'heartbeat', endpoint: this.$id, ok: false }));
-      }
-    }, interval);
-  }
-}

package/src/endpoint-ws-client.ts

@@ -1,137 +0,0 @@
-/**
- * NapCat 正向 WebSocket 连接
- */
-import WebSocket from 'ws';
-import { formatCompact } from 'zhin.js';
-import { NapCatEndpointBase } from './endpoint-base.js';
-import type { NapCatWsClientConfig, ApiResponse } from './types.js';
-import type { NapCatAdapter } from './adapter.js';
-
-export class NapCatWsClient extends NapCatEndpointBase {
-  private ws?: WebSocket;
-  private reconnectTimer?: NodeJS.Timeout;
-  private heartbeatTimer?: NodeJS.Timeout;
-  private requestId = 0;
-  private pendingRequests = new Map<string, {
-    resolve: (value: any) => void;
-    reject: (error: Error) => void;
-    timeout: NodeJS.Timeout;
-  }>();
-
-  declare $config: NapCatWsClientConfig;
-
-  constructor(adapter: NapCatAdapter, config: NapCatWsClientConfig) {
-    super(adapter, config);
-  }
-
-  async $connect(): Promise<void> {
-    return new Promise((resolve, reject) => {
-      const headers: Record<string, string> = {};
-      let url = this.$config.url;
-      if (this.$config.access_token) {
-        headers['Authorization'] = `Bearer ${this.$config.access_token}`;
-        const u = new URL(url);
-        u.searchParams.set('access_token', this.$config.access_token);
-        url = u.toString();
-      }
-      this.ws = new WebSocket(url, { headers });
-
-      this.ws.on('open', () => {
-        this.$connected = true;
-        if (!this.$config.access_token) {
-          this.logger.warn(formatCompact({ endpoint: this.$id, ok: false, error: 'missing access_token' }));
-        }
-        this.logger.debug(formatCompact({ endpoint: this.$id, mode: 'ws' }));
-        this.startHeartbeat();
-        resolve();
-      });
-
-      this.ws.on('message', (data) => {
-        try {
-          this.handleWsMessage(JSON.parse(data.toString()));
-        } catch (error) {
-          this.emit('error', error);
-        }
-      });
-
-      this.ws.on('close', (code, reason) => {
-        this.$connected = false;
-        const reasonStr = reason?.toString?.() || '';
-        const codeHint = code === 1005 ? ' [no status]' : code === 1006 ? ' [abnormal]' : '';
-        this.logger.warn(formatCompact( {
-          op: 'disconnect',
-          endpoint: this.$id,
-          code,
-          error: reasonStr || 'closed',
-          reconnect_ms: this.$config.reconnect_interval || 5000,
-        }));
-        reject({ code, reason });
-        this.scheduleReconnect();
-      });
-
-      this.ws.on('error', (error) => {
-        this.logger.warn(formatCompact( {
-          op: 'ws_error',
-          endpoint: this.$id,
-          ok: false,
-          error: error instanceof Error ? error.message : String(error),
-        }));
-        reject(error);
-      });
-    });
-  }
-
-  async $disconnect(): Promise<void> {
-    if (this.reconnectTimer) { clearTimeout(this.reconnectTimer); this.reconnectTimer = undefined; }
-    if (this.heartbeatTimer) { clearInterval(this.heartbeatTimer); this.heartbeatTimer = undefined; }
-    for (const [, req] of this.pendingRequests) { clearTimeout(req.timeout); req.reject(new Error('Connection closed')); }
-    this.pendingRequests.clear();
-    if (this.ws) { this.ws.close(); this.ws = undefined; }
-    this.inboundDeduper.clear();
-    this.$connected = false;
-  }
-
-  async callApi<T = any>(action: string, params: Record<string, any> = {}): Promise<T> {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) throw new Error('WebSocket is not connected');
-    const echo = `req_${++this.requestId}`;
-    return new Promise((resolve, reject) => {
-      const timeout = setTimeout(() => { this.pendingRequests.delete(echo); reject(new Error(`API call timeout: ${action}`)); }, 30000);
-      this.pendingRequests.set(echo, { resolve, reject, timeout });
-      this.ws!.send(JSON.stringify({ action, params, echo }));
-    });
-  }
-
-  private handleWsMessage(message: any): void {
-    if (message.echo && this.pendingRequests.has(message.echo)) {
-      const req = this.pendingRequests.get(message.echo)!;
-      this.pendingRequests.delete(message.echo);
-      clearTimeout(req.timeout);
-      const resp = message as ApiResponse;
-      if (resp.status === 'ok') return req.resolve(resp.data);
-      return req.reject(new Error(`API error [${resp.retcode}]: ${resp.message || resp.wording || 'unknown'}`));
-    }
-    this.dispatchEvent(message);
-  }
-
-  private startHeartbeat(): void {
-    const interval = this.$config.heartbeat_interval || 30000;
-    this.heartbeatTimer = setInterval(() => {
-      if (this.ws && this.ws.readyState === WebSocket.OPEN) this.ws.ping();
-    }, interval);
-  }
-
-  private scheduleReconnect(): void {
-    if (this.reconnectTimer) return;
-    const interval = this.$config.reconnect_interval || 5000;
-    this.reconnectTimer = setTimeout(async () => {
-      this.reconnectTimer = undefined;
-      try { await this.$connect(); } catch { this.scheduleReconnect(); }
-    }, interval);
-  }
-
-  protected handleMeta(event: any): void {
-    if (event.meta_event_type === 'lifecycle' && event.sub_type === 'connect') {
-      this.logger.debug(formatCompact({ endpoint: this.$id, lifecycle: 'connect', self_id: event.self_id }));
-    }
-  }
-}

package/src/endpoint-ws-server.ts

@@ -1,136 +0,0 @@
-/**
- * NapCat 反向 WebSocket 连接
- */
-import WebSocket, { WebSocketServer } from 'ws';
-import { formatCompact } from 'zhin.js';
-import type { IncomingMessage } from 'http';
-import { NapCatEndpointBase } from './endpoint-base.js';
-import type { NapCatWsServerConfig, ApiResponse } from './types.js';
-import type { NapCatAdapter } from './adapter.js';
-import type { Router } from '@zhin.js/host-router';
-
-export class NapCatWsServer extends NapCatEndpointBase {
-  #wss?: WebSocketServer;
-  #clientMap = new Map<string, WebSocket>();
-  private heartbeatTimer?: NodeJS.Timeout;
-  private requestId = 0;
-  private pendingRequests = new Map<string, {
-    resolve: (value: any) => void;
-    reject: (error: Error) => void;
-    timeout: NodeJS.Timeout;
-  }>();
-
-  declare $config: NapCatWsServerConfig;
-
-  constructor(adapter: NapCatAdapter, public router: Router, config: NapCatWsServerConfig) {
-    super(adapter, config);
-  }
-
-  async $connect(): Promise<void> {
-    if (!this.$config.access_token) {
-      this.logger.warn(formatCompact({ endpoint: this.$id, ok: false, error: 'missing access_token' }));
-    }
-    this.#wss = this.router.ws(this.$config.path, {
-      verifyClient: (info: { origin: string; secure: boolean; req: IncomingMessage }) => {
-        const authorization = info.req.headers['authorization'] || '';
-        if (this.$config.access_token && authorization !== `Bearer ${this.$config.access_token}`) {
-          this.logger.error(`[${this.$id}] auth failed`);
-          return false;
-        }
-        return true;
-      },
-    });
-    this.logger.debug(formatCompact( { op: 'listen', endpoint: this.$id, mode: 'wss', path: this.$config.path }));
-
-    this.#wss.on('connection', (client, req) => {
-      this.startHeartbeat();
-      this.logger.debug(formatCompact({ endpoint: this.$id, peer: req.socket.remoteAddress }));
-
-      client.on('error', (err) => this.logger.warn(formatCompact( {
-        op: 'ws_error',
-        endpoint: this.$id,
-        ok: false,
-        error: err instanceof Error ? err.message : String(err),
-      })));
-      client.on('close', (code, reason) => {
-        const reasonStr = reason?.toString?.() || '';
-        this.logger.warn(formatCompact( {
-          op: 'disconnect',
-          endpoint: this.$id,
-          code,
-          error: reasonStr || undefined,
-        }));
-        for (const [key, val] of this.#clientMap) {
-          if (val === client) this.#clientMap.delete(key);
-        }
-        if (this.#clientMap.size === 0) this.$connected = false;
-      });
-      client.on('message', (data) => {
-        try { this.handleWsMessage(client, JSON.parse(data.toString())); } catch (e) { this.emit('error', e); }
-      });
-    });
-  }
-
-  async $disconnect(): Promise<void> {
-    this.#wss?.close();
-    if (this.heartbeatTimer) { clearInterval(this.heartbeatTimer); this.heartbeatTimer = undefined; }
-    for (const [, req] of this.pendingRequests) { clearTimeout(req.timeout); req.reject(new Error('Connection closed')); }
-    this.pendingRequests.clear();
-    this.inboundDeduper.clear();
-    this.$connected = false;
-  }
-
-  async callApi<T = any>(action: string, params: Record<string, any> = {}): Promise<T> {
-    const selfId = this.getFirstSelfId();
-    const client = this.#clientMap.get(selfId);
-    if (!client || client.readyState !== WebSocket.OPEN) throw new Error('WebSocket is not connected');
-    const echo = `req_${++this.requestId}`;
-    return new Promise((resolve, reject) => {
-      const timeout = setTimeout(() => { this.pendingRequests.delete(echo); reject(new Error(`API call timeout: ${action}`)); }, 30000);
-      this.pendingRequests.set(echo, { resolve, reject, timeout });
-      client.send(JSON.stringify({ action, params, echo }));
-    });
-  }
-
-  private getFirstSelfId(): string {
-    const first = this.#clientMap.keys().next().value;
-    if (!first) throw new Error('No NapCat client connected to reverse WS');
-    return first;
-  }
-
-  private handleWsMessage(client: WebSocket, message: any): void {
-    if (message.self_id != null) {
-      const selfIdStr = String(message.self_id);
-      if (!this.#clientMap.has(selfIdStr) || this.#clientMap.get(selfIdStr) !== client) {
-        this.#clientMap.set(selfIdStr, client);
-        if (!this.$connected) this.$connected = true;
-      }
-    }
-    if (message.echo && this.pendingRequests.has(message.echo)) {
-      const req = this.pendingRequests.get(message.echo)!;
-      this.pendingRequests.delete(message.echo);
-      clearTimeout(req.timeout);
-      const resp = message as ApiResponse;
-      if (resp.status === 'ok') return req.resolve(resp.data);
-      return req.reject(new Error(`API error [${resp.retcode}]: ${resp.message || resp.wording || 'unknown'}`));
-    }
-
-    if (message.post_type === 'meta_event' && message.sub_type === 'connect') {
-      this.#clientMap.set(String(message.self_id), client);
-      this.$connected = true;
-      this.logger.debug(formatCompact({ endpoint: this.$id, self_id: message.self_id }));
-      return;
-    }
-    this.dispatchEvent(message);
-  }
-
-  private startHeartbeat(): void {
-    if (this.heartbeatTimer) return;
-    const interval = this.$config.heartbeat_interval || 30000;
-    this.heartbeatTimer = setInterval(() => {
-      for (const client of this.#wss?.clients || []) {
-        if (client.readyState === WebSocket.OPEN) client.ping();
-      }
-    }, interval);
-  }
-}

package/src/routes.ts

@@ -1,61 +0,0 @@
-import type { Router } from '@zhin.js/host-router';
-import type { NapCatAdapter } from './adapter.js';
-
-export function registerRoutes(router: Router, napcat: NapCatAdapter): void {
-  router.get('/api/napcat/endpoints', async (ctx) => {
-    try {
-      const endpoints = Array.from(napcat.endpoints.values());
-      if (endpoints.length === 0) {
-        ctx.body = { success: true, data: [], message: '暂无 NapCat Endpoint 实例' };
-        return;
-      }
-      const result = await Promise.all(
-        endpoints.map(async (endpoint) => {
-          try {
-            const connection = (endpoint.$config as any).connection ?? 'ws';
-            const base: Record<string, unknown> = {
-              name: endpoint.$config.name,
-              connected: endpoint.$connected || false,
-              connection,
-              status: endpoint.$connected ? 'online' : 'offline',
-              lastActivity: new Date().toISOString(),
-            };
-            if (endpoint.$connected) {
-              try {
-                const friends = await endpoint.getFriendList();
-                const groups = await endpoint.getGroupList();
-                base.friendCount = Array.isArray(friends) ? friends.length : 0;
-                base.groupCount = Array.isArray(groups) ? groups.length : 0;
-              } catch {
-                base.friendCount = 0;
-                base.groupCount = 0;
-              }
-            } else {
-              base.friendCount = 0;
-              base.groupCount = 0;
-            }
-            return base;
-          } catch {
-            return {
-              name: endpoint.$config.name,
-              connected: false,
-              connection: 'unknown',
-              status: 'error',
-              friendCount: 0,
-              groupCount: 0,
-            };
-          }
-        }),
-      );
-      ctx.body = { success: true, data: result, timestamp: new Date().toISOString() };
-    } catch (error) {
-      ctx.status = 500;
-      ctx.body = {
-        success: false,
-        error: 'NAPCAT_API_ERROR',
-        message: '获取 Endpoint 数据失败',
-        details: process.env.NODE_ENV === 'development' ? (error as Error).message : undefined,
-      };
-    }
-  });
-}

package/src/segment-mapper.ts

@@ -1 +0,0 @@
-export { toCanonicalSegments, fromCanonicalSegments } from 'zhin.js';

package/src/types.ts

@@ -1,266 +0,0 @@
-/**
- * NapCat 适配器类型定义
- * 覆盖 OneBot11 标准 + go-cqhttp 扩展 + NapCat 独有 API
- */
-
-// ── 配置 ─────────────────────────────────────────────────────────────
-
-export interface NapCatConfigBase {
-  context: 'napcat';
-  name: string;
-  access_token?: string;
-}
-
-/** 正向 WebSocket */
-export interface NapCatWsClientConfig extends NapCatConfigBase {
-  connection: 'ws';
-  url: string;
-  reconnect_interval?: number;
-  heartbeat_interval?: number;
-}
-
-/** 反向 WebSocket */
-export interface NapCatWsServerConfig extends NapCatConfigBase {
-  connection: 'wss';
-  path: string;
-  heartbeat_interval?: number;
-}
-
-/** HTTP API + POST 上报 */
-export interface NapCatHttpConfig extends NapCatConfigBase {
-  connection: 'http';
-  /** NapCat HTTP API 地址，如 http://127.0.0.1:3000 */
-  http_url: string;
-  /** HTTP POST 事件上报接收路径，如 /napcat/post */
-  post_path: string;
-  /** 轮询间隔(ms)，用于 HTTP 心跳检测，默认 30000 */
-  poll_interval?: number;
-}
-
-export type NapCatEndpointConfig = NapCatWsClientConfig | NapCatWsServerConfig | NapCatHttpConfig;
-
-// ── API 响应 ─────────────────────────────────────────────────────────
-
-export interface ApiResponse<T = any> {
-  status: string;
-  retcode: number;
-  data: T;
-  echo?: string;
-  message?: string;
-  wording?: string;
-}
-
-// ── OneBot11 消息段 ──────────────────────────────────────────────────
-
-export interface MessageSegment {
-  type: string;
-  data: Record<string, any>;
-}
-
-// ── OneBot11 事件基础 ────────────────────────────────────────────────
-
-export interface NapCatEvent {
-  post_type: 'message' | 'message_sent' | 'notice' | 'request' | 'meta_event';
-  self_id: number;
-  time: number;
-}
-
-export interface NapCatMessageEvent extends NapCatEvent {
-  post_type: 'message' | 'message_sent';
-  message_type: 'private' | 'group';
-  sub_type: string;
-  message_id: number;
-  user_id: number;
-  group_id?: number;
-  message: MessageSegment[];
-  raw_message: string;
-  font: number;
-  sender: {
-    user_id: number;
-    nickname: string;
-    card?: string;
-    sex?: string;
-    age?: number;
-    area?: string;
-    level?: string;
-    role?: 'owner' | 'admin' | 'member';
-    title?: string;
-  };
-}
-
-export interface NapCatNoticeEvent extends NapCatEvent {
-  post_type: 'notice';
-  notice_type: string;
-  sub_type?: string;
-  group_id?: number;
-  user_id?: number;
-  operator_id?: number;
-  message_id?: number;
-  target_id?: number;
-  file?: { id: string; name: string; size: number; busid: number; url?: string };
-  duration?: number;
-  sender_id?: number;
-  title?: string;
-  action?: string;
-  suffix?: string;
-  comment?: string;
-  flag?: string;
-}
-
-export interface NapCatRequestEvent extends NapCatEvent {
-  post_type: 'request';
-  request_type: 'friend' | 'group';
-  sub_type?: string;
-  user_id: number;
-  group_id?: number;
-  comment?: string;
-  flag: string;
-}
-
-export interface NapCatMetaEvent extends NapCatEvent {
-  post_type: 'meta_event';
-  meta_event_type: string;
-  sub_type?: string;
-  status?: any;
-  interval?: number;
-}
-
-// ── 发送者信息 ───────────────────────────────────────────────────────
-
-export interface SenderInfo {
-  id: string;
-  name: string;
-  role?: 'owner' | 'admin' | 'member';
-  isOwner?: boolean;
-  isAdmin?: boolean;
-  card?: string;
-  title?: string;
-}
-
-// ── API 数据类型 ─────────────────────────────────────────────────────
-
-export interface LoginInfo {
-  user_id: number;
-  nickname: string;
-}
-
-export interface StrangerInfo {
-  user_id: number;
-  nickname: string;
-  sex: string;
-  age: number;
-  qid?: string;
-  level?: number;
-  login_days?: number;
-}
-
-export interface FriendInfo {
-  user_id: number;
-  nickname: string;
-  remark: string;
-}
-
-export interface GroupInfo {
-  group_id: number;
-  group_name: string;
-  group_memo?: string;
-  group_create_time?: number;
-  group_level?: number;
-  member_count: number;
-  max_member_count: number;
-}
-
-export interface GroupMemberInfo {
-  group_id: number;
-  user_id: number;
-  nickname: string;
-  card: string;
-  sex: string;
-  age: number;
-  area: string;
-  join_time: number;
-  last_sent_time: number;
-  level: string;
-  role: 'owner' | 'admin' | 'member';
-  unfriendly: boolean;
-  title: string;
-  title_expire_time: number;
-  card_changeable: boolean;
-  shut_up_timestamp?: number;
-}
-
-export interface MessageInfo {
-  time: number;
-  message_type: string;
-  message_id: number;
-  real_id: number;
-  sender: { user_id: number; nickname: string; card?: string };
-  message: MessageSegment[];
-}
-
-export interface ForwardMessage {
-  messages: Array<{ content: MessageSegment[]; sender: { nickname: string; user_id: number }; time: number }>;
-}
-
-export interface GroupHonorInfo {
-  group_id: number;
-  current_talkative?: { user_id: number; nickname: string; avatar: string; day_count: number };
-  talkative_list?: any[];
-  performer_list?: any[];
-  legend_list?: any[];
-  strong_newbie_list?: any[];
-  emotion_list?: any[];
-}
-
-export interface EssenceMessage {
-  sender_id: number;
-  sender_nick: string;
-  sender_time: number;
-  operator_id: number;
-  operator_nick: string;
-  operator_time: number;
-  message_id: number;
-}
-
-export interface GroupFileSystemInfo {
-  file_count: number;
-  limit_count: number;
-  used_space: number;
-  total_space: number;
-}
-
-export interface GroupFileInfo {
-  files: Array<{ group_id: number; file_id: string; file_name: string; busid: number; file_size: number; upload_time: number; dead_time: number; modify_time: number; download_times: number; uploader: number; uploader_name: string }>;
-  folders: Array<{ group_id: number; folder_id: string; folder_name: string; create_time: number; creator: number; creator_name: string; total_file_count: number }>;
-}
-
-export interface GroupNotice {
-  sender_id: number;
-  publish_time: number;
-  message: { text: string; images?: Array<{ id: string; height: string; width: string }> };
-}
-
-export interface VersionInfo {
-  app_name: string;
-  app_version: string;
-  protocol_version: string;
-  [key: string]: any;
-}
-
-export interface OnlineStatus {
-  status: number;
-  ext_status: number;
-}
-
-export interface AiCharacter {
-  character_id: string;
-  character_name: string;
-  preview_url?: string;
-}
-
-export interface CollectionItem {
-  id: string;
-  type: number;
-  content: string;
-  create_time: number;
-}