napcat-sdk 0.1.1 → 0.2.0

package/dist/index.d.mts

@@ -1,65 +1,53 @@
-//#region package.d.ts
-declare let name$1: string;
-declare let type: string;
-declare let version$1: string;
-declare let packageManager: string;
-declare let description: string;
-declare let keywords: string[];
-declare let homepage: string;
-declare let files: string[];
-declare namespace bugs {
-  let url: string;
-}
-declare namespace repository {
-  let type_1: string;
-  export { type_1 as type };
-  let url_1: string;
-  export { url_1 as url };
-  export let directory: string;
-}
-declare namespace scripts {
-  let dev: string;
-  let build: string;
-}
-declare let exports: {
-  ".": {
-    require: string;
-    import: string;
-    types: string;
-  };
-  "./package.json": string;
-};
-declare let author: string;
-declare let license: string;
-declare let devDependencies: {
-  "@types/node": string;
-  tsdown: string;
-  typescript: string;
-};
-declare namespace dependencies {
-  let mitt: string;
-}
-declare namespace __json_default_export {
-  export { name$1 as name, type, version$1 as version, packageManager, description, keywords, homepage, files, bugs, repository, scripts, exports, author, license, devDependencies, dependencies };
-}
-//#endregion
 //#region src/logger.d.ts
-type LogLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
+type LogLevel = "fatal" | "error" | "warn" | "info" | "debug" | "trace";
 type Logger = Record<LogLevel, (...args: unknown[]) => void>;
+declare const noop: () => void;
 declare const ABSTRACT_LOGGER: Logger;
 declare const CONSOLE_LOGGER: Logger;
 //#endregion
-//#region src/onebot.d.ts
+//#region src/types.d.ts
+interface MiokiOptions {
+  /** NapCat 访问令牌 */
+  token: string;
+  /** NapCat 服务器协议，默认为 ws */
+  protocol?: "ws" | "wss";
+  /** NapCat 服务器主机，默认为 localhost */
+  host?: string;
+  /** NapCat 服务器端口，默认为 3333 */
+  port?: number;
+  /** 日志记录器，默认为控制台日志记录器 */
+  logger?: Logger;
+}
+type OptionalKeys<T> = { [K in keyof T]-?: {} extends Pick<T, K> ? K : never }[keyof T];
+type OptionalProps<T> = Pick<T, OptionalKeys<T>>;
+type ExtractByType<T, K$1> = T extends {
+  type: K$1;
+} ? T : never;
+interface EventMap extends OneBotEventMap {
+  /** WebSocket 连接已打开 */
+  "ws.open": void;
+  /** WebSocket 连接已关闭 */
+  "ws.close": void;
+  /** WebSocket 连接发生错误 */
+  "ws.error": Event;
+  /** 收到 WebSocket 消息 */
+  "ws.message": any;
+  /** NapCat 连接已建立 */
+  "napcat.connected": {
+    uin: number;
+    ts: number;
+  };
+}
 /**
- * 媒体消息的通用属性
- */
+* 媒体消息的通用属性
+*/
 interface MediaProps {
   /** 媒体文件的 URL 地址 */
   url: string;
   /** 媒体文件的本地路径 */
   path: string;
   /** 媒体文件名或特殊标识 */
-  file: (string & {}) | 'marketface';
+  file: (string & {}) | "marketface";
   /** 媒体文件 ID */
   file_id: string;
   /** 媒体文件大小（字节） */
@@ -69,31 +57,31 @@ interface MediaProps {
 }
 /** 接收的纯文本消息段 */
 interface RecvTextElement {
-  type: 'text';
+  type: "text";
   /** 文本内容 */
   text: string;
 }
 /** 接收的 @ 消息段 */
 interface RecvAtElement {
-  type: 'at';
+  type: "at";
   /** 被 @ 的 QQ 号，'all' 表示 @全体成员 */
-  qq: 'all' | (string & {});
+  qq: "all" | (string & {});
 }
 /** 接收的回复消息段 */
 interface RecvReplyElement {
-  type: 'reply';
+  type: "reply";
   /** 被回复的消息 ID */
   id: string;
 }
 /** 接收的 QQ 表情消息段 */
 interface RecvFaceElement {
-  type: 'face';
+  type: "face";
   /** QQ 表情 ID */
   id: number;
 }
 /** 接收的图片消息段 */
 interface RecvImageElement extends MediaProps {
-  type: 'image';
+  type: "image";
   /** 图片摘要/描述 */
   summary?: string;
   /** 图片子类型 */
@@ -101,43 +89,43 @@ interface RecvImageElement extends MediaProps {
 }
 /** 接收的语音消息段 */
 interface RecvRecordElement extends MediaProps {
-  type: 'record';
+  type: "record";
 }
 /** 接收的视频消息段 */
 interface RecvVideoElement extends MediaProps {
-  type: 'video';
+  type: "video";
 }
 /** 接收的猜拳消息段 */
 interface RecvRpsElement {
-  type: 'rps';
+  type: "rps";
   /** 猜拳结果：1-石头, 2-剪刀, 3-布 */
   result: string;
 }
 /** 接收的掷骰子消息段 */
 interface RecvDiceElement {
-  type: 'dice';
+  type: "dice";
   /** 骰子点数：1-6 */
   result: string;
 }
 /** 接收的窗口抖动消息段（戳一戳） */
 interface RecvShakeElement {
-  type: 'shake';
+  type: "shake";
 }
 /** 接收的戳一戳消息段 */
 interface RecvPokeElement {
-  type: 'poke';
+  type: "poke";
 }
 /** 接收的分享链接消息段 */
 interface RecvShareElement {
-  type: 'share';
+  type: "share";
 }
 /** 接收的位置消息段 */
 interface RecvLocationElement {
-  type: 'location';
+  type: "location";
 }
 /** 接收的合并转发消息段 */
 interface RecvForwardElement {
-  type: 'forward';
+  type: "forward";
   /** 合并转发消息 ID */
   id: string;
   /** 合并转发消息内容 */
@@ -145,48 +133,48 @@ interface RecvForwardElement {
 }
 /** 接收的 JSON 消息段 */
 interface RecvJsonElement {
-  type: 'json';
+  type: "json";
   /** JSON 数据字符串 */
   data: string;
 }
 /** 接收的文件消息段 */
 interface RecvFileElement extends MediaProps {
-  type: 'file';
+  type: "file";
 }
 /** 接收的 Markdown 消息段 */
 interface RecvMarkdownElement {
-  type: 'markdown';
+  type: "markdown";
 }
 /** 接收的小程序消息段 */
 interface RecvLightAppElement {
-  type: 'lightapp';
+  type: "lightapp";
 }
 /**
- * 接收的消息段类型联合
- * @description 表示从 QQ 接收到的所有可能的消息段类型
- */
+* 接收的消息段类型联合
+* @description 表示从 QQ 接收到的所有可能的消息段类型
+*/
 type RecvElement = RecvTextElement | RecvAtElement | RecvReplyElement | RecvFaceElement | RecvImageElement | RecvRecordElement | RecvVideoElement | RecvRpsElement | RecvDiceElement | RecvShakeElement | RecvPokeElement | RecvShareElement | RecvLocationElement | RecvForwardElement | RecvJsonElement | RecvFileElement | RecvMarkdownElement | RecvLightAppElement;
 /** 发送的纯文本消息段 */
 interface SendTextElement {
-  type: 'text';
+  type: "text";
   /** 文本内容 */
   text: string;
 }
 /** 发送的 @ 消息段 */
 interface SendAtElement {
-  type: 'at';
+  type: "at";
   /** 被 @ 的 QQ 号，'all' 表示 @全体成员 */
-  qq: 'all' | (string & {}) | number;
+  qq: "all" | (string & {}) | number;
 }
 /** 发送的回复消息段 */
 interface SendReplyElement {
-  type: 'reply';
+  type: "reply";
   /** 被回复的消息 ID */
   id: string;
 }
 /** 发送的商城表情消息段 */
 interface SendMfaceElement {
-  type: 'mface';
+  type: "mface";
   /** 表情 ID */
   id: number;
   /** 表情 key */
@@ -200,19 +188,19 @@ interface SendMfaceElement {
 }
 /** 发送的 QQ 表情消息段 */
 interface SendFaceElement {
-  type: 'face';
+  type: "face";
   /** QQ 表情 ID */
   id: number;
 }
 /** 发送的大表情消息段 */
 interface SendBfaceElement {
-  type: 'bface';
+  type: "bface";
   /** 大表情 ID */
   id: number;
 }
 /** 发送的图片消息段 */
 interface SendImageElement {
-  type: 'image';
+  type: "image";
   /** 图片文件，支持 file:// / http:// / base64:// 协议 */
   file: string;
   /** 图片文件名 */
@@ -224,7 +212,7 @@ interface SendImageElement {
 }
 /** 发送的视频消息段 */
 interface SendVideoElement {
-  type: 'video';
+  type: "video";
   /** 视频文件，支持 file:// / http:// / base64:// 协议 */
   file: string;
   /** 视频文件名 */
@@ -234,7 +222,7 @@ interface SendVideoElement {
 }
 /** 发送的语音消息段 */
 interface SendRecordElement {
-  type: 'record';
+  type: "record";
   /** 语音文件，支持 file:// / http:// / base64:// 协议 */
   file: string;
   /** 语音文件名 */
@@ -242,29 +230,29 @@ interface SendRecordElement {
 }
 /** 发送的推荐好友/群消息段 */
 interface SendContactElement {
-  type: 'contact';
+  type: "contact";
   /** 推荐类型：qq-好友, group-群 */
-  sub_type: 'qq' | 'group';
+  sub_type: "qq" | "group";
   /** 被推荐的 QQ 号或群号 */
   id: string;
 }
 /** 发送的戳一戳消息段 */
 interface SendPokeElement {
-  type: 'poke';
+  type: "poke";
 }
 /** 发送的音乐分享消息段 - 平台音乐 */
 interface SendPlatformMusicElement {
-  type: 'music';
+  type: "music";
   /** 音乐平台 */
-  platform: 'qq' | '163' | 'kugou' | 'migu' | 'kuwo';
+  platform: "qq" | "163" | "kugou" | "migu" | "kuwo";
   /** 音乐 ID */
   id: string;
 }
 /** 发送的音乐分享消息段 - 自定义音乐 */
 interface SendCustomMusicElement {
-  type: 'music';
+  type: "music";
   /** 自定义音乐标识 */
-  platform: 'custom';
+  platform: "custom";
   /** 跳转链接 URL */
   url: string;
   /** 音频链接 URL */
@@ -280,13 +268,13 @@ interface SendCustomMusicElement {
 type SendMusicElement = SendPlatformMusicElement | SendCustomMusicElement;
 /** 发送的合并转发消息段 */
 interface SendForwardElement {
-  type: 'forward';
+  type: "forward";
   /** 合并转发消息 ID */
   id: string;
 }
 /** 发送的合并转发节点 - 引用已有消息 */
 interface SendNodeRefElement {
-  type: 'node';
+  type: "node";
   /** 发送者 QQ 号（可选） */
   user_id?: string;
   /** 发送者昵称（可选） */
@@ -296,27 +284,25 @@ interface SendNodeRefElement {
 }
 /** 发送的合并转发节点 - 自定义内容 */
 interface SendNodeContentElement {
-  type: 'node';
+  type: "node";
   /** 发送者 QQ 号（可选） */
   user_id?: string;
   /** 发送者昵称（可选） */
   nickname?: string;
   /** 自定义消息内容 */
-  content: Exclude<SendElement, {
-    type: 'node';
-  }>[];
+  content: SendElement[];
 }
 /** 发送的合并转发节点消息段 */
 type SendNodeElement = SendNodeRefElement | SendNodeContentElement;
 /** 发送的 JSON 消息段 */
 interface SendJsonElement {
-  type: 'json';
+  type: "json";
   /** JSON 数据字符串 */
   data: string;
 }
 /** 发送的文件消息段 */
 interface SendFileElement {
-  type: 'file';
+  type: "file";
   /** 文件，支持 file:// / http:// / base64:// 协议 */
   file: string;
   /** 文件名 */
@@ -324,33 +310,56 @@ interface SendFileElement {
 }
 /** 发送的 Markdown 消息段 */
 interface SendMarkdownElement {
-  type: 'markdown';
+  type: "markdown";
 }
 /** 发送的小程序消息段 */
 interface SendLightAppElement {
-  type: 'lightapp';
+  type: "lightapp";
 }
 /**
- * 发送的消息段类型联合
- * @description 表示可以发送给 QQ 的所有可能的消息段类型
- */
+* 发送的消息段类型联合
+* @description 表示可以发送给 QQ 的所有可能的消息段类型
+*/
 type SendElement = SendTextElement | SendAtElement | SendReplyElement | SendMfaceElement | SendFaceElement | SendBfaceElement | SendImageElement | SendVideoElement | SendRecordElement | SendContactElement | SendPokeElement | SendMusicElement | SendForwardElement | SendNodeElement | SendJsonElement | SendFileElement | SendMarkdownElement | SendLightAppElement;
+/**
+* 将消息段类型包装为 OneBot 标准格式
+* @description 将 { type, ...data } 转换为 { type, data: { ...data } } 格式
+*/
+type WrapData<T extends {
+  type: string;
+}> = {
+  type: T["type"];
+  data: Omit<T, "type">;
+};
+/**
+* 将 OneBot 标准格式展开为扁平格式
+* @description 将 { type, data: { ...data } } 转换为 { type, ...data } 格式
+*/
+type FlattenData<T extends {
+  type: string;
+}> = T extends {
+  data: infer U;
+} ? U & {
+  type: T["type"];
+} : never;
+/** 标准化后的发送消息段（OneBot 标准格式） */
+type NormalizedElementToSend = WrapData<SendElement>;
 /** 可发送的消息类型，可以是字符串或消息段 */
 type Sendable = string | SendElement;
 /** 上报事件类型 */
-type PostType = 'meta_event' | 'message' | 'message_sent' | 'notice' | 'request';
+type PostType = "meta_event" | "message" | "message_sent" | "notice" | "request";
 /** 元事件类型 */
-type MetaEventType = 'heartbeat' | 'lifecycle';
+type MetaEventType = "heartbeat" | "lifecycle";
 /** 消息类型 */
-type MessageType = 'private' | 'group';
+type MessageType = "private" | "group";
 /** 通知类型 */
-type NoticeType = 'friend' | 'group' | 'client';
+type NoticeType = "friend" | "group" | "client";
 /** 通知子类型 */
-type NoticeSubType = 'increase' | 'decrease' | 'recall' | 'poke' | 'like' | 'input' | 'admin' | 'ban' | 'title' | 'card' | 'upload' | 'reaction' | 'essence';
+type NoticeSubType = "increase" | "decrease" | "recall" | "poke" | "like" | "input" | "admin" | "ban" | "title" | "card" | "upload" | "reaction" | "essence";
 /**
- * 事件基础类型
- * @description 所有事件的基础结构，包含时间戳、机器人 QQ 号和事件类型
- */
+* 事件基础类型
+* @description 所有事件的基础结构，包含时间戳、机器人 QQ 号和事件类型
+*/
 type EventBase<T extends PostType, U$1 extends object> = U$1 & {
   /** 事件发生的 Unix 时间戳 */
   time: number;
@@ -360,17 +369,17 @@ type EventBase<T extends PostType, U$1 extends object> = U$1 & {
   post_type: T;
 };
 /**
- * 元事件基础类型
- * @description 元事件表示 OneBot 实现本身的状态变化
- */
-type MetaEventBase<T extends MetaEventType, U$1 extends object> = EventBase<'meta_event', U$1 & {
+* 元事件基础类型
+* @description 元事件表示 OneBot 实现本身的状态变化
+*/
+type MetaEventBase<T extends MetaEventType, U$1 extends object> = EventBase<"meta_event", U$1 & {
   meta_event_type: T;
 }>;
 /**
- * 心跳元事件
- * @description 定期发送的心跳事件，用于确认连接状态
- */
-type HeartbeatMetaEvent = MetaEventBase<'heartbeat', {
+* 心跳元事件
+* @description 定期发送的心跳事件，用于确认连接状态
+*/
+type HeartbeatMetaEvent = MetaEventBase<"heartbeat", {
   /** 状态信息 */
   status: {
     /** 是否在线 */
@@ -382,12 +391,12 @@ type HeartbeatMetaEvent = MetaEventBase<'heartbeat', {
   interval: number;
 }>;
 /**
- * 生命周期元事件
- * @description OneBot 实现的生命周期事件
- */
-type LifecycleMetaEvent = MetaEventBase<'lifecycle', {
+* 生命周期元事件
+* @description OneBot 实现的生命周期事件
+*/
+type LifecycleMetaEvent = MetaEventBase<"lifecycle", {
   /** 生命周期子类型 */
-  sub_type: 'connect';
+  sub_type: "connect";
 }>;
 /** 元事件联合类型 */
 type MetaEvent = HeartbeatMetaEvent | LifecycleMetaEvent;
@@ -404,14 +413,16 @@ type ReactionAction = (id: string) => Promise<void>;
 /** 撤回消息的函数类型 */
 type Recall = () => Promise<void>;
 /**
- * 群信息接口
- * @description 包含群的基本信息和常用操作方法
- */
+* 群信息接口
+* @description 包含群的基本信息和常用操作方法
+*/
 interface Group {
   /** 群号 */
   group_id: number;
   /** 群名称 */
   group_name: string;
+  /** NapCat 实例 */
+  napcat: NapCat;
   /** 群签到 */
   doSign: () => Promise<string>;
   /** 获取群信息 */
@@ -442,16 +453,18 @@ interface Group {
   /** 发送群消息 */
   sendMsg: SendMsg;
 }
-type GroupWithInfo = Group & Awaited<ReturnType<Group['getInfo']>>;
+type GroupWithInfo = Group & Awaited<ReturnType<Group["getInfo"]>>;
 /**
- * 好友信息接口
- * @description 包含好友的基本信息和常用操作方法
- */
+* 好友信息接口
+* @description 包含好友的基本信息和常用操作方法
+*/
 interface Friend {
   /** 好友 QQ 号 */
   user_id: number;
   /** 好友昵称 */
   nickname: string;
+  /** NapCat 实例 */
+  napcat: NapCat;
   /** 发送私聊消息 */
   sendMsg: SendMsg;
   /** 删除好友 */
@@ -542,14 +555,16 @@ interface Friend {
     login_days: number;
   }>;
 }
-type FriendWithInfo = Friend & Awaited<ReturnType<Friend['getInfo']>>;
+type FriendWithInfo = Friend & Awaited<ReturnType<Friend["getInfo"]>>;
 /**
- * 消息事件基础类型
- * @description 所有消息事件的基础结构
- */
-type MessageEventBase<T extends MessageType, U$1 extends object> = EventBase<'message', U$1 & {
+* 消息事件基础类型
+* @description 所有消息事件的基础结构
+*/
+type MessageEventBase<T extends MessageType, U$1 extends object> = EventBase<"message", U$1 & {
   /** 消息 ID */
   message_id: number;
+  /** 引用的消息 ID */
+  quote_id: string | null;
   /** 消息类型 */
   message_type: T;
   /** 消息序号 */
@@ -566,18 +581,20 @@ type MessageEventBase<T extends MessageType, U$1 extends object> = EventBase<'me
   reply: Reply;
 }>;
 /**
- * 私聊消息事件
- * @description 包含好友私聊、群临时会话等私聊消息
- */
-type PrivateMessageEvent = MessageEventBase<'private', {
+* 私聊消息事件
+* @description 包含好友私聊、群临时会话等私聊消息
+*/
+type PrivateMessageEvent = MessageEventBase<"private", {
   /** 发送者 QQ 号 */
   user_id: number;
   /** 私聊子类型：friend-好友, group-群临时会话, group_self-群中自己发送, other-其他 */
-  sub_type: 'friend' | 'group' | 'group_self' | 'other';
+  sub_type: "friend" | "group" | "group_self" | "other";
   /** 接收者 QQ 号 */
   target_id: number;
   /** 好友信息对象 */
   friend: Friend;
+  /** 获取引用的消息 */
+  getQuoteMessage: () => Promise<PrivateMessageEvent | null>;
   /** 发送者信息 */
   sender: {
     /** 发送者 QQ 号 */
@@ -587,10 +604,10 @@ type PrivateMessageEvent = MessageEventBase<'private', {
   };
 }>;
 /**
- * 群消息事件
- * @description 群聊中的消息事件
- */
-type GroupMessageEvent = MessageEventBase<'group', {
+* 群消息事件
+* @description 群聊中的消息事件
+*/
+type GroupMessageEvent = MessageEventBase<"group", {
   /** 群号 */
   group_id: number;
   /** 群名称 */
@@ -598,13 +615,19 @@ type GroupMessageEvent = MessageEventBase<'group', {
   /** 发送者 QQ 号 */
   user_id: number;
   /** 群消息子类型：normal-普通消息, notice-通知消息 */
-  sub_type: 'normal' | 'notice';
+  sub_type: "normal" | "notice";
   /** 撤回该消息的方法 */
   recall: Recall;
   /** 添加消息表态的方法 */
   addReaction: ReactionAction;
   /** 删除消息表态的方法 */
   delReaction: ReactionAction;
+  /** 获取引用的消息 */
+  getQuoteMessage: () => Promise<GroupMessageEvent | null>;
+  /** 添加精华消息的方法 */
+  addEssence: () => Promise<void>;
+  /** 删除精华消息的方法 */
+  delEssence: () => Promise<void>;
   /** 群信息对象 */
   group: Group;
   /** 发送者信息 */
@@ -616,33 +639,33 @@ type GroupMessageEvent = MessageEventBase<'group', {
     /** 发送者群名片 */
     card: string;
     /** 发送者群角色：owner-群主, admin-管理员, member-普通成员 */
-    role: 'owner' | 'admin' | 'member';
+    role: "owner" | "admin" | "member";
   };
 }>;
 /** 消息事件联合类型 */
 type MessageEvent = PrivateMessageEvent | GroupMessageEvent;
 /**
- * 将消息事件转换为发送消息事件类型
- * @description 用于表示机器人自己发送的消息事件
- */
-type ToMessageSent<T extends MessageEvent> = Omit<T, 'post_type' | 'group' | 'friend' | 'reply'> & {
-  post_type: 'message_sent';
+* 将消息事件转换为发送消息事件类型
+* @description 用于表示机器人自己发送的消息事件
+*/
+type ToMessageSent<T extends MessageEvent> = Omit<T, "post_type" | "group" | "friend" | "reply"> & {
+  post_type: "message_sent";
 };
 /**
- * 通知事件基础类型
- * @description 所有通知事件的基础结构
- */
-type NoticeEventBase<T extends NoticeType, U$1 extends object> = EventBase<'notice', U$1 & {
+* 通知事件基础类型
+* @description 所有通知事件的基础结构
+*/
+type NoticeEventBase<T extends NoticeType, U$1 extends object> = EventBase<"notice", U$1 & {
   /** 通知类型 */
   notice_type: T;
   /** 原始通知类型 */
   original_notice_type: string;
 }>;
 /**
- * 群通知事件基础类型
- * @description 所有群相关通知事件的基础结构
- */
-type GroupNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeEventBase<'group', U$1 & {
+* 群通知事件基础类型
+* @description 所有群相关通知事件的基础结构
+*/
+type GroupNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeEventBase<"group", U$1 & {
   /** 通知子类型 */
   sub_type: T;
   /** 群号 */
@@ -653,10 +676,10 @@ type GroupNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeE
   group: Group;
 }>;
 /**
- * 好友通知事件基础类型
- * @description 所有好友相关通知事件的基础结构
- */
-type FriendNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeEventBase<'friend', U$1 & {
+* 好友通知事件基础类型
+* @description 所有好友相关通知事件的基础结构
+*/
+type FriendNoticeEventBase<T extends NoticeSubType, U$1 extends object> = NoticeEventBase<"friend", U$1 & {
   /** 通知子类型 */
   sub_type: T;
   /** 相关用户 QQ 号 */
@@ -665,16 +688,16 @@ type FriendNoticeEventBase<T extends NoticeSubType, U$1 extends object> = Notice
   friend: Friend;
 }>;
 /** 好友增加通知事件 */
-type FriendIncreaseNoticeEvent = FriendNoticeEventBase<'increase', {}>;
+type FriendIncreaseNoticeEvent = FriendNoticeEventBase<"increase", {}>;
 /** 好友减少通知事件 */
-type FriendDecreaseNoticeEvent = FriendNoticeEventBase<'decrease', {}>;
+type FriendDecreaseNoticeEvent = FriendNoticeEventBase<"decrease", {}>;
 /** 好友消息撤回通知事件 */
-type FriendRecallNoticeEvent = FriendNoticeEventBase<'recall', {
+type FriendRecallNoticeEvent = FriendNoticeEventBase<"recall", {
   /** 被撤回的消息 ID */
   message_id: number;
 }>;
 /** 好友戳一戳通知事件 */
-type FriendPokeNoticeEvent = FriendNoticeEventBase<'poke', {
+type FriendPokeNoticeEvent = FriendNoticeEventBase<"poke", {
   /** 被戳者 QQ 号 */
   target_id: number;
   /** 发送者 QQ 号 */
@@ -683,7 +706,7 @@ type FriendPokeNoticeEvent = FriendNoticeEventBase<'poke', {
   raw_info: any[];
 }>;
 /** 好友点赞通知事件 */
-type FriendLikeNoticeEvent = FriendNoticeEventBase<'like', {
+type FriendLikeNoticeEvent = FriendNoticeEventBase<"like", {
   /** 操作者 QQ 号 */
   operator_id: number;
   /** 操作者昵称 */
@@ -692,7 +715,7 @@ type FriendLikeNoticeEvent = FriendNoticeEventBase<'like', {
   times: number;
 }>;
 /** 好友输入状态通知事件 */
-type FriendInputNoticeEvent = FriendNoticeEventBase<'input', {
+type FriendInputNoticeEvent = FriendNoticeEventBase<"input", {
   /** 状态文本 */
   status_text: string;
   /** 事件类型 */
@@ -701,54 +724,54 @@ type FriendInputNoticeEvent = FriendNoticeEventBase<'input', {
 /** 好友通知事件联合类型 */
 type FriendNoticeEvent = FriendIncreaseNoticeEvent | FriendDecreaseNoticeEvent | FriendRecallNoticeEvent | FriendPokeNoticeEvent | FriendLikeNoticeEvent | FriendInputNoticeEvent;
 /** 群成员增加通知事件 */
-type GroupIncreaseNoticeEvent = GroupNoticeEventBase<'increase', {
+type GroupIncreaseNoticeEvent = GroupNoticeEventBase<"increase", {
   /** 操作者 QQ 号（如邀请者） */
   operator_id: number;
   /** 加入类型：invite-邀请, add-主动加群, approve-管理员审批 */
-  actions_type: 'invite' | 'add' | 'approve';
+  actions_type: "invite" | "add" | "approve";
 }>;
 /** 群成员减少通知事件 */
-type GroupDecreaseNoticeEvent = GroupNoticeEventBase<'decrease', {
+type GroupDecreaseNoticeEvent = GroupNoticeEventBase<"decrease", {
   /** 操作者 QQ 号 */
   operator_id: number;
   /** 离开类型：kick-被踢, leave-主动退出 */
-  actions_type: 'kick' | 'leave';
+  actions_type: "kick" | "leave";
 }>;
 /** 群管理员变动通知事件 */
-type GroupAdminNoticeEvent = GroupNoticeEventBase<'admin', {
+type GroupAdminNoticeEvent = GroupNoticeEventBase<"admin", {
   /** 操作类型：set-设置管理员, unset-取消管理员 */
-  action_type: 'set' | 'unset';
+  action_type: "set" | "unset";
 }>;
 /** 群禁言通知事件 */
-type GroupBanNoticeEvent = GroupNoticeEventBase<'ban', {
+type GroupBanNoticeEvent = GroupNoticeEventBase<"ban", {
   /** 禁言时长（秒），0 表示解除禁言 */
   duration: number;
   /** 操作类型：ban-禁言, lift_ban-解除禁言 */
-  action_type: 'ban' | 'lift_ban';
+  action_type: "ban" | "lift_ban";
   /** 操作者 QQ 号 */
   operator_id: number;
 }>;
 /** 群名片变动通知事件 */
-type GroupCardNoticeEvent = GroupNoticeEventBase<'card', {
+type GroupCardNoticeEvent = GroupNoticeEventBase<"card", {
   /** 新名片 */
   card_new: string;
   /** 旧名片 */
   card_old: string;
 }>;
 /** 群戳一戳通知事件 */
-type GroupPokeNoticeEvent = GroupNoticeEventBase<'poke', {
+type GroupPokeNoticeEvent = GroupNoticeEventBase<"poke", {
   /** 被戳者 QQ 号 */
   target_id: number;
   /** 原始信息 */
   raw_info: any[];
 }>;
 /** 群头衔变动通知事件 */
-type GroupTitleNoticeEvent = GroupNoticeEventBase<'title', {
+type GroupTitleNoticeEvent = GroupNoticeEventBase<"title", {
   /** 新头衔 */
   title: string;
 }>;
 /** 群文件上传通知事件 */
-type GroupUploadNoticeEvent = GroupNoticeEventBase<'upload', {
+type GroupUploadNoticeEvent = GroupNoticeEventBase<"upload", {
   /** 上传的文件信息 */
   file: {
     /** 文件 ID */
@@ -762,7 +785,7 @@ type GroupUploadNoticeEvent = GroupNoticeEventBase<'upload', {
   };
 }>;
 /** 群消息表态变动通知事件 */
-type GroupReactionNoticeEvent = GroupNoticeEventBase<'reaction', {
+type GroupReactionNoticeEvent = GroupNoticeEventBase<"reaction", {
   /** 相关消息 ID */
   message_id: number;
   /** 表态列表 */
@@ -776,7 +799,7 @@ type GroupReactionNoticeEvent = GroupNoticeEventBase<'reaction', {
   is_add: boolean;
 }>;
 /** 群精华消息变动通知事件 */
-type GroupEssenceNoticeEvent = GroupNoticeEventBase<'essence', {
+type GroupEssenceNoticeEvent = GroupNoticeEventBase<"essence", {
   /** 原消息发送者 QQ 号 */
   sender_id: number;
   /** 相关消息 ID */
@@ -784,10 +807,10 @@ type GroupEssenceNoticeEvent = GroupNoticeEventBase<'essence', {
   /** 操作者 QQ 号 */
   operator_id: number;
   /** 操作类型：add-添加精华, remove-移除精华 */
-  action_type: 'add' | 'remove';
+  action_type: "add" | "remove";
 }>;
 /** 群消息撤回通知事件 */
-type GroupRecallNoticeEvent = GroupNoticeEventBase<'recall', {
+type GroupRecallNoticeEvent = GroupNoticeEventBase<"recall", {
   /** 被撤回的消息 ID */
   message_id: number;
   /** 操作者 QQ 号 */
@@ -798,10 +821,10 @@ type GroupNoticeEvent = GroupIncreaseNoticeEvent | GroupDecreaseNoticeEvent | Gr
 /** 通知事件联合类型 */
 type NoticeEvent = GroupNoticeEvent | FriendNoticeEvent;
 /**
- * 请求事件基础类型
- * @description 所有请求事件的基础结构
- */
-type RequestEventBase<T extends string, U$1 extends object> = EventBase<'request', U$1 & {
+* 请求事件基础类型
+* @description 所有请求事件的基础结构
+*/
+type RequestEventBase<T extends string, U$1 extends object> = EventBase<"request", U$1 & {
   /** 请求类型 */
   request_type: T;
   /** 请求者 QQ 号 */
@@ -812,153 +835,124 @@ type RequestEventBase<T extends string, U$1 extends object> = EventBase<'request
   comment: string;
 }>;
 /** 好友添加请求事件 */
-type FriendRequestEvent = RequestEventBase<'friend', {}>;
+type FriendRequestEvent = RequestEventBase<"friend", {}>;
 /** 加群请求事件（他人申请加入群） */
-type GroupAddRequestEvent = RequestEventBase<'group', {
+type GroupAddRequestEvent = RequestEventBase<"group", {
   /** 群号 */
   group_id: number;
   /** 请求子类型：add-主动加群 */
-  sub_type: 'add';
+  sub_type: "add";
 }>;
 /** 邀请入群请求事件（他人邀请机器人入群） */
-type GroupInviteRequestEvent = RequestEventBase<'group', {
+type GroupInviteRequestEvent = RequestEventBase<"group", {
   /** 群号 */
   group_id: number;
   /** 请求子类型：invite-被邀请 */
-  sub_type: 'invite';
+  sub_type: "invite";
 }>;
 /** 群请求事件联合类型 */
 type GroupRequestEvent = GroupAddRequestEvent | GroupInviteRequestEvent;
 /** 请求事件联合类型 */
 type RequestEvent = FriendRequestEvent | GroupRequestEvent;
 /**
- * OneBot 事件映射表
- * @description 定义了所有事件名称与对应事件类型的映射关系
- */
+* OneBot 事件映射表
+* @description 定义了所有事件名称与对应事件类型的映射关系
+*/
 interface OneBotEventMap {
   /** 元事件，通常与 OneBot 服务端状态相关 */
   meta_event: MetaEvent;
   /** 元事件 - 心跳事件，确认服务端在线状态 */
-  'meta_event.heartbeat': HeartbeatMetaEvent;
+  "meta_event.heartbeat": HeartbeatMetaEvent;
   /** 元事件 - 生命周期，服务端状态变化 */
-  'meta_event.lifecycle': LifecycleMetaEvent;
+  "meta_event.lifecycle": LifecycleMetaEvent;
   /** 元事件 - 生命周期 - 连接成功 */
-  'meta_event.lifecycle.connect': LifecycleMetaEvent;
+  "meta_event.lifecycle.connect": LifecycleMetaEvent;
   /** 消息事件，包含私聊和群消息 */
   message: MessageEvent;
   /** 消息事件 - 私聊消息 */
-  'message.private': PrivateMessageEvent;
+  "message.private": PrivateMessageEvent;
   /** 消息事件 - 私聊消息 - 好友私聊 */
-  'message.private.friend': PrivateMessageEvent;
+  "message.private.friend": PrivateMessageEvent;
   /** 消息事件 - 私聊消息 - 群临时会话 */
-  'message.private.group': PrivateMessageEvent;
+  "message.private.group": PrivateMessageEvent;
   /** 消息事件 - 群消息 */
-  'message.group': GroupMessageEvent;
+  "message.group": GroupMessageEvent;
   /** 消息事件 - 群消息 - 普通消息 */
-  'message.group.normal': GroupMessageEvent;
+  "message.group.normal": GroupMessageEvent;
   message_sent: ToMessageSent<MessageEvent>;
-  'message_sent.private': ToMessageSent<PrivateMessageEvent>;
-  'message_sent.private.friend': ToMessageSent<PrivateMessageEvent>;
-  'message_sent.private.group': ToMessageSent<PrivateMessageEvent>;
-  'message_sent.group': ToMessageSent<GroupMessageEvent>;
-  'message_sent.group.normal': ToMessageSent<GroupMessageEvent>;
+  "message_sent.private": ToMessageSent<PrivateMessageEvent>;
+  "message_sent.private.friend": ToMessageSent<PrivateMessageEvent>;
+  "message_sent.private.group": ToMessageSent<PrivateMessageEvent>;
+  "message_sent.group": ToMessageSent<GroupMessageEvent>;
+  "message_sent.group.normal": ToMessageSent<GroupMessageEvent>;
   /** 请求事件 */
   request: RequestEvent;
   /** 请求事件 - 好友请求 */
-  'request.friend': FriendRequestEvent;
+  "request.friend": FriendRequestEvent;
   /** 请求事件 - 群请求 */
-  'request.group': GroupRequestEvent;
+  "request.group": GroupRequestEvent;
   /** 请求事件 - 他人加群请求，当机器人是群主或管理员时收到 */
-  'request.group.add': GroupAddRequestEvent;
+  "request.group.add": GroupAddRequestEvent;
   /** 请求事件 - 邀请加群请求，他人邀请机器人加入群时收到 */
-  'request.group.invite': GroupInviteRequestEvent;
+  "request.group.invite": GroupInviteRequestEvent;
   /** 通知事件 */
   notice: NoticeEvent;
   /** 通知事件 - 好友相关通知 */
-  'notice.friend': FriendNoticeEvent;
+  "notice.friend": FriendNoticeEvent;
   /** 通知事件 - 好友增加 */
-  'notice.friend.increase': FriendIncreaseNoticeEvent;
+  "notice.friend.increase": FriendIncreaseNoticeEvent;
   /** 通知事件 - 好友减少 */
-  'notice.friend.decrease': FriendDecreaseNoticeEvent;
+  "notice.friend.decrease": FriendDecreaseNoticeEvent;
   /** 通知事件 - 好友备注变更 */
-  'notice.friend.recall': FriendRecallNoticeEvent;
+  "notice.friend.recall": FriendRecallNoticeEvent;
   /** 通知事件 - 好友戳一戳 */
-  'notice.friend.poke': FriendPokeNoticeEvent;
+  "notice.friend.poke": FriendPokeNoticeEvent;
   /** 通知事件 - 好友点赞 */
-  'notice.friend.like': FriendLikeNoticeEvent;
+  "notice.friend.like": FriendLikeNoticeEvent;
   /** 通知事件 - 好友输入状态 */
-  'notice.friend.input': FriendInputNoticeEvent;
+  "notice.friend.input": FriendInputNoticeEvent;
   /** 通知事件 - 群相关通知 */
-  'notice.group': GroupNoticeEvent;
+  "notice.group": GroupNoticeEvent;
   /** 通知事件 - 群成员增加 */
-  'notice.group.increase': GroupIncreaseNoticeEvent;
+  "notice.group.increase": GroupIncreaseNoticeEvent;
   /** 通知事件 - 群成员减少 */
-  'notice.group.decrease': GroupDecreaseNoticeEvent;
+  "notice.group.decrease": GroupDecreaseNoticeEvent;
   /** 通知事件 - 群管理员变更 */
-  'notice.group.admin': GroupAdminNoticeEvent;
+  "notice.group.admin": GroupAdminNoticeEvent;
   /** 通知事件 - 群成员被禁言 */
-  'notice.group.ban': GroupBanNoticeEvent;
+  "notice.group.ban": GroupBanNoticeEvent;
   /** 通知事件 - 群戳一戳 */
-  'notice.group.poke': GroupPokeNoticeEvent;
+  "notice.group.poke": GroupPokeNoticeEvent;
   /** 通知事件 - 群头衔变更 */
-  'notice.group.title': GroupTitleNoticeEvent;
+  "notice.group.title": GroupTitleNoticeEvent;
   /** 通知事件 - 群名片变更 */
-  'notice.group.card': GroupCardNoticeEvent;
+  "notice.group.card": GroupCardNoticeEvent;
   /** 通知事件 - 群公告变更 */
-  'notice.group.recall': GroupRecallNoticeEvent;
+  "notice.group.recall": GroupRecallNoticeEvent;
   /** 通知事件 - 群上传文件 */
-  'notice.group.upload': GroupUploadNoticeEvent;
+  "notice.group.upload": GroupUploadNoticeEvent;
   /** 通知事件 - 给群消息添加反应 Reaction */
-  'notice.group.reaction': GroupReactionNoticeEvent;
+  "notice.group.reaction": GroupReactionNoticeEvent;
   /** 通知事件 - 群精华消息变更 */
-  'notice.group.essence': GroupEssenceNoticeEvent;
+  "notice.group.essence": GroupEssenceNoticeEvent;
 }
 /**
- * OneBot 11 标准 API
- * @description OneBot 11 规范定义的标准 API 接口
- */
-type OneBotAPI = 'delete_friend' | 'delete_msg' | 'get_forward_msg' | 'get_friend_list' | 'get_group_info' | 'get_group_list' | 'get_group_member_info' | 'get_group_member_list' | 'get_group_msg_history' | 'get_login_info' | 'get_msg' | 'get_status' | 'get_stranger_info' | 'send_group_msg' | 'send_private_msg' | 'set_friend_add_request' | 'set_group_add_request' | 'set_group_admin' | 'set_group_ban' | 'set_group_card' | 'set_group_kick' | 'set_group_leave' | 'set_group_name' | 'set_group_portrait' | 'set_group_special_title' | 'set_qq_profile';
+* OneBot 11 标准 API
+* @description OneBot 11 规范定义的标准 API 接口
+*/
+type OneBotAPI = "delete_friend" | "delete_msg" | "get_forward_msg" | "get_friend_list" | "get_group_info" | "get_group_list" | "get_group_member_info" | "get_group_member_list" | "get_group_msg_history" | "get_login_info" | "get_msg" | "get_status" | "get_stranger_info" | "send_group_msg" | "send_private_msg" | "set_friend_add_request" | "set_group_add_request" | "set_group_admin" | "set_group_ban" | "set_group_card" | "set_group_kick" | "set_group_leave" | "set_group_name" | "set_group_portrait" | "set_group_special_title" | "set_qq_profile";
 /**
- * NapCat 扩展 API
- * @description NapCat 实现的额外扩展 API 接口
- */
-type NapCatExtendAPI = '_del_group_notice' | '_get_group_notice' | '_get_model_show' | '_mark_all_as_read' | '_send_group_notice' | '_set_model_show' | '.handle_quick_operation' | '.ocr_image' | 'ArkShareGroup' | 'ArkSharePeer' | 'bot_exit' | 'can_send_image' | 'can_send_record' | 'clean_cache' | 'click_inline_keyboard_button' | 'create_collection' | 'create_group_file_folder' | 'delete_essence_msg' | 'delete_group_file' | 'delete_group_folder' | 'download_file' | 'fetch_custom_face' | 'fetch_emoji_like' | 'forward_friend_single_msg' | 'forward_group_single_msg' | 'friend_poke' | 'get_ai_characters' | 'get_ai_record' | 'get_clientkey' | 'get_collection_list' | 'get_cookies' | 'get_credentials' | 'get_csrf_token' | 'get_doubt_friends_add_request' | 'get_essence_msg_list' | 'get_file' | 'get_friend_msg_history' | 'get_friends_with_category' | 'get_group_at_all_remain' | 'get_group_detail_info' | 'get_group_file_system_info' | 'get_group_file_url' | 'get_group_files_by_folder' | 'get_group_honor_info' | 'get_group_ignored_notifies' | 'get_group_info_ex' | 'get_group_root_files' | 'get_group_shut_list' | 'get_group_system_msg' | 'get_image' | 'get_mini_app_ark' | 'get_online_clients' | 'get_private_file_url' | 'get_profile_like' | 'get_recent_contact' | 'get_record' | 'get_rkey_server' | 'get_rkey' | 'get_robot_uin_range' | 'get_unidirectional_friend_list' | 'get_version_info' | 'group_poke' | 'mark_group_msg_as_read' | 'mark_msg_as_read' | 'mark_private_msg_as_read' | 'move_group_file' | 'nc_get_packet_status' | 'nc_get_rkey' | 'nc_get_user_status' | 'ocr_image' | 'rename_group_file' | 'send_forward_msg' | 'send_group_ai_record' | 'send_group_sign' | 'send_like' | 'send_packet' | 'send_poke' | 'set_diy_online_status' | 'set_essence_msg' | 'set_friend_remark' | 'set_group_add_option' | 'set_group_kick_members' | 'set_group_remark' | 'set_group_robot_add_option' | 'set_group_search' | 'set_group_sign' | 'set_group_whole_ban' | 'set_input_status' | 'set_msg_emoji_like' | 'set_online_status' | 'set_qq_avatar' | 'set_self_longnick' | 'trans_group_file' | 'translate_en2zh' | 'upload_group_file' | 'upload_private_file';
+* NapCat 扩展 API
+* @description NapCat 实现的额外扩展 API 接口
+*/
+type NapCatExtendAPI = "_del_group_notice" | "_get_group_notice" | "_get_model_show" | "_mark_all_as_read" | "_send_group_notice" | "_set_model_show" | ".handle_quick_operation" | ".ocr_image" | "ArkShareGroup" | "ArkSharePeer" | "bot_exit" | "can_send_image" | "can_send_record" | "clean_cache" | "click_inline_keyboard_button" | "create_collection" | "create_group_file_folder" | "delete_essence_msg" | "delete_group_file" | "delete_group_folder" | "download_file" | "fetch_custom_face" | "fetch_emoji_like" | "forward_friend_single_msg" | "forward_group_single_msg" | "friend_poke" | "get_ai_characters" | "get_ai_record" | "get_clientkey" | "get_collection_list" | "get_cookies" | "get_credentials" | "get_csrf_token" | "get_doubt_friends_add_request" | "get_essence_msg_list" | "get_file" | "get_friend_msg_history" | "get_friends_with_category" | "get_group_at_all_remain" | "get_group_detail_info" | "get_group_file_system_info" | "get_group_file_url" | "get_group_files_by_folder" | "get_group_honor_info" | "get_group_ignored_notifies" | "get_group_info_ex" | "get_group_root_files" | "get_group_shut_list" | "get_group_system_msg" | "get_image" | "get_mini_app_ark" | "get_online_clients" | "get_private_file_url" | "get_profile_like" | "get_recent_contact" | "get_record" | "get_rkey_server" | "get_rkey" | "get_robot_uin_range" | "get_unidirectional_friend_list" | "get_version_info" | "group_poke" | "mark_group_msg_as_read" | "mark_msg_as_read" | "mark_private_msg_as_read" | "move_group_file" | "nc_get_packet_status" | "nc_get_rkey" | "nc_get_user_status" | "ocr_image" | "rename_group_file" | "send_forward_msg" | "send_group_ai_record" | "send_group_sign" | "send_like" | "send_packet" | "send_poke" | "set_diy_online_status" | "set_essence_msg" | "set_friend_remark" | "set_group_add_option" | "set_group_kick_members" | "set_group_remark" | "set_group_robot_add_option" | "set_group_search" | "set_group_sign" | "set_group_whole_ban" | "set_input_status" | "set_msg_emoji_like" | "set_online_status" | "set_qq_avatar" | "set_self_longnick" | "trans_group_file" | "translate_en2zh" | "upload_group_file" | "upload_private_file";
 /** 所有可用的 API 接口联合类型 */
 type API = OneBotAPI | NapCatExtendAPI;
 //#endregion
-//#region src/types.d.ts
-interface MiokiOptions {
-  /** NapCat 访问令牌 */
-  token: string;
-  /** NapCat 服务器协议，默认为 ws */
-  protocol?: 'ws' | 'wss';
-  /** NapCat 服务器主机，默认为 localhost */
-  host?: string;
-  /** NapCat 服务器端口，默认为 3333 */
-  port?: number;
-  /** 日志记录器，默认为控制台日志记录器 */
-  logger?: Logger;
-}
-type OptionalKeys<T> = { [K in keyof T]-?: {} extends Pick<T, K> ? K : never }[keyof T];
-type OptionalProps<T> = Pick<T, OptionalKeys<T>>;
-type ExtractByType<T, K$1> = T extends {
-  type: K$1;
-} ? T : never;
-interface EventMap extends OneBotEventMap {
-  /** WebSocket 连接已打开 */
-  'ws.open': void;
-  /** WebSocket 连接已关闭 */
-  'ws.close': void;
-  /** WebSocket 连接发生错误 */
-  'ws.error': Event;
-  /** 收到 WebSocket 消息 */
-  'ws.message': any;
-}
-//#endregion
 //#region src/segment.d.ts
 /**
- * 消息片段构造器
- */
+* 消息片段构造器
+*/
 declare const segment: {
   /** 创建一个文本消息片段 */
   text: (text: string) => SendElement;
@@ -987,6 +981,8 @@ declare const segment: {
   /** 创建一个自定义音乐消息片段 */
   musicCustom: (title: string, audio: string, url: string, options?: Omit<ExtractByType<SendElement, "music">, "type" | "platform" | "url" | "audio" | "title">) => SendElement;
   /** 创建一个合并转发消息片段 */
+  node: (options: Partial<ExtractByType<SendElement, "node">>) => SendElement;
+  /** 创建一个合并转发消息片段 */
   forward: (id: string) => SendElement;
   /** 创建一个 JSON 消息片段 */
   json: (data: string) => SendElement;
@@ -1001,12 +997,6 @@ declare const segment: {
 //#region src/napcat.d.ts
 declare const name: string;
 declare const version: string;
-declare const DEFAULT_NAPCAT_OPTIONS: {
-  protocol: "ws";
-  host: string;
-  port: number;
-  logger: Logger;
-};
 declare class NapCat {
   #private;
   private readonly options;
@@ -1017,44 +1007,109 @@ declare class NapCat {
   get logger(): Logger;
   /** 消息段构建器 */
   get segment(): typeof segment;
+  /**
+  * 机器人 QQ 号
+  */
+  get user_id(): number;
+  /**
+  * 机器人 QQ 号
+  */
+  get uin(): number;
+  /**
+  * 机器人昵称
+  */
+  get nickname(): string;
   /** 获取一个群的信息，可以用于发送群消息等操作 */
-  pickGroup(group_id: number): Promise<GroupWithInfo>;
+  pickGroup(group_id: number): Promise<GroupWithInfo | null>;
   /** 获取一个好友的信息，可以用于发送私聊消息等操作 */
-  pickFriend(user_id: number): Promise<FriendWithInfo>;
+  pickFriend(user_id: number): Promise<FriendWithInfo | null>;
   /**
-   * 注册一次性事件监听器
-   */
+  * 注册一次性事件监听器
+  */
   once<T extends keyof EventMap>(type: T, handler: (event: EventMap[NoInfer<T>]) => void): void;
   /**
-   * 注册事件监听器，支持主类型或者点分子类型
-   *
-   * 如： `notice`、`message.private`、`request.group.invite` 等
-   *
-   * 如果需要移除监听器，请调用 `off` 方法
-   */
+  * 注册事件监听器，支持主类型或者点分子类型
+  *
+  * 如： `notice`、`message.private`、`request.group.invite` 等
+  *
+  * 如果需要移除监听器，请调用 `off` 方法
+  */
   on<T extends keyof EventMap>(type: T, handler: (event: EventMap[NoInfer<T>]) => void): void;
   /**
-   * 移除事件监听器
-   */
+  * 移除事件监听器
+  */
   off<T extends keyof EventMap>(type: T, handler: (event: EventMap[NoInfer<T>]) => void): void;
+  /**
+  * 调用 NapCat API
+  */
   api<T extends any>(action: API | (string & {}), params?: Record<string, any>): Promise<T>;
   /**
-   * 发送私聊消息
-   */
+  * 发送私聊消息
+  */
   sendPrivateMsg(user_id: number, sendable: Sendable | Sendable[]): Promise<{
     message_id: number;
   }>;
   /**
-   * 发送群消息
-   */
+  * 发送群消息
+  */
   sendGroupMsg(group_id: number, sendable: Sendable | Sendable[]): Promise<{
     message_id: number;
   }>;
+  /**
+  * 机器人是否在线
+  */
+  isOnline(): boolean;
+  /**
+  * 计算 GTK 值
+  */
+  getGTk(pskey: string): number;
+  /**
+  * 获取 NapCat 原始 Cookie 相关信息
+  */
+  getNapCatCookies(domain: string): Promise<{
+    cookies: string;
+    bkn: string;
+  }>;
+  /**
+  * 获取版本信息
+  */
+  getVersionInfo(): Promise<{
+    app_name: string;
+    protocol_version: string;
+    app_version: string;
+  }>;
+  /**
+  * 获取登录信息
+  */
+  getLoginInfo(): Promise<{
+    user_id: number;
+    nickname: string;
+  }>;
+  /**
+  * 获取 Cookie 相关信息
+  */
+  getCookie(domain: string): Promise<{
+    uin: number;
+    pskey: string;
+    skey: string;
+    gtk: string;
+    bkn: string;
+    cookie: string;
+    legacyCookie: string;
+  }>;
+  /**
+  * 通过域名获取 Pskey
+  */
+  getPskey(domain: string): Promise<string>;
+  /**
+  * 获取 Bkn 值
+  */
+  getBkn(): Promise<string>;
   /** 启动 NapCat SDK 实例，建立 WebSocket 连接 */
-  bootstrap(): Promise<void>;
+  run(): Promise<void>;
   /** 销毁 NapCat SDK 实例，关闭 WebSocket 连接 */
-  destroy(): Promise<void>;
+  close(): void;
 }
 //#endregion
-export { ABSTRACT_LOGGER, CONSOLE_LOGGER, DEFAULT_NAPCAT_OPTIONS, EventMap, ExtractByType, LogLevel, Logger, MiokiOptions, NapCat, OptionalKeys, OptionalProps, __json_default_export as PKG, name, segment, version };
+export { ABSTRACT_LOGGER, API, CONSOLE_LOGGER, EventBase, EventMap, ExtractByType, FlattenData, Friend, FriendDecreaseNoticeEvent, FriendIncreaseNoticeEvent, FriendInputNoticeEvent, FriendLikeNoticeEvent, FriendNoticeEvent, FriendNoticeEventBase, FriendPokeNoticeEvent, FriendRecallNoticeEvent, FriendRequestEvent, FriendWithInfo, Group, GroupAddRequestEvent, GroupAdminNoticeEvent, GroupBanNoticeEvent, GroupCardNoticeEvent, GroupDecreaseNoticeEvent, GroupEssenceNoticeEvent, GroupIncreaseNoticeEvent, GroupInviteRequestEvent, GroupMessageEvent, GroupNoticeEvent, GroupNoticeEventBase, GroupPokeNoticeEvent, GroupReactionNoticeEvent, GroupRecallNoticeEvent, GroupRequestEvent, GroupTitleNoticeEvent, GroupUploadNoticeEvent, GroupWithInfo, HeartbeatMetaEvent, LifecycleMetaEvent, LogLevel, Logger, MediaProps, MessageEvent, MessageEventBase, MessageType, MetaEvent, MetaEventBase, MetaEventType, MiokiOptions, NapCat, NapCatExtendAPI, NormalizedElementToSend, NoticeEvent, NoticeEventBase, NoticeSubType, NoticeType, OneBotAPI, OneBotEventMap, OptionalKeys, OptionalProps, PostType, PrivateMessageEvent, RecvAtElement, RecvDiceElement, RecvElement, RecvFaceElement, RecvFileElement, RecvForwardElement, RecvImageElement, RecvJsonElement, RecvLightAppElement, RecvLocationElement, RecvMarkdownElement, RecvPokeElement, RecvRecordElement, RecvReplyElement, RecvRpsElement, RecvShakeElement, RecvShareElement, RecvTextElement, RecvVideoElement, RequestEvent, RequestEventBase, SendAtElement, SendBfaceElement, SendContactElement, SendCustomMusicElement, SendElement, SendFaceElement, SendFileElement, SendForwardElement, SendImageElement, SendJsonElement, SendLightAppElement, SendMarkdownElement, SendMfaceElement, SendMusicElement, SendNodeContentElement, SendNodeElement, SendNodeRefElement, SendPlatformMusicElement, SendPokeElement, SendRecordElement, SendReplyElement, SendTextElement, SendVideoElement, Sendable, WrapData, name, noop, segment, version };
 //# sourceMappingURL=index.d.mts.map