napcat-sdk 0.5.0 → 0.6.0

package/dist/index.mjs

@@ -21,7 +21,7 @@ const CONSOLE_LOGGER = {
 //#endregion
 //#region package.json
 var name$1 = "napcat-sdk";
-var version$1 = "0.5.0";
+var version$1 = "0.6.0";
 
 //#endregion
 //#region src/segment.ts
@@ -100,14 +100,32 @@ var NapCat = class {
 	/** 机器人 ID */
 	#uin = 0;
 	/** 机器人昵称  */
-	#nickname = "-";
+	#nickname = "";
 	/** 机器人状态 */
 	#online = false;
+	/** nickname 缓存 */
+	#nicknameCache = /* @__PURE__ */ new Map();
+	/** 消息数据 */
+	#stat = {
+		start_time: Date.now(),
+		recv: {
+			group: 0,
+			private: 0
+		},
+		send: {
+			group: 0,
+			private: 0
+		}
+	};
 	/** Cookies 缓存 */
 	#cookieCache = /* @__PURE__ */ new Map();
 	constructor(options) {
 		this.options = options;
 	}
+	/** 统计数据 */
+	get stat() {
+		return this.#stat;
+	}
 	/** 配置项 */
 	get #config() {
 		return {
@@ -136,6 +154,8 @@ var NapCat = class {
 	}
 	/**
 	* 机器人 QQ 号
+	*
+	* @deprecated 建议使用 `uin` 属性
 	*/
 	get user_id() {
 		return this.uin;
@@ -158,7 +178,8 @@ var NapCat = class {
 	}
 	/** 构建 WebSocket 连接地址 */
 	#buildWsUrl() {
-		return `${this.#config.protocol}://${this.#config.host}:${this.#config.port}?access_token=${this.#config.token}`;
+		const { protocol, host, port, token } = this.#config;
+		return `${protocol}://${host}:${port}?access_token=${token}`;
 	}
 	/** 包装回复消息 */
 	#wrapReply(sendable, message_id, reply) {
@@ -178,7 +199,7 @@ var NapCat = class {
 		}
 	}
 	/** 标准化可发送消息元素 */
-	#normalizeSendable(msg) {
+	normalizeSendable(msg) {
 		return [msg].flat(2).map((item) => {
 			if (typeof item === "string") return {
 				type: "text",
@@ -216,97 +237,75 @@ var NapCat = class {
 			group_id,
 			group_name,
 			napcat: this,
-			doSign: () => this.api("set_group_sign", { group_id }),
-			getInfo: () => this.api("get_group_info", { group_id }),
-			getMemberList: async () => this.api("get_group_member_list", { group_id }),
-			getMemberInfo: (user_id) => this.api("get_group_member_info", {
-				group_id,
-				user_id
-			}),
-			setTitle: (title) => this.api("set_group_special_title", {
-				group_id,
-				title
-			}),
-			setCard: (user_id, card) => this.api("set_group_card", {
-				group_id,
-				user_id,
-				card
-			}),
-			addEssence: (message_id) => this.api("set_essence_msg", { message_id }),
-			delEssence: (message_id) => this.api("delete_essence_msg", { message_id }),
-			recall: (message_id) => this.api("delete_msg", { message_id }),
-			banMember: (user_id, duration) => this.api("set_group_ban", {
-				group_id,
-				user_id,
-				duration
-			}),
-			sendMsg: (sendable) => this.sendGroupMsg(group_id, sendable)
+			sign: this.setGroupSign.bind(this, group_id),
+			setTitle: this.setGroupSpecialTitle.bind(this, group_id),
+			setCard: this.setGroupCard.bind(this, group_id),
+			setEssence: this.setEssenceMsg.bind(this),
+			delEssence: this.deleteEssenceMsg.bind(this),
+			getInfo: this.getGroupInfo.bind(this, group_id),
+			getMemberList: this.getGroupMemberList.bind(this, group_id),
+			getMemberInfo: this.getGroupMemberInfo.bind(this, group_id),
+			recall: this.recallMsg.bind(this),
+			ban: this.setGroupBan.bind(this, group_id),
+			sendMsg: this.sendGroupMsg.bind(this, group_id)
 		};
 	}
 	/** 构建好友对象 */
 	#buildFriend(user_id, nickname = "", extraInfo = {}) {
+		const name$2 = nickname || this.#nicknameCache.get(user_id) || "";
+		this.#nicknameCache.set(user_id, name$2);
 		return {
 			...extraInfo,
 			user_id,
-			nickname,
+			nickname: name$2,
 			napcat: this,
-			delete: (block, both) => this.api("delete_friend", {
-				user_id,
-				temp_block: block,
-				temp_both_del: both
-			}),
-			sendMsg: (sendable) => this.sendPrivateMsg(user_id, sendable),
-			getInfo: () => this.api("get_stranger_info", { user_id })
+			delete: this.deleteFriend.bind(this, user_id),
+			sendMsg: this.sendPrivateMsg.bind(this, user_id),
+			getInfo: this.getStrangerInfo.bind(this, user_id)
 		};
 	}
+	#transformOneBotMessage(message) {
+		return (message || []).filter((e) => e.type !== "reply").map((el) => ({
+			type: el.type,
+			...el.data
+		}));
+	}
 	/** 构建私聊消息事件 */
 	#buildPrivateMessageEvent(event) {
 		const quote_id = event.message.find((el) => el.type === "reply")?.data?.id || null;
+		if (event.sender.nickname) this.#nicknameCache.set(event.sender.user_id, event.sender.nickname);
+		const target = event.target_id ? {
+			user_id: event.target_id,
+			nickname: this.#nicknameCache.get(event.target_id) || ""
+		} : {
+			user_id: event.sender.user_id,
+			nickname: event.sender.nickname
+		};
 		return {
 			...event,
 			quote_id,
-			getQuoteMessage: async () => {
-				if (!quote_id) return null;
-				const event$1 = await this.api("get_msg", { message_id: quote_id });
-				return this.#buildPrivateMessageEvent(event$1);
-			},
-			message: (event.message || []).filter((e) => e.type !== "reply").map((el) => ({
-				type: el.type,
-				...el.data
-			})),
-			friend: this.#buildFriend(event.user_id, event.sender?.nickname || ""),
-			reply: (sendable, reply = false) => this.sendPrivateMsg(event.user_id, this.#wrapReply(sendable, event.message_id, reply))
+			getQuoteMessage: () => this.getMsg(quote_id),
+			message: this.#transformOneBotMessage(event.message),
+			friend: this.#buildFriend(target.user_id, target.nickname),
+			reply: (sendable, reply = false) => this.sendPrivateMsg(target.user_id, this.#wrapReply(sendable, event.message_id, reply))
 		};
 	}
 	/** 构建群消息事件对象 */
 	#buildGroupMessageEvent(event) {
 		const quote_id = event.message.find((el) => el.type === "reply")?.data?.id || null;
+		if (event.sender.nickname) this.#nicknameCache.set(event.sender.user_id, event.sender.nickname);
 		return {
 			...event,
 			quote_id,
-			getQuoteMessage: async () => {
-				if (!quote_id) return null;
-				const event$1 = await this.api("get_msg", { message_id: quote_id });
-				return this.#buildGroupMessageEvent(event$1);
-			},
-			message: (event.message || []).filter((e) => e.type !== "reply").map((el) => ({
-				type: el.type,
-				...el.data
-			})),
-			group: this.#buildGroup(event.group_id, event.group?.group_name || ""),
-			recall: () => this.api("delete_msg", { message_id: event.message_id }),
-			addReaction: (id) => this.api("set_msg_emoji_like", {
-				message_id: event.message_id,
-				emoji_id: id,
-				set: true
-			}),
-			delReaction: (id) => this.api("set_msg_emoji_like", {
-				message_id: event.message_id,
-				emoji_id: id,
-				set: false
-			}),
-			addEssence: () => this.api("set_essence_msg", { message_id: event.message_id }),
-			delEssence: () => this.api("delete_essence_msg", { message_id: event.message_id }),
+			getQuoteMessage: () => this.getMsg(quote_id),
+			getSenderMemberInfo: this.getGroupMemberInfo.bind(this, event.group_id, event.sender.user_id),
+			message: this.#transformOneBotMessage(event.message),
+			group: this.#buildGroup(event.group_id, event.group_name || ""),
+			recall: this.recallMsg.bind(this, event.message_id),
+			addReaction: this.addReaction.bind(this, event.message_id),
+			delReaction: this.delReaction.bind(this, event.message_id),
+			setEssence: this.setEssenceMsg.bind(this, event.message_id),
+			delEssence: this.deleteEssenceMsg.bind(this, event.message_id),
 			reply: (sendable, reply = false) => this.sendGroupMsg(event.group_id, this.#wrapReply(sendable, event.message_id, reply))
 		};
 	}
@@ -337,41 +336,60 @@ var NapCat = class {
 									app_name,
 									app_version,
 									protocol_version,
-									ts: data.time * 1e3
+									timestamp: data.time * 1e3
 								});
 							}
 							this.#event.emit(`meta_event.${data.meta_event_type}.${data.sub_type}`, data);
 						}
 					}
 					break;
-				case "message":
-					if (data.message_type === "private") data = this.#buildPrivateMessageEvent(data);
-					else data = this.#buildGroupMessageEvent(data);
+				case "message": {
+					if (data.message_type === "private") {
+						this.#stat.recv.private++;
+						data = this.#buildPrivateMessageEvent(data);
+					} else {
+						this.#stat.recv.group++;
+						data = this.#buildGroupMessageEvent(data);
+					}
 					this.#event.emit("message", data);
+					const msg = this.stringifyMessage(data.message);
+					const group = data.group ? `${data.group_name}(${data.group_id})` : "";
+					const sender = `${data.sender.nickname}(${data.sender.user_id})`;
 					switch (data.message_type) {
 						case "private":
-							this.logger.trace(`received private message: ${JSON.stringify(data)}`);
-							this.logger.info(`[P] ${data.sender.nickname}(${data.sender.user_id}): ${this.stringifyMessage(data.message)}`);
 							this.#event.emit("message.private", data);
 							this.#event.emit(`message.private.${data.sub_type}`, data);
+							this.logger.trace(`received private message: ${JSON.stringify(data)}`);
+							this.logger.info(`[私:${sender}] ${msg}`);
 							break;
 						case "group":
-							this.logger.trace(`received group message: ${JSON.stringify(data)}`);
-							this.logger.info(`[G:${data.group_name}:${data.group_id}] ${data.sender.nickname}(${data.sender.user_id}): ${this.stringifyMessage(data.message)}`);
 							this.#event.emit("message.group", data);
 							this.#event.emit(`message.group.${data.sub_type}`, data);
+							this.logger.trace(`received group message: ${JSON.stringify(data)}`);
+							this.logger.info(`[群:${group}] ${sender}: ${msg}`);
 							break;
 						default:
 							this.logger.debug(`received unknown message type: ${JSON.stringify(data)}`);
 							break;
 					}
 					break;
+				}
 				case "message_sent":
-					this.logger.trace(`received message_sent: ${JSON.stringify(data)}`);
+					if (data.message_type === "private") {
+						this.#stat.send.private++;
+						data = this.#buildPrivateMessageEvent(data);
+					} else {
+						this.#stat.send.group++;
+						data = this.#buildGroupMessageEvent(data);
+					}
 					this.#event.emit("message_sent", data);
+					this.logger.trace(`received message_sent: ${JSON.stringify(data)}`);
 					if (data.message_type) {
 						this.#event.emit(`message_sent.${data.message_type}`, data);
 						if (data.sub_type) this.#event.emit(`message_sent.${data.message_type}.${data.sub_type}`, data);
+						const msg = this.stringifyMessage(data.message);
+						if (data.message_type === "group" && data.group_id) this.logger.info(`[>>>:群:${data.group_name}(${data.group_id})] ${msg}`);
+						else this.logger.info(`[>>>:私:${data.friend.nickname}(${data.friend.user_id})] ${msg}`);
 					}
 					break;
 				case "notice": {
@@ -519,12 +537,85 @@ var NapCat = class {
 		return this.#waitForAction(echo);
 	}
 	/**
+	* 获取好友列表
+	*/
+	async getFriendList() {
+		return (await this.api("get_friend_list")).map((f) => this.#buildFriend(f.user_id, f.nickname, f));
+	}
+	/**
+	* 获取群列表
+	*/
+	async getGroupList() {
+		return (await this.api("get_group_list")).map((g) => this.#buildGroup(g.group_id, g.group_name, g));
+	}
+	/**
+	* 添加消息回应
+	*/
+	addReaction(message_id, id) {
+		return this.api("set_msg_emoji_like", {
+			message_id,
+			emoji_id: id,
+			set: true
+		});
+	}
+	/**
+	* 删除消息回应
+	*/
+	delReaction(message_id, id) {
+		return this.api("set_msg_emoji_like", {
+			message_id,
+			emoji_id: id,
+			set: false
+		});
+	}
+	/**
+	* 获取消息
+	*/
+	async getMsg(message_id) {
+		if (!message_id) return null;
+		const msg = await this.api("get_msg", { message_id });
+		if (msg.message_type === "private") return this.#buildPrivateMessageEvent(msg);
+		else return this.#buildGroupMessageEvent(msg);
+	}
+	/**
+	* 删除好友
+	*/
+	deleteFriend(user_id, block = false, both = false) {
+		return this.api("delete_friend", {
+			user_id,
+			temp_block: block,
+			temp_both_del: both
+		});
+	}
+	/**
+	* 设置群成员禁言
+	*/
+	setGroupBan(group_id, user_id, duration) {
+		return this.api("set_group_ban", {
+			group_id,
+			user_id,
+			duration
+		});
+	}
+	/**
+	* 撤回消息
+	*/
+	recallMsg(message_id) {
+		return this.api("delete_msg", { message_id });
+	}
+	/**
+	* 获取陌生人信息
+	*/
+	getStrangerInfo(user_id) {
+		return this.api("get_stranger_info", { user_id });
+	}
+	/**
 	* 发送私聊消息
 	*/
 	sendPrivateMsg(user_id, sendable) {
 		return this.api("send_private_msg", {
 			user_id,
-			message: this.#normalizeSendable(sendable)
+			message: this.normalizeSendable(sendable)
 		});
 	}
 	/**
@@ -533,7 +624,66 @@ var NapCat = class {
 	sendGroupMsg(group_id, sendable) {
 		return this.api("send_group_msg", {
 			group_id,
-			message: this.#normalizeSendable(sendable)
+			message: this.normalizeSendable(sendable)
+		});
+	}
+	/**
+	* 获取群信息
+	*/
+	getGroupInfo(group_id) {
+		return this.api("get_group_info", { group_id });
+	}
+	/**
+	* 群签到
+	*/
+	setGroupSign(group_id) {
+		return this.api("set_group_sign", { group_id });
+	}
+	/**
+	* 设置群精华消息
+	*/
+	setEssenceMsg(message_id) {
+		return this.api("set_essence_msg", { message_id });
+	}
+	/**
+	* 删除群精华消息
+	*/
+	deleteEssenceMsg(message_id) {
+		return this.api("delete_essence_msg", { message_id });
+	}
+	/**
+	* 设置群成员名片
+	*/
+	setGroupCard(group_id, user_id, card) {
+		return this.api("set_group_card", {
+			group_id,
+			user_id,
+			card
+		});
+	}
+	/**
+	* 设置群成员专属头衔
+	*/
+	setGroupSpecialTitle(group_id, user_id, title) {
+		return this.api("set_group_special_title", {
+			group_id,
+			user_id,
+			title
+		});
+	}
+	/**
+	* 获取群成员列表
+	*/
+	getGroupMemberList(group_id) {
+		return this.api("get_group_member_list", { group_id });
+	}
+	/**
+	* 获取群成员信息
+	*/
+	getGroupMemberInfo(group_id, user_id) {
+		return this.api("get_group_member_info", {
+			group_id,
+			user_id
 		});
 	}
 	/**