mirai-js 2.1.0 → 2.4.0

package/dist/node/core/anno/publishAnno.js

@@ -0,0 +1,70 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios');
+
+const {
+  URL
+} = require('../../polyfill/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 {number}  target     群号
+ * @param {string}  content    公告内容
+ * @param {boolean} pinned     是否置顶
+ * @returns {Object} { code, msg }
+ */
+
+module.exports = async ({
+  baseUrl,
+  sessionKey,
+  target,
+  content,
+  pinned
+}) => {
+  try {
+    // 拼接 url
+    const url = new URL('/anno/publish', baseUrl).toString(); // 请求
+
+    const responseData = await axios.post(url, {
+      sessionKey,
+      target,
+      content,
+      pinned
+    });
+
+    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/auth.js

@@ -6,17 +6,15 @@ const {
 
 const axios = require('axios');
 
-let URL;
-
-if (!process.browser) {
-  ({
-    URL
-  } = require('url'));
-} else {
-  URL = window.URL;
-}
+const {
+  URL
+} = require('../polyfill/URL');
 
 const errorHandler = require('../util/errorHandler');
+
+const path = require('path');
+
+const locationStr = `core.${path.basename(__filename, path.extname(__filename))}`;
 /**
  *
  * @description 认证 verifyKey，创建回话，返回一个 sessionKey
@@ -25,7 +23,6 @@ const errorHandler = require('../util/errorHandler');
  * @returns {string} 会话标识 sessionKey
  */
 
-
 module.exports = async ({
   baseUrl,
   verifyKey
@@ -47,7 +44,7 @@ module.exports = async ({
         }
       } = responseData;
     } catch (error) {
-      throw new Error('core.auth 请求返回格式出错，请检查 mirai-console');
+      throw new Error('请求返回格式出错，请检查 mirai-console');
     } // 抛出 mirai 的异常，到 catch 中处理后再抛出
 
 
@@ -57,6 +54,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,71 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios');
+
+const {
+  URL
+} = require('../../polyfill/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,77 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios').default;
+
+const {
+  URL
+} = require('../../polyfill/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,82 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios').default;
+
+const {
+  URL
+} = require('../../polyfill/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,73 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios');
+
+const {
+  URL
+} = require('../../polyfill/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,77 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios');
+
+const {
+  URL
+} = require('../../polyfill/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);
+  }
+};

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

@@ -0,0 +1,73 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios');
+
+const {
+  URL
+} = require('../../polyfill/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 {number} id         文件 id
+ * @param {number} group      群号
+ * @param {string} rename     重命名
+ * @returns {Object} 结构 { message, code }
+ */
+
+module.exports = async ({
+  baseUrl,
+  sessionKey,
+  id,
+  path,
+  group,
+  renameTo
+}) => {
+  try {
+    // 拼接 url
+    const url = new URL('/file/rename', baseUrl).toString(); // 请求
+
+    const responseData = await axios.post(url, {
+      sessionKey,
+      id,
+      path,
+      target: group,
+      group,
+      renameTo
+    });
+
+    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/uploadGroupFIle.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const {
+  errCodeMap
+} = require('../../util/errCode');
+
+const axios = require('axios').default;
+
+const {
+  URL
+} = require('../../polyfill/URL');
+
+const errorHandler = require('../../util/errorHandler');
+
+const path = require('path');
+
+const locationStr = `core.${path.basename(__filename, path.extname(__filename))}`;
+
+const FormData = require('form-data');
+/**
+ * @description 上传文件至服务器并发送，返回文件 id
+ * @param {string}  baseUrl    mirai-api-http server 的地址
+ * @param {string}  sessionKey 会话标识
+ * @param {string}  type       "friend" 或 "group"，目前仅支持 group
+ * @param {string}  target     群/好友号
+ * @param {string}  path       上传目录id
+ * @param {Buffer}  file       文件二进制数据
+ * @returns {string} 文件 id
+ */
+
+
+module.exports = async ({
+  baseUrl,
+  sessionKey,
+  type,
+  target,
+  path,
+  file
+}) => {
+  try {
+    // 拼接 url
+    const targetUrl = new URL('/file/upload', baseUrl).toString(); // 构造 fromdata
+
+    const form = new FormData();
+    form.append('sessionKey', sessionKey);
+    form.append('type', type);
+    form.append('target', target);
+    form.append('path', path);
+    form.append('file', file, {
+      filename: 'payload'
+    }); // 请求
+
+    const responseData = await axios.post(targetUrl, form, {
+      // formdata.getHeaders 将会指定 content-type，同时给定随
+      // 机生成的 boundary，即分隔符，用以分隔多个表单项而不会造成混乱
+      headers: form.getHeaders()
+    });
+
+    try {
+      var {
+        data: {
+          msg: message,
+          code,
+          id
+        }
+      } = responseData;
+    } catch (error) {
+      throw new Error('请求返回格式出错，请检查 mirai-console');
+    } // 抛出 mirai 的异常，到 catch 中处理后再抛出
+
+
+    if (code in errCodeMap) {
+      throw new Error(message);
+    }
+
+    return id;
+  } catch (error) {
+    console.error(`mirai-js: error ${locationStr}`);
+    errorHandler(error);
+  }
+};

package/dist/node/core/getFriendList.js

@@ -6,17 +6,15 @@ const {
 
 const axios = require('axios').default;
 
-let URL;
-
-if (!process.browser) {
-  ({
-    URL
-  } = require('url'));
-} else {
-  URL = window.URL;
-}
+const {
+  URL
+} = require('../polyfill/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 的地址
@@ -24,7 +22,6 @@ const errorHandler = require('../util/errorHandler');
  * @returns {Object[]} 结构 array[...{ id, nickname, remark }]
  */
 
-
 module.exports = async ({
   baseUrl,
   sessionKey
@@ -48,7 +45,7 @@ module.exports = async ({
         }
       } = responseData;
     } catch (error) {
-      throw new Error('core.getFriendList 请求返回格式出错，请检查 mirai-console');
+      throw new Error('请求返回格式出错，请检查 mirai-console');
     } // 抛出 mirai 的异常，到 catch 中处理后再抛出
 
 
@@ -58,6 +55,7 @@ module.exports = async ({
 
     return data;
   } catch (error) {
+    console.error(`mirai-js: error ${locationStr}`);
     errorHandler(error);
   }
 };