mirai-js 2.2.0 → 2.3.0

package/dist/node/Bot.js

@@ -35,6 +35,8 @@ const _getMemberInfo = require('./core/getMemberInfo');
 
 const _setMemberInfo = require('./core/setMemberInfo');
 
+const _setMemberAdmin = require('./core/setMemberAdmin');
+
 const _recall = require('./core/recall');
 
 const _mute = require('./core/mute');
@@ -47,6 +49,8 @@ const _unmuteAll = require('./core/unmuteAll');
 
 const _removeMember = require('./core/removeMember');
 
+const _removeFriend = require('./core/removeFriend');
+
 const _quitGroup = require('./core/quitGroup');
 
 const _getGroupConfig = require('./core/getGroupConfig');
@@ -953,6 +957,8 @@ class Bot extends BotConfigGetable {
    * @param {number} qq    必选，群成员的 qq 号
    * @param {string} name  可选，要设置的群名片
    * @param {string} title 可选，要设置的群头衔
+   * @param {boolean} permission 可选，要设置的权限，
+   * 使用枚举值：Bot.Permission.Admin, Bot.Permission.Member
    * @returns {void}
    */
 
@@ -961,7 +967,8 @@ class Bot extends BotConfigGetable {
     group,
     qq,
     name,
-    title
+    title,
+    permission
   }) {
     // 检查对象状态
     if (!this.config) {
@@ -974,21 +981,39 @@ class Bot extends BotConfigGetable {
         group,
         qq
       })} 参数`);
-    } // 获取列表
+    }
+
+    if (permission != undefined && permission != Bot.groupPermission.ADMINISTRATOR && permission != Bot.groupPermission.MEMBER) {
+      throw new Error('setMemberInfo admin 参数只能是 Bot.groupPermission.ADMINISTRATOR 或 Bot.groupPermission.Member');
+    } // setMemberInfo
 
 
     const {
       baseUrl,
       sessionKey
     } = this.config;
-    await _setMemberInfo({
-      baseUrl,
-      sessionKey,
-      target: group,
-      memberId: qq,
-      name,
-      specialTitle: title
-    });
+
+    if (name != undefined || title != undefined) {
+      await _setMemberInfo({
+        baseUrl,
+        sessionKey,
+        target: group,
+        memberId: qq,
+        name,
+        specialTitle: title
+      });
+    } // setPermission
+
+
+    if (permission != undefined) {
+      await _setMemberAdmin({
+        baseUrl,
+        sessionKey,
+        target: group,
+        memberId: qq,
+        assign: permission == Bot.groupPermission.ADMINISTRATOR ? true : false
+      });
+    }
   }
   /**
    * @description 禁言群成员
@@ -1170,6 +1195,37 @@ class Bot extends BotConfigGetable {
       msg: message
     });
   }
+  /**
+   * @description 删除好友
+   * @param {*} qq 欲删除的好友 qq 号
+   * @returns {void}
+   */
+
+
+  async removeFriend({
+    qq
+  }) {
+    // 检查对象状态
+    if (!this.config) {
+      throw new Error('removeFriend 请先调用 open，建立一个会话');
+    } // 检查参数
+
+
+    if (!qq) {
+      throw new Error('removeFriend 缺少必要的 qq 参数');
+    }
+
+    const {
+      baseUrl,
+      sessionKey
+    } = this.config; // 删除好友
+
+    await _removeFriend({
+      baseUrl,
+      sessionKey,
+      target: qq
+    });
+  }
   /**
    * @description 移除群成员
    * @param {number} group   必选，欲移除的成员所在群号
@@ -1180,7 +1236,7 @@ class Bot extends BotConfigGetable {
   async quitGroup({
     group
   }) {
-    // 检查对象状态
+    // 检查对象状态 
     if (!this.config) {
       throw new Error('quitGroup 请先调用 open，建立一个会话');
     } // 检查参数

package/dist/node/FileManager.js

@@ -18,7 +18,7 @@ class FileManager {
 
     this._getGroupFileList = ({
       dir
-    }) => require('./core/getGroupFileList')({
+    }) => require('./core/fs/getGroupFileList')({
       baseUrl,
       sessionKey,
       target: group,
@@ -27,7 +27,7 @@ class FileManager {
 
     this._getGroupFileInfo = ({
       id
-    }) => require('./core/getGroupFileInfo')({
+    }) => require('./core/fs/getGroupFileInfo')({
       baseUrl,
       sessionKey,
       target: group,
@@ -38,7 +38,7 @@ class FileManager {
       type,
       path,
       file
-    }) => require('./core/uploadFileAndSend')({
+    }) => require('./core/fs/uploadGroupFIle')({
       baseUrl,
       sessionKey,
       type,
@@ -49,17 +49,26 @@ class FileManager {
 
     this._groupFileDelete = ({
       id
-    }) => require('./core/groupFileDelete')({
+    }) => require('./core/fs/deleteGroupFile')({
       baseUrl,
       sessionKey,
       target: group,
       id
     });
 
+    this._makeGroupDir = ({
+      dir
+    }) => require('./core/fs/makeGroupDir')({
+      baseUrl,
+      sessionKey,
+      target: group,
+      dir
+    });
+
     this._groupFileRename = ({
       id,
       rename
-    }) => require('./core/groupFileRename')({
+    }) => require('./core/fs/renameGroupFile')({
       baseUrl,
       sessionKey,
       target: group,
@@ -70,7 +79,7 @@ class FileManager {
     this._groupFileMove = ({
       id,
       movePath
-    }) => require('./core/groupFileMove')({
+    }) => require('./core/fs/moveGroupFile')({
       baseUrl,
       sessionKey,
       target: group,

package/dist/node/core/auth.js

@@ -17,6 +17,10 @@ if (!process.browser) {
 }
 
 const errorHandler = require('../util/errorHandler');
+
+const path = require('path');
+
+const locationStr = `core.${path.basename(__filename, path.extname(__filename))}`;
 /**
  *
  * @description 认证 verifyKey，创建回话，返回一个 sessionKey
@@ -25,7 +29,6 @@ const errorHandler = require('../util/errorHandler');
  * @returns {string} 会话标识 sessionKey
  */
 
-
 module.exports = async ({
   baseUrl,
   verifyKey
@@ -47,7 +50,7 @@ module.exports = async ({
         }
       } = responseData;
     } catch (error) {
-      throw new Error('core.auth 请求返回格式出错，请检查 mirai-console');
+      throw new Error('请求返回格式出错，请检查 mirai-console');
     } // 抛出 mirai 的异常，到 catch 中处理后再抛出
 
 
@@ -57,6 +60,7 @@ module.exports = async ({
 
     return sessionKey;
   } catch (error) {
+    console.error(`mirai-js: error ${locationStr}`);
     errorHandler(error);
   }
 };

package/dist/node/core/fs/deleteGroupFile.js

@@ -0,0 +1,77 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios');
+
+let URL;
+
+if (!process.browser) {
+  ({
+    URL
+  } = require('url'));
+} else {
+  URL = window.URL;
+}
+
+const errorHandler = require('../../util/errorHandler');
+
+const path = require('path');
+
+const locationStr = `core.${path.basename(__filename, path.extname(__filename))}`;
+/**
+ * @description 删除群文件
+ * @param {string}  baseUrl          mirai-api-http server 的地址
+ * @param {string}  sessionKey       会话标识
+ * @param {string}  id               文件夹id, 空串为根目录
+ * @param {string}  path             文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group            群号
+ * @returns {Object} 结构 { message, code }
+ */
+
+module.exports = async ({
+  baseUrl,
+  sessionKey,
+  id,
+  path,
+  group
+}) => {
+  try {
+    // 拼接 url
+    const url = new URL('/file/delete', baseUrl).toString(); // 请求
+
+    const responseData = await axios.post(url, {
+      sessionKey,
+      id,
+      path,
+      target: group,
+      group
+    });
+
+    try {
+      var {
+        data: {
+          msg: message,
+          code
+        }
+      } = responseData;
+    } catch (error) {
+      throw new Error('请求返回格式出错，请检查 mirai-console');
+    } // 抛出 mirai 的异常，到 catch 中处理后再抛出
+
+
+    if (code in errCodeMap) {
+      throw new Error(message);
+    }
+
+    return {
+      message,
+      code
+    };
+  } catch (error) {
+    console.error(`mirai-js: error ${locationStr}`);
+    errorHandler(error);
+  }
+};

package/dist/node/core/fs/getGroupFileInfo.js

@@ -0,0 +1,83 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios').default;
+
+let URL;
+
+if (!process.browser) {
+  ({
+    URL
+  } = require('url'));
+} else {
+  URL = window.URL;
+}
+
+const errorHandler = require('../../util/errorHandler');
+
+const path = require('path');
+
+const locationStr = `core.${path.basename(__filename, path.extname(__filename))}`;
+/**
+ * @description 获取群文件详细信息
+ * @param {string}  baseUrl          mirai-api-http server 的地址
+ * @param {string}  sessionKey       会话标识
+ * @param {string}  id               文件夹id, 空串为根目录
+ * @param {string}  path             文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group            群号
+ * @param {boolean} withDownloadInfo 是否携带下载信息，额外请求，无必要不要携带
+ * @returns {Object}   
+ * 结构 { id, name, path, parent, contact, isFile, isDirectory, downloadInfo }
+ */
+
+module.exports = async ({
+  baseUrl,
+  sessionKey,
+  id,
+  path,
+  group
+  /*, qq 字段保留 */
+  ,
+  withDownloadInfo
+}) => {
+  try {
+    // 拼接 url
+    const url = new URL('/file/info', baseUrl).toString(); // 请求
+
+    const responseData = await axios.get(url, {
+      params: {
+        sessionKey,
+        id,
+        path,
+        target: group,
+        group,
+        withDownloadInfo
+      }
+    });
+
+    try {
+      var {
+        data: {
+          msg: message,
+          code,
+          data
+        }
+      } = responseData;
+    } catch (error) {
+      throw new Error('请求返回格式出错，请检查 mirai-console');
+    } // 抛出 mirai 的异常，到 catch 中处理后再抛出
+
+
+    if (code in errCodeMap) {
+      throw new Error(message);
+    }
+
+    return data;
+  } catch (error) {
+    console.error(`mirai-js: error ${locationStr}`);
+    errorHandler(error);
+  }
+};

package/dist/node/core/fs/getGroupFileList.js

@@ -0,0 +1,88 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios').default;
+
+let URL;
+
+if (!process.browser) {
+  ({
+    URL
+  } = require('url'));
+} else {
+  URL = window.URL;
+}
+
+const errorHandler = require('../../util/errorHandler');
+
+const path = require('path');
+
+const locationStr = `core.${path.basename(__filename, path.extname(__filename))}`;
+/**
+ * @description 获取群文件列表
+ * @param {string}  baseUrl          mirai-api-http server 的地址
+ * @param {string}  sessionKey       会话标识
+ * @param {string}  id               文件夹id, 空串为根目录
+ * @param {string}  path             文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group            群号
+ * @param {boolern} withDownloadInfo 是否携带下载信息，额外请求，无必要不要携带
+ * @param {number}  offset	         分页偏移
+ * @param {number}  size	         分页大小
+ * @returns {Object[]}   结构 array[...{ id, name, path, parent, contact, isFile, isDirectory, downloadInfo }]
+ */
+
+module.exports = async ({
+  baseUrl,
+  sessionKey,
+  id,
+  path,
+  group
+  /*, qq 字段保留 */
+  ,
+  withDownloadInfo,
+  offset,
+  size
+}) => {
+  try {
+    // 拼接 url
+    const url = new URL('/file/list', baseUrl).toString(); // 请求
+
+    const responseData = await axios.get(url, {
+      params: {
+        sessionKey,
+        id,
+        path,
+        target: group,
+        group,
+        withDownloadInfo,
+        offset,
+        size
+      }
+    });
+
+    try {
+      var {
+        data: {
+          msg: message,
+          code,
+          data
+        }
+      } = responseData;
+    } catch (error) {
+      throw new Error('请求返回格式出错，请检查 mirai-console');
+    } // 抛出 mirai 的异常，到 catch 中处理后再抛出
+
+
+    if (code in errCodeMap) {
+      throw new Error(message);
+    }
+
+    return data;
+  } catch (error) {
+    console.error(`mirai-js: error ${locationStr}`);
+    errorHandler(error);
+  }
+};

package/dist/node/core/fs/makeGroupDir.js

@@ -0,0 +1,79 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios');
+
+let URL;
+
+if (!process.browser) {
+  ({
+    URL
+  } = require('url'));
+} else {
+  URL = window.URL;
+}
+
+const errorHandler = require('../../util/errorHandler');
+
+const path = require('path');
+
+const locationStr = `core.${path.basename(__filename, path.extname(__filename))}`;
+/**
+ * @description 新建群文件夹
+ * @param {string}  baseUrl          mirai-api-http server 的地址
+ * @param {string}  sessionKey       会话标识
+ * @param {string}  id               文件夹id, 空串为根目录
+ * @param {string}  path             文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group            群号
+ * @param {boolern} withDownloadInfo 是否携带下载信息，额外请求，无必要不要携带
+ * @returns {Object} 结构 { id, name, path, parent, contact, isFile, isDirectory, downloadInfo }
+ */
+
+module.exports = async ({
+  baseUrl,
+  sessionKey,
+  id,
+  rename,
+  path,
+  group,
+  withDownloadInfo
+}) => {
+  try {
+    // 拼接 url
+    const url = new URL('/file/mkdir', baseUrl).toString(); // 请求
+
+    const responseData = await axios.post(url, {
+      sessionKey,
+      id,
+      rename,
+      path,
+      group,
+      withDownloadInfo
+    });
+
+    try {
+      var {
+        data: {
+          msg: message,
+          code,
+          data
+        }
+      } = responseData;
+    } catch (error) {
+      throw new Error('请求返回格式出错，请检查 mirai-console');
+    } // 抛出 mirai 的异常，到 catch 中处理后再抛出
+
+
+    if (code in errCodeMap) {
+      throw new Error(message);
+    }
+
+    return data;
+  } catch (error) {
+    console.error(`mirai-js: error ${locationStr}`);
+    errorHandler(error);
+  }
+};

package/dist/node/core/fs/moveGroupFile.js

@@ -0,0 +1,83 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios');
+
+let URL;
+
+if (!process.browser) {
+  ({
+    URL
+  } = require('url'));
+} else {
+  URL = window.URL;
+}
+
+const errorHandler = require('../../util/errorHandler');
+
+const path = require('path');
+
+const locationStr = `core.${path.basename(__filename, path.extname(__filename))}`;
+/**
+ * @description 移动群文件
+ * @param {string}  baseUrl    mirai-api-http server 的地址
+ * @param {string}  sessionKey 会话标识
+ * @param {string}  id         文件夹id, 空串为根目录
+ * @param {string}  path       文件夹路径, 文件夹允许重名, 不保证准确, 准确定位使用 id
+ * @param {number}  group      群号
+ * @param {string}  moveTo     移动目标文件夹id
+ * @param {string}  moveToPath 移动目标文件夹path
+ * @returns {Object} 结构 { message, code }
+ */
+
+module.exports = async ({
+  baseUrl,
+  sessionKey,
+  id,
+  path,
+  group,
+  moveTo,
+  moveToPath
+}) => {
+  try {
+    // 拼接 url
+    const url = new URL('/file/move', baseUrl).toString(); // 请求
+
+    const responseData = await axios.post(url, {
+      sessionKey,
+      id,
+      path,
+      target: group,
+      group,
+      moveTo,
+      moveToPath
+    });
+
+    try {
+      var {
+        data: {
+          msg: message,
+          code
+        }
+      } = responseData;
+    } catch (error) {
+      throw new Error('请求返回格式出错，请检查 mirai-console');
+    } // 抛出 mirai 的异常，到 catch 中处理后再抛出
+
+
+    if (code in errCodeMap) {
+      throw new Error(message);
+    }
+
+    return {
+      message,
+      code
+    };
+  } catch (error) {
+    console.error(`mirai-js: error ${locationStr}`);
+    errorHandler(error);
+  }
+};