@zhin.js/adapter-napcat 1.0.0 → 1.1.0

package/src/types.ts

@@ -1,279 +0,0 @@
-/**
- * NapCat 适配器类型定义
- * 覆盖 OneBot11 标准 + go-cqhttp 扩展 + NapCat 独有 API
- */
-
-// ── 配置 ─────────────────────────────────────────────────────────────
-
-export interface TypingIndicatorConfig {
-  /** 是否启用（默认 true） */
-  enabled?: boolean;
-  /** 默认表情 ID */
-  defaultEmoji?: string;
-  /** 私聊配置 */
-  privateConfig?: { type?: 'message' | 'typing'; message?: string };
-  /** 群聊配置 */
-  groupConfig?: { type?: 'reaction'; emoji?: string };
-}
-
-export interface NapCatConfigBase {
-  context: 'napcat';
-  name: string;
-  access_token?: string;
-  /** Typing Indicator 配置 */
-  typingIndicator?: TypingIndicatorConfig;
-}
-
-/** 正向 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 NapCatBotConfig = 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;
-}

package/src/typing-indicator.ts

@@ -1,184 +0,0 @@
-/**
- * NapCat Typing Indicator 集成
- *
- * 群聊：set_msg_emoji_like（表情回应）
- * 私聊：set_input_status（输入状态）或短暂提示消息
- */
-
-import type { NapCatBotBase } from './bot-base.js';
-import {
-  TypingIndicatorManager,
-  ReactionTypingIndicatorAdapter,
-  type TypingIndicatorOptions,
-  type TypingIndicatorConfig,
-  type TypingIndicator,
-} from '@zhin.js/agent';
-
-export interface NapCatTypingIndicatorConfig {
-  enabled: boolean;
-  defaultEmoji: string;
-  autoRemove: boolean;
-  removeDelay: number;
-  privateConfig?: Partial<TypingIndicatorConfig>;
-  groupConfig?: Partial<TypingIndicatorConfig>;
-}
-
-const DEFAULT_CONFIG: NapCatTypingIndicatorConfig = {
-  enabled: true,
-  defaultEmoji: '128516',
-  autoRemove: true,
-  removeDelay: 5000,
-  privateConfig: {
-    type: 'message',
-    message: '正在思考中...',
-    autoRemove: true,
-    removeDelay: 3000,
-  },
-  groupConfig: {
-    type: 'reaction',
-    emoji: '128516',
-    autoRemove: true,
-    removeDelay: 5000,
-  },
-};
-
-export class NapCatTypingIndicatorManager {
-  private manager: TypingIndicatorManager;
-  private config: NapCatTypingIndicatorConfig;
-  private bot: NapCatBotBase;
-
-  constructor(bot: NapCatBotBase, config: Partial<NapCatTypingIndicatorConfig> = {}) {
-    this.bot = bot;
-    this.config = { ...DEFAULT_CONFIG, ...config };
-    this.manager = new TypingIndicatorManager({
-      type: 'reaction',
-      emoji: this.config.defaultEmoji,
-      autoRemove: this.config.autoRemove,
-      removeDelay: this.config.removeDelay,
-    });
-    this.registerAdapter();
-  }
-
-  private registerAdapter(): void {
-    const adapter = new ReactionTypingIndicatorAdapter(
-      'napcat',
-      async (messageId: string, emoji: string, _options) => {
-        return await this.bot.$addReaction(messageId, emoji);
-      },
-      async (messageId: string, reactionId: string) => {
-        await this.bot.$removeReaction(messageId, reactionId);
-      },
-      async (options: TypingIndicatorOptions, content: string) => {
-        try {
-          if (options.sceneType === 'group' && options.groupId) {
-            return await this.bot.$sendMessage({
-              type: 'group',
-              id: options.groupId,
-              context: 'napcat',
-              bot: this.bot.$id,
-              content: [{ type: 'text', data: { text: content } }],
-            });
-          } else if (options.userId) {
-            return await this.bot.$sendMessage({
-              type: 'private',
-              id: options.userId,
-              context: 'napcat',
-              bot: this.bot.$id,
-              content: [{ type: 'text', data: { text: content } }],
-            });
-          }
-          return null;
-        } catch {
-          return null;
-        }
-      },
-      async (messageId: string) => {
-        try {
-          await this.bot.$recallMessage(messageId);
-        } catch { /* ignore */ }
-      },
-    );
-    this.manager.registerAdapter(adapter);
-  }
-
-  async start(options: {
-    messageId?: string;
-    sessionId: string;
-    userId?: string;
-    groupId?: string;
-    sceneType: 'private' | 'group';
-  }): Promise<TypingIndicator> {
-    this.bot.logger.debug('[NapCat:TypingIndicator] start called', {
-      enabled: this.config.enabled,
-      sceneType: options.sceneType,
-    });
-
-    if (!this.config.enabled) {
-      return {
-        start: async () => {},
-        stop: async () => {},
-        isActive: () => false,
-      };
-    }
-
-    const config = options.sceneType === 'group'
-      ? this.config.groupConfig
-      : this.config.privateConfig;
-
-    const typingOptions: TypingIndicatorOptions = {
-      messageId: options.messageId,
-      sessionId: options.sessionId,
-      userId: options.userId,
-      groupId: options.groupId,
-      platform: 'napcat',
-      botId: this.bot.$id,
-      sceneType: options.sceneType,
-    };
-
-    return await this.manager.start(typingOptions, config);
-  }
-
-  async stop(options: {
-    sessionId: string;
-    userId?: string;
-    groupId?: string;
-  }): Promise<void> {
-    const typingOptions: TypingIndicatorOptions = {
-      sessionId: options.sessionId,
-      userId: options.userId,
-      groupId: options.groupId,
-      platform: 'napcat',
-      botId: this.bot.$id,
-      sceneType: 'private',
-    };
-    await this.manager.stop(typingOptions);
-  }
-
-  async stopAll(): Promise<void> {
-    await this.manager.stopAll();
-  }
-
-  updateConfig(config: Partial<NapCatTypingIndicatorConfig>): void {
-    this.config = { ...this.config, ...config };
-  }
-
-  getConfig(): NapCatTypingIndicatorConfig {
-    return { ...this.config };
-  }
-}
-
-declare module './bot-base.js' {
-  interface NapCatBotBase {
-    $typingIndicator?: NapCatTypingIndicatorManager;
-  }
-}
-
-export function enableTypingIndicator(
-  bot: NapCatBotBase,
-  config?: Partial<NapCatTypingIndicatorConfig>,
-): NapCatTypingIndicatorManager {
-  if (!(bot as any).$typingIndicator) {
-    (bot as any).$typingIndicator = new NapCatTypingIndicatorManager(bot, config);
-  }
-  return (bot as any).$typingIndicator;
-}