node-karin 1.9.6 → 1.9.7

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 更新日志
 
+## [1.9.7](https://github.com/KarinJS/Karin/compare/core-v1.9.6...core-v1.9.7) (2025-05-23)
+
+
+### ⚡️ Performance
+
+* 优化事件工具 新增`hasPermission` ([fb1d693](https://github.com/KarinJS/Karin/commit/fb1d693c0af1b90fbf2b9e417ac45ff54a7dab07))
+
 ## [1.9.6](https://github.com/KarinJS/Karin/compare/core-v1.9.5...core-v1.9.6) (2025-05-22)
 
 

package/dist/index.d.ts

@@ -5425,6 +5425,13 @@ declare abstract class BaseEvent<T extends EventParent> {
     get isGroupTemp(): boolean;
     /** 是否为频道私信场景 */
     get isDirect(): boolean;
+    /**
+     * 传入目标权限，返回当前事件触发者是否拥有该权限
+     * @param permission - 目标权限
+     * @param isUpper - 是否向上检查 例如`group:admin`向上检查到`master` 默认`true`
+     * @returns 是否拥有该权限
+     */
+    hasPermission(permission: Permission, isUpper?: boolean): boolean;
 }
 
 /**

package/dist/index.mjs

@@ -6111,6 +6111,55 @@ var init_base2 = __esm({
       get isDirect() {
         return this.#contact.scene === "direct";
       }
+      /**
+       * 传入目标权限，返回当前事件触发者是否拥有该权限
+       * @param permission - 目标权限
+       * @param isUpper - 是否向上检查 例如`group:admin`向上检查到`master` 默认`true`
+       * @returns 是否拥有该权限
+       */
+      hasPermission(permission, isUpper = true) {
+        if (permission === "all") {
+          return true;
+        }
+        if (permission === "master") {
+          return this.isMaster;
+        }
+        if (permission === "admin") {
+          if (isUpper) return this.isMaster || this.isAdmin;
+          return this.isAdmin;
+        }
+        const permissionConfig = {
+          "group.owner": {
+            sceneCheck: () => this.isGroup,
+            roleValue: "owner",
+            includeAdmin: true
+          },
+          "group.admin": {
+            sceneCheck: () => this.isGroup,
+            roleValue: "admin",
+            includeAdmin: true
+          },
+          "guild.owner": {
+            sceneCheck: () => this.isGuild,
+            roleValue: "owner",
+            includeAdmin: true
+          },
+          "guild.admin": {
+            sceneCheck: () => this.isGuild,
+            roleValue: "admin"
+          }
+        };
+        const config3 = permissionConfig[permission];
+        if (!config3) {
+          throw new Error(`\u4E0D\u652F\u6301\u7684\u6743\u9650: ${permission}`);
+        }
+        if (!config3.sceneCheck()) return false;
+        const role = this.sender?.role || "unknown";
+        if (isUpper && config3.includeAdmin) {
+          return this.isMaster || this.isAdmin || role === config3.roleValue;
+        }
+        return role === config3.roleValue;
+      }
     };
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-karin",
-  "version": "1.9.6",
+  "version": "1.9.7",
   "description": "Lightweight, efficient, concise, and stable robot framework.",
   "keywords": [
     "node",