@ikenxuan/amagi 4.4.16 → 4.4.18

package/README.md

@@ -1,68 +1,75 @@
-# amagi /ˈæmədʒi/ 🎵
+# amagi
 
 抖音、bilibili 的 web 端相关数据接口基于 Node.js 的实现。支持最低 node 版本为 v18 🚀
 
 ## 我是真爱粉 🧩
 
-"amagi" /ˈæmədʒi/ 名称灵感来源于网络流行的"你干嘛~哎呦~"视频，这是由歌手 cxk 的一段采访视频衍生而来的网络文化现象。这个梗在抖音和 bilibili [BV1St41137jm](https://www.bilibili.com/video/BV1St41137jm) 上广泛传播，成为了中国互联网文化的一部分。选择这个名称也象征着本项目与这些平台内容的紧密联系。🎤💃
+"amagi" /ˈæmədʒi/ 名称灵感来源于网络谐音梗，在网络上 [BV1St41137jm](https://www.bilibili.com/video/BV1St41137jm) / [BV1DL411X7jE](https://www.bilibili.com/video/BV1DL411X7jE) 上广泛传播。🎤💃
 
-此生必看 [BV1DL411X7jE](https://www.bilibili.com/video/BV1DL411X7jE)
 
 ## 项目简介 📝
 
 本项目最初的代码从 [kkkkkk-10086](https://github.com/ikenxuan/kkkkkk-10086) 抽离。主要负责相关数据接口的封装。
 
-amagi 将作为一个独立的上游模块，提供给下游 [karin-plugin-kkk](https://github.com/ikenxuan/karin-plugin-kkk) 和 [kkkkkk-10086](https://github.com/ikenxuan/kkkkkk-10086) 进行视频解析相关业务使用。这两个项目的主要业务基本已经完成，所以如果它们没有什么特殊新业务需求，amagi 大概也不会有新的 API 更新。
+amagi 将作为一个独立的上游模块，提供给下游 [karin-plugin-kkk](https://github.com/ikenxuan/karin-plugin-kkk) 和 [kkkkkk-10086](https://github.com/ikenxuan/kkkkkk-10086) 进行视频解析相关业务使用。这两个项目已完成了几乎所有由 ikenxuan 安排的功能和任务，所以它们如果没有什么新的业务需求，本项目大概再也不会封装新的任何接口。
 
-当然，如果你的下游有新的业务需求，欢迎提 issue 或 pr。（其实作者本人很菜，issue 不一定能解决）
+当然，如果你的下游有新的业务需求，欢迎提 issue 或 pr。（作者本人很菜，issue 不一定能解决）
 
-## 安装 📦
+## 安装/更新 📦
 
 ```bash
 pnpm add @ikenxuan/amagi@latest
 ```
 
-## 默认导出使用方法 🚀
+## 快速开始 🚀
 
 ### 基本用法 ✨
+主要就两个方法，`getDouyinData` 和 `getBilibiliData`。
+
+> 它接收三个参数，
+> * 第一个参数是对应平台封装好的数据接口名称
+> * 第二个参数是接口所需的参数
+> * 第三个参数是用户的 cookies。
+> * 得益于函数重载，参数二和参数三可以互换位置
+
+你可以通过直接导入或者构造器创建实例。
+若通过构造器创建实例，就不需要传入 cookies 参数了，参数二默认接口所需参数。
 
 ```javascript
 import Client from '@ikenxuan/amagi'
+// or
+// import { getDouyinData, getBilibiliData } from '@ikenxuan/amagi'
 
-// 创建客户端实例
-const amagi = new Client({
-  douyin: '', // 抖音 cookie（可选）
-  bilibili: '', // B站 cookie（可选）
-})
+// you can use it as a class/function/object
+const amagi = Client({...options})
+const amagi = new Client({...options})
 
 // 使用示例
 async function example() {
   // 获取抖音搜索数据
-  const searchData = await amagi.getDouyinData('搜索数据', {
-    query: '热门视频',
-    number: 10,
-  })
+  const searchData = await amagi.getDouyinData(
+    '搜索数据',
+    { ...opt }
+    )
 
   // 获取B站视频数据
-  const videoData = await amagi.getBilibiliData('单个视频作品数据', {
-    bvid: 'BV1fK4y1q79u',
-  })
+  const videoData = await amagi.getBilibiliData(
+    '单个视频作品数据',
+    { ...opt }
+    )
 
   console.log(searchData)
 }
 
 example()
 ```
-
+## Advanced
 ### 启动本地 HTTP 服务 🌐
 
 ```javascript
 import Client from '@ikenxuan/amagi'
 
-const amagi = new Client({
-  douyin: '你的抖音cookie',
-  bilibili: '你的B站cookie',
-})
+const amagi = new Client({...options})
 
 // 启动本地服务，默认端口 4567
 const app = amagi.startClient()
@@ -95,24 +102,20 @@ const abSign = douyinUtils.sign.AB('需要签名的地址')
 
 // 使用 API 接口
 const videoData = await douyinUtils.api.getWorkInfo(
-  {
-    aweme_id: '视频ID',
-  },
-  '有效的用户 Cookie'
+  { ...opt },
+  'cookies'
 )
 
 const userInfo = await douyinUtils.api.getUserProfile(
-  {
-    sec_uid: '用户ID',
-  },
-  '有效的用户 Cookie'
+  { ...opt },
+  'cookies'
 )
 
 // 直接获取数据
-const searchResult = await douyinUtils.getDouyinData('搜索数据', {
-  query: '搜索关键词',
-  number: 10,
-})
+const searchResult = await douyinUtils.getDouyinData(
+  '搜索数据',
+  { ...opt }
+  )
 ```
 
 主要功能：
@@ -133,20 +136,16 @@ bilibili 相关功能模块提供了获取 bilibili 平台数据的工具和 API
 import { bilibiliUtils } from '@ikenxuan/amagi'
 
 // 获取视频信息
-const videoInfo = await bilibiliUtils.api.getVideoInfo({
-  bvid: 'BV1fK4y1q79u',
-})
+const videoInfo = await bilibiliUtils.api.getVideoInfo({ ...opt })
 
 // 获取评论数据
-const comments = await bilibiliUtils.api.getComments({
-  oid: 111111, // 稿件ID，也就是AV号去除前缀后的内容
-  type: 1,
-})
+const comments = await bilibiliUtils.api.getComments({ ...opt })
 
 // 直接获取数据
-const userInfo = await bilibiliUtils.getBilibiliData('用户主页数据', {
-  host_mid: 1340190821, // 用户ID
-})
+const userInfo = await bilibiliUtils.getBilibiliData(
+  '用户主页数据',
+  { ...opt }
+  )
 ```
 
 主要功能：
@@ -162,6 +161,7 @@ const userInfo = await bilibiliUtils.getBilibiliData('用户主页数据', {
 ## 类型支持 🧰
 
 该库提供完整的 TypeScript 类型支持，可以获得良好的代码提示和类型检查。✅
+虽有类型但写得和迷宫一样
 
 ## 许可证 📜
 

package/dist/default/cjs/index.cjs

@@ -13,7 +13,6 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var axios__default = /*#__PURE__*/_interopDefault(axios);
 var crypto__default = /*#__PURE__*/_interopDefault(crypto);
 var express__default = /*#__PURE__*/_interopDefault(express);
-var chalk__default = /*#__PURE__*/_interopDefault(chalk);
 var log4js__default = /*#__PURE__*/_interopDefault(log4js);
 
 // src/platform/bilibili/API.ts
@@ -474,7 +473,7 @@ var registerBilibiliRoutes = (cookie) => {
     }, req.headers.cookie || cookie);
     res.json(data2);
   });
-  router.get("/fetch_work_comments", async (req, res) => {
+  router.get("/fetch_emoji_list", async (req, res) => {
     const data2 = await fetchBilibili({
       methodType: "Emoji\u6570\u636E"
     }, req.headers.cookie || cookie);
@@ -547,7 +546,7 @@ var registerBilibiliRoutes = (cookie) => {
   router.get("/av_to_bv", async (req, res) => {
     const data2 = await fetchBilibili({
       methodType: "AV\u8F6CBV",
-      avid: parseInt(req.query.avid)
+      avid: req.query.avid
     }, req.headers.cookie || cookie);
     res.json(data2);
   });
@@ -835,44 +834,66 @@ var fetchBilibili = async (data2, cookie) => {
   }
 };
 var GlobalGetData = async (options) => {
+  let warningMessage = "";
   try {
     const result = await new Networks(options).getData();
-    if (result && result.code === 0) {
-      return result;
-    } else if (result.code === 12061) {
-      const warningMessage = `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01
-\u8BF7\u6C42\u63A5\u53E3\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-\u8BF7\u6C42URL\uFF1A${options.url}
-\u9519\u8BEF\u4EE3\u7801\uFF1A${result.code}\uFF0C
-\u542B\u4E49\uFF1A${result.message}`;
+    if (!result || result === "") {
+      const Err = {
+        errorDescription: "\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684B\u7AD9ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01",
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow("\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684B\u7AD9ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01")}
+      \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
+      \u8BF7\u6C42URL\uFF1A${options.url}
+      `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        warning: warningMessage
+        code: "-352" /* RISK_CONTROL_FAILED */,
+        data: result,
+        amagiError: Err
       };
-    } else {
-      const errorMessage = errorMap[result.code] || result.message || "\u672A\u77E5\u9519\u8BEF";
-      const warningMessage = `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01
-\u8BF7\u6C42\u63A5\u53E3\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-\u8BF7\u6C42URL\uFF1A${options.url}
-\u9519\u8BEF\u4EE3\u7801\uFF1A${result.code}\uFF0C
-\u542B\u4E49\uFF1A${errorMessage}`;
+    }
+    if (result.code !== 0) {
+      const errorMessage = bilibiliErrorCodeMap[result.code] || result.message || "\u672A\u77E5\u9519\u8BEF";
+      const Err = {
+        errorDescription: `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${errorMessage}\uFF01`,
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow(errorMessage)}
+      \u9519\u8BEF\u4EE3\u7801\uFF1A${result.code}
+      \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
+      \u8BF7\u6C42URL\uFF1A${options.url}
+      `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        warning: warningMessage
+        code: result.code,
+        data: result,
+        amagiError: Err
       };
     }
+    return result;
   } catch (error) {
     if (error && typeof error === "object") {
-      return {
-        ...error,
-        warning: error.warning || "\u672A\u77E5\u9519\u8BEF"
-      };
+      const err = error;
+      return { ...err, amagiMessage: warningMessage };
     }
+    return {
+      code: "UNKNOWN_ERROR" /* UNKNOWN */,
+      data: error.data,
+      amagiError: {
+        errorDescription: "\u672A\u77E5\u9519\u8BEF",
+        requestType: options.methodType,
+        requestUrl: options.url
+      },
+      amagiMessage: warningMessage
+    };
   }
 };
-var errorMap = {
+var bilibiliErrorCodeMap = {
   "-1": "\u5E94\u7528\u7A0B\u5E8F\u4E0D\u5B58\u5728\u6216\u5DF2\u88AB\u5C01\u7981",
   "-2": "Access Key \u9519\u8BEF",
   "-3": "API \u6821\u9A8C\u5BC6\u5319\u9519\u8BEF",
@@ -1668,6 +1689,7 @@ var defheaders2 = {
   connection: "keep-alive"
 };
 var DouyinData = async (data2, cookie) => {
+  var _a, _b;
   const headers2 = {
     ...defheaders2,
     cookie: cookie ? cookie.replace(/\s+/g, "") : ""
@@ -1814,15 +1836,29 @@ var DouyinData = async (data2, cookie) => {
     case "\u76F4\u64AD\u95F4\u4FE1\u606F\u6570\u636E": {
       DouyinValidateData(data2, ["sec_uid"]);
       let url = douyinApiUrls.\u7528\u6237\u4E3B\u9875\u4FE1\u606F({ sec_uid: data2.sec_uid });
+      const fetchUrl = `${url}&a_bogus=${douyinSign.AB(url)}`;
       const UserInfoData = await GlobalGetData2({
-        url: `${url}&a_bogus=${douyinSign.AB(url)}`,
+        url: fetchUrl,
         headers: {
           ...headers2,
           Referer: `https://www.douyin.com/user/${data2.sec_uid}`
         },
         ...data2
       });
-      if (UserInfoData.user.live_status !== 1) logger.error(UserInfoData.user.nickname + "\u672A\u5F00\u542F\u76F4\u64AD\uFF01");
+      if (!((_a = UserInfoData == null ? void 0 : UserInfoData.user) == null ? void 0 : _a.live_status) || UserInfoData.user.live_status !== 1) {
+        logger.error((((_b = UserInfoData == null ? void 0 : UserInfoData.user) == null ? void 0 : _b.nickname) || "\u7528\u6237") + "\u5F53\u524D\u672A\u5728\u76F4\u64AD");
+        const Err = {
+          errorDescription: "\u68C0\u67E5\u5931\u8D25\uFF01\u8BE5\u7528\u6237\u5F53\u524D\u672A\u5728\u76F4\u64AD\uFF01 TypeError: Cannot read properties of undefined (reading 'live_status')",
+          requestType: data2.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+          requestUrl: fetchUrl
+        };
+        return {
+          code: "USER_NOT_LIVE" /* NOT_LIVE */,
+          data: UserInfoData,
+          amagiError: Err,
+          amagiMessage: Err.errorDescription
+        };
+      }
       if (!UserInfoData.user.room_data) {
         logger.error("\u672A\u83B7\u53D6\u5230\u76F4\u64AD\u95F4\u4FE1\u606F\uFF01");
         return {
@@ -1889,45 +1925,62 @@ var fetchPaginatedData = async (apiUrlGenerator, params, maxPageSize, headers2)
   return finalResponse;
 };
 async function GlobalGetData2(options) {
+  let warningMessage = "";
   try {
     const result = await new Networks(options).getData();
-    if (result === "" || !result) {
-      const warningMessage = `
-      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A
-      \u4F60\u7684\u6296\u97F3ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01
+    if (!result || result === "") {
+      const Err = {
+        errorDescription: "\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684\u6296\u97F3ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01",
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow("\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684\u6296\u97F3ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01")}
       \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-      \u8BF7\u6C42URL\uFF1A ${options.url}
+      \u8BF7\u6C42URL\uFF1A${options.url}
       `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        code: result.status_code,
-        warning: warningMessage
+        code: "INVALID_COOKIE" /* COOKIE */,
+        data: result,
+        amagiError: Err
       };
     }
     if (result.filter_detail && result.filter_detail.filter_reason) {
       const filterReason = result.filter_detail.filter_reason;
-      const warningMessage = `
-      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${filterReason}
+      const Err = {
+        errorDescription: `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${filterReason}\uFF01`,
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow(filterReason)}
       \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-      \u8BF7\u6C42URL\uFF1A ${options.url}
+      \u8BF7\u6C42URL\uFF1A${options.url}
       `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        code: result.status_code || 0,
-        warning: warningMessage
+        code: "CONTENT_FILTERED" /* FILTER */,
+        data: result,
+        amagiError: Err
       };
     }
     return result;
   } catch (error) {
     if (error && typeof error === "object") {
-      return {
-        ...error,
-        code: error.status_code || 500,
-        warning: error.warning || "\u672A\u77E5\u9519\u8BEF"
-      };
+      const err = error;
+      return { ...err, amagiMessage: warningMessage };
     }
+    return {
+      code: "UNKNOWN_ERROR" /* UNKNOWN */,
+      data: null,
+      amagiError: {
+        errorDescription: "\u672A\u77E5\u9519\u8BEF",
+        requestType: options.methodType,
+        requestUrl: options.url
+      },
+      amagiMessage: warningMessage
+    };
   }
 }
 
@@ -2103,31 +2156,45 @@ var KuaishouData = async (data2, cookie) => {
   }
 };
 async function GlobalGetData3(options) {
+  let warningMessage = "";
   try {
     const result = await new Networks(options).getData();
     if (result === "" || !result || result.result === 2) {
-      const warningMessage = `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A
-\u4F60\u7684\u5FEB\u624Bck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01
-\u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-\u8BF7\u6C42URL\uFF1A${options.url}
-\u8BF7\u6C42\u53C2\u6570\uFF1A${JSON.stringify(options.body, null, 2)}`;
+      const Err = {
+        errorDescription: `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF01`,
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url,
+        requestBody: JSON.stringify(options.body)
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow("\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684\u5FEB\u624Bck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01")}
+      \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
+      \u8BF7\u6C42URL\uFF1A${options.url}
+      \u8BF7\u6C42\u53C2\u6570\uFF1A${JSON.stringify(options.body, null, 2)}
+      `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        code: result.result,
-        warning: warningMessage
+        code: "INVALID_COOKIE" /* COOKIE */,
+        data: result,
+        amagiError: Err
       };
     }
     return result;
   } catch (error) {
     if (error && typeof error === "object") {
-      return {
-        ...error,
-        code: error.result || 500,
-        message: error.error_msg,
-        warning: error.warning || "\u672A\u77E5\u9519\u8BEF"
-      };
+      const err = error;
+      return { ...err, amagiMessage: warningMessage };
     }
+    return {
+      code: "UNKNOWN_ERROR" /* UNKNOWN */,
+      data: null,
+      amagiError: {
+        errorDescription: "\u672A\u77E5\u9519\u8BEF",
+        requestType: options.methodType,
+        requestUrl: options.url
+      },
+      amagiMessage: warningMessage
+    };
   }
 }
 
@@ -2229,15 +2296,15 @@ var CustomLogger = class {
   gray;
   constructor(name) {
     this.logger = log4js__default.default.getLogger(name);
-    this.chalk = chalk__default.default;
-    this.red = chalk__default.default.red.bind(chalk__default.default);
-    this.green = chalk__default.default.green.bind(chalk__default.default);
-    this.yellow = chalk__default.default.yellow.bind(chalk__default.default);
-    this.blue = chalk__default.default.blue.bind(chalk__default.default);
-    this.magenta = chalk__default.default.magenta.bind(chalk__default.default);
-    this.cyan = chalk__default.default.cyan.bind(chalk__default.default);
-    this.white = chalk__default.default.white.bind(chalk__default.default);
-    this.gray = chalk__default.default.gray.bind(chalk__default.default);
+    this.chalk = new chalk.Chalk();
+    this.red = this.chalk.red;
+    this.green = this.chalk.green;
+    this.yellow = this.chalk.yellow;
+    this.blue = this.chalk.blue;
+    this.magenta = this.chalk.magenta;
+    this.cyan = this.chalk.cyan;
+    this.white = this.chalk.white;
+    this.gray = this.chalk.gray;
   }
   // 代理 log4js.Logger 的方法
   info(message, ...args) {
@@ -2517,9 +2584,9 @@ function createAmagiClient(options = {}) {
 createAmagiClient.douyin = douyinUtils;
 createAmagiClient.bilibili = bilibiliUtils;
 createAmagiClient.kuaishou = kuaishouUtils;
-createAmagiClient.getDouyinData = () => douyinUtils.getDouyinData;
-createAmagiClient.getBilibiliData = () => bilibiliUtils.getBilibiliData;
-createAmagiClient.getKuaishouData = () => kuaishouUtils.getKuaishouData;
+createAmagiClient.getDouyinData = douyinUtils.getDouyinData;
+createAmagiClient.getBilibiliData = bilibiliUtils.getBilibiliData;
+createAmagiClient.getKuaishouData = kuaishouUtils.getKuaishouData;
 var CreateApp = createAmagiClient;
 var Client = CreateApp;
 var amagi = Client;
@@ -2536,6 +2603,7 @@ exports.av2bv = av2bv;
 exports.bilibili = bilibili;
 exports.bilibiliAPI = bilibiliAPI;
 exports.bilibiliApiUrls = bilibiliApiUrls;
+exports.bilibiliErrorCodeMap = bilibiliErrorCodeMap;
 exports.bilibiliUtils = bilibiliUtils;
 exports.bv2av = bv2av;
 exports.default = Client;

package/dist/default/esm/index.mjs

@@ -1,7 +1,7 @@
 import axios, { AxiosError } from 'axios';
 import crypto from 'crypto';
 import express from 'express';
-import chalk from 'chalk';
+import { Chalk } from 'chalk';
 import log4js from 'log4js';
 
 // src/platform/bilibili/API.ts
@@ -462,7 +462,7 @@ var registerBilibiliRoutes = (cookie) => {
     }, req.headers.cookie || cookie);
     res.json(data2);
   });
-  router.get("/fetch_work_comments", async (req, res) => {
+  router.get("/fetch_emoji_list", async (req, res) => {
     const data2 = await fetchBilibili({
       methodType: "Emoji\u6570\u636E"
     }, req.headers.cookie || cookie);
@@ -535,7 +535,7 @@ var registerBilibiliRoutes = (cookie) => {
   router.get("/av_to_bv", async (req, res) => {
     const data2 = await fetchBilibili({
       methodType: "AV\u8F6CBV",
-      avid: parseInt(req.query.avid)
+      avid: req.query.avid
     }, req.headers.cookie || cookie);
     res.json(data2);
   });
@@ -823,44 +823,66 @@ var fetchBilibili = async (data2, cookie) => {
   }
 };
 var GlobalGetData = async (options) => {
+  let warningMessage = "";
   try {
     const result = await new Networks(options).getData();
-    if (result && result.code === 0) {
-      return result;
-    } else if (result.code === 12061) {
-      const warningMessage = `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01
-\u8BF7\u6C42\u63A5\u53E3\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-\u8BF7\u6C42URL\uFF1A${options.url}
-\u9519\u8BEF\u4EE3\u7801\uFF1A${result.code}\uFF0C
-\u542B\u4E49\uFF1A${result.message}`;
+    if (!result || result === "") {
+      const Err = {
+        errorDescription: "\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684B\u7AD9ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01",
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow("\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684B\u7AD9ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01")}
+      \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
+      \u8BF7\u6C42URL\uFF1A${options.url}
+      `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        warning: warningMessage
+        code: "-352" /* RISK_CONTROL_FAILED */,
+        data: result,
+        amagiError: Err
       };
-    } else {
-      const errorMessage = errorMap[result.code] || result.message || "\u672A\u77E5\u9519\u8BEF";
-      const warningMessage = `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01
-\u8BF7\u6C42\u63A5\u53E3\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-\u8BF7\u6C42URL\uFF1A${options.url}
-\u9519\u8BEF\u4EE3\u7801\uFF1A${result.code}\uFF0C
-\u542B\u4E49\uFF1A${errorMessage}`;
+    }
+    if (result.code !== 0) {
+      const errorMessage = bilibiliErrorCodeMap[result.code] || result.message || "\u672A\u77E5\u9519\u8BEF";
+      const Err = {
+        errorDescription: `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${errorMessage}\uFF01`,
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow(errorMessage)}
+      \u9519\u8BEF\u4EE3\u7801\uFF1A${result.code}
+      \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
+      \u8BF7\u6C42URL\uFF1A${options.url}
+      `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        warning: warningMessage
+        code: result.code,
+        data: result,
+        amagiError: Err
       };
     }
+    return result;
   } catch (error) {
     if (error && typeof error === "object") {
-      return {
-        ...error,
-        warning: error.warning || "\u672A\u77E5\u9519\u8BEF"
-      };
+      const err = error;
+      return { ...err, amagiMessage: warningMessage };
     }
+    return {
+      code: "UNKNOWN_ERROR" /* UNKNOWN */,
+      data: error.data,
+      amagiError: {
+        errorDescription: "\u672A\u77E5\u9519\u8BEF",
+        requestType: options.methodType,
+        requestUrl: options.url
+      },
+      amagiMessage: warningMessage
+    };
   }
 };
-var errorMap = {
+var bilibiliErrorCodeMap = {
   "-1": "\u5E94\u7528\u7A0B\u5E8F\u4E0D\u5B58\u5728\u6216\u5DF2\u88AB\u5C01\u7981",
   "-2": "Access Key \u9519\u8BEF",
   "-3": "API \u6821\u9A8C\u5BC6\u5319\u9519\u8BEF",
@@ -1656,6 +1678,7 @@ var defheaders2 = {
   connection: "keep-alive"
 };
 var DouyinData = async (data2, cookie) => {
+  var _a, _b;
   const headers2 = {
     ...defheaders2,
     cookie: cookie ? cookie.replace(/\s+/g, "") : ""
@@ -1802,15 +1825,29 @@ var DouyinData = async (data2, cookie) => {
     case "\u76F4\u64AD\u95F4\u4FE1\u606F\u6570\u636E": {
       DouyinValidateData(data2, ["sec_uid"]);
       let url = douyinApiUrls.\u7528\u6237\u4E3B\u9875\u4FE1\u606F({ sec_uid: data2.sec_uid });
+      const fetchUrl = `${url}&a_bogus=${douyinSign.AB(url)}`;
       const UserInfoData = await GlobalGetData2({
-        url: `${url}&a_bogus=${douyinSign.AB(url)}`,
+        url: fetchUrl,
         headers: {
           ...headers2,
           Referer: `https://www.douyin.com/user/${data2.sec_uid}`
         },
         ...data2
       });
-      if (UserInfoData.user.live_status !== 1) logger.error(UserInfoData.user.nickname + "\u672A\u5F00\u542F\u76F4\u64AD\uFF01");
+      if (!((_a = UserInfoData == null ? void 0 : UserInfoData.user) == null ? void 0 : _a.live_status) || UserInfoData.user.live_status !== 1) {
+        logger.error((((_b = UserInfoData == null ? void 0 : UserInfoData.user) == null ? void 0 : _b.nickname) || "\u7528\u6237") + "\u5F53\u524D\u672A\u5728\u76F4\u64AD");
+        const Err = {
+          errorDescription: "\u68C0\u67E5\u5931\u8D25\uFF01\u8BE5\u7528\u6237\u5F53\u524D\u672A\u5728\u76F4\u64AD\uFF01 TypeError: Cannot read properties of undefined (reading 'live_status')",
+          requestType: data2.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+          requestUrl: fetchUrl
+        };
+        return {
+          code: "USER_NOT_LIVE" /* NOT_LIVE */,
+          data: UserInfoData,
+          amagiError: Err,
+          amagiMessage: Err.errorDescription
+        };
+      }
       if (!UserInfoData.user.room_data) {
         logger.error("\u672A\u83B7\u53D6\u5230\u76F4\u64AD\u95F4\u4FE1\u606F\uFF01");
         return {
@@ -1877,45 +1914,62 @@ var fetchPaginatedData = async (apiUrlGenerator, params, maxPageSize, headers2)
   return finalResponse;
 };
 async function GlobalGetData2(options) {
+  let warningMessage = "";
   try {
     const result = await new Networks(options).getData();
-    if (result === "" || !result) {
-      const warningMessage = `
-      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A
-      \u4F60\u7684\u6296\u97F3ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01
+    if (!result || result === "") {
+      const Err = {
+        errorDescription: "\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684\u6296\u97F3ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01",
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow("\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684\u6296\u97F3ck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01")}
       \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-      \u8BF7\u6C42URL\uFF1A ${options.url}
+      \u8BF7\u6C42URL\uFF1A${options.url}
       `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        code: result.status_code,
-        warning: warningMessage
+        code: "INVALID_COOKIE" /* COOKIE */,
+        data: result,
+        amagiError: Err
       };
     }
     if (result.filter_detail && result.filter_detail.filter_reason) {
       const filterReason = result.filter_detail.filter_reason;
-      const warningMessage = `
-      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${filterReason}
+      const Err = {
+        errorDescription: `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${filterReason}\uFF01`,
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow(filterReason)}
       \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-      \u8BF7\u6C42URL\uFF1A ${options.url}
+      \u8BF7\u6C42URL\uFF1A${options.url}
       `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        code: result.status_code || 0,
-        warning: warningMessage
+        code: "CONTENT_FILTERED" /* FILTER */,
+        data: result,
+        amagiError: Err
       };
     }
     return result;
   } catch (error) {
     if (error && typeof error === "object") {
-      return {
-        ...error,
-        code: error.status_code || 500,
-        warning: error.warning || "\u672A\u77E5\u9519\u8BEF"
-      };
+      const err = error;
+      return { ...err, amagiMessage: warningMessage };
     }
+    return {
+      code: "UNKNOWN_ERROR" /* UNKNOWN */,
+      data: null,
+      amagiError: {
+        errorDescription: "\u672A\u77E5\u9519\u8BEF",
+        requestType: options.methodType,
+        requestUrl: options.url
+      },
+      amagiMessage: warningMessage
+    };
   }
 }
 
@@ -2091,31 +2145,45 @@ var KuaishouData = async (data2, cookie) => {
   }
 };
 async function GlobalGetData3(options) {
+  let warningMessage = "";
   try {
     const result = await new Networks(options).getData();
     if (result === "" || !result || result.result === 2) {
-      const warningMessage = `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A
-\u4F60\u7684\u5FEB\u624Bck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01
-\u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
-\u8BF7\u6C42URL\uFF1A${options.url}
-\u8BF7\u6C42\u53C2\u6570\uFF1A${JSON.stringify(options.body, null, 2)}`;
+      const Err = {
+        errorDescription: `\u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF01`,
+        requestType: options.methodType ?? "\u672A\u77E5\u8BF7\u6C42\u7C7B\u578B",
+        requestUrl: options.url,
+        requestBody: JSON.stringify(options.body)
+      };
+      warningMessage = `
+      \u83B7\u53D6\u54CD\u5E94\u6570\u636E\u5931\u8D25\uFF01\u539F\u56E0\uFF1A${logger.yellow("\u63A5\u53E3\u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A\uFF0C\u4F60\u7684\u5FEB\u624Bck\u53EF\u80FD\u5DF2\u7ECF\u5931\u6548\uFF01")}
+      \u8BF7\u6C42\u7C7B\u578B\uFF1A\u300C${options.methodType}\u300D
+      \u8BF7\u6C42URL\uFF1A${options.url}
+      \u8BF7\u6C42\u53C2\u6570\uFF1A${JSON.stringify(options.body, null, 2)}
+      `;
       logger.warn(warningMessage);
       throw {
-        ...result,
-        code: result.result,
-        warning: warningMessage
+        code: "INVALID_COOKIE" /* COOKIE */,
+        data: result,
+        amagiError: Err
       };
     }
     return result;
   } catch (error) {
     if (error && typeof error === "object") {
-      return {
-        ...error,
-        code: error.result || 500,
-        message: error.error_msg,
-        warning: error.warning || "\u672A\u77E5\u9519\u8BEF"
-      };
+      const err = error;
+      return { ...err, amagiMessage: warningMessage };
     }
+    return {
+      code: "UNKNOWN_ERROR" /* UNKNOWN */,
+      data: null,
+      amagiError: {
+        errorDescription: "\u672A\u77E5\u9519\u8BEF",
+        requestType: options.methodType,
+        requestUrl: options.url
+      },
+      amagiMessage: warningMessage
+    };
   }
 }
 
@@ -2217,15 +2285,15 @@ var CustomLogger = class {
   gray;
   constructor(name) {
     this.logger = log4js.getLogger(name);
-    this.chalk = chalk;
-    this.red = chalk.red.bind(chalk);
-    this.green = chalk.green.bind(chalk);
-    this.yellow = chalk.yellow.bind(chalk);
-    this.blue = chalk.blue.bind(chalk);
-    this.magenta = chalk.magenta.bind(chalk);
-    this.cyan = chalk.cyan.bind(chalk);
-    this.white = chalk.white.bind(chalk);
-    this.gray = chalk.gray.bind(chalk);
+    this.chalk = new Chalk();
+    this.red = this.chalk.red;
+    this.green = this.chalk.green;
+    this.yellow = this.chalk.yellow;
+    this.blue = this.chalk.blue;
+    this.magenta = this.chalk.magenta;
+    this.cyan = this.chalk.cyan;
+    this.white = this.chalk.white;
+    this.gray = this.chalk.gray;
   }
   // 代理 log4js.Logger 的方法
   info(message, ...args) {
@@ -2505,11 +2573,11 @@ function createAmagiClient(options = {}) {
 createAmagiClient.douyin = douyinUtils;
 createAmagiClient.bilibili = bilibiliUtils;
 createAmagiClient.kuaishou = kuaishouUtils;
-createAmagiClient.getDouyinData = () => douyinUtils.getDouyinData;
-createAmagiClient.getBilibiliData = () => bilibiliUtils.getBilibiliData;
-createAmagiClient.getKuaishouData = () => kuaishouUtils.getKuaishouData;
+createAmagiClient.getDouyinData = douyinUtils.getDouyinData;
+createAmagiClient.getBilibiliData = bilibiliUtils.getBilibiliData;
+createAmagiClient.getKuaishouData = kuaishouUtils.getKuaishouData;
 var CreateApp = createAmagiClient;
 var Client = CreateApp;
 var amagi = Client;
 
-export { BilibiliValidateData, CreateApp, DouyinValidateData, KuaishouAPI, KusiahouValidateData, Networks, amagi, amagiClient, av2bv, bilibili, bilibiliAPI, bilibiliApiUrls, bilibiliUtils, bv2av, Client as default, douyin, douyinAPI, douyinApiUrls, douyinSign, douyinUtils, fetchBilibiliData, fetchDouyinData, fetchKuaishouData, getBilibiliData, getDouyinData, getKuaishouData, kuaishou, kuaishouAPI, kuaishouApiUrls, kuaishouUtils, logMiddleware, logger, qtparam, registerBilibiliRoutes, registerDouyinRoutes, registerKuaishouRoutes, wbi_sign };
+export { BilibiliValidateData, CreateApp, DouyinValidateData, KuaishouAPI, KusiahouValidateData, Networks, amagi, amagiClient, av2bv, bilibili, bilibiliAPI, bilibiliApiUrls, bilibiliErrorCodeMap, bilibiliUtils, bv2av, Client as default, douyin, douyinAPI, douyinApiUrls, douyinSign, douyinUtils, fetchBilibiliData, fetchDouyinData, fetchKuaishouData, getBilibiliData, getDouyinData, getKuaishouData, kuaishou, kuaishouAPI, kuaishouApiUrls, kuaishouUtils, logMiddleware, logger, qtparam, registerBilibiliRoutes, registerDouyinRoutes, registerKuaishouRoutes, wbi_sign };

package/dist/default/index.d.ts

@@ -1,4 +1,4 @@
-import chalk from 'chalk';
+import { ChalkInstance } from 'chalk';
 import express, { RequestHandler, Request, Router } from 'express';
 import { AxiosRequestConfig, AxiosResponse } from 'axios';
 
@@ -387,6 +387,147 @@ type NetworksConfigType = {
      */
     methodType?: string;
 };
+/** API标准化HTTP请求错误类型 */
+type ErrorDetail = {
+    /**
+     * 错误描述信息
+     */
+    errorDescription: string;
+    /**
+     * 请求类型
+     */
+    requestType: string;
+    /**
+     * 请求URL地址
+     */
+    requestUrl: string;
+};
+/** 未知错误 */
+declare enum amagiAPIErrorCode {
+    /** 未知错误 */
+    UNKNOWN = "UNKNOWN_ERROR"
+}
+/** 抖音平台API错误码 */
+declare enum douoyinAPIErrorCode {
+    /** Cookie无效或已过期 */
+    COOKIE = "INVALID_COOKIE",
+    /** 内容被隐藏或下架 */
+    FILTER = "CONTENT_FILTERED",
+    /** 当前用户未开播 */
+    NOT_LIVE = "USER_NOT_LIVE",
+    /** 未知错误 */
+    UNKNOWN = "UNKNOWN_ERROR"
+}
+/** B站平台API错误码 */
+declare enum bilibiliAPIErrorCode {
+    /** 应用程序不存在或已被封禁 */
+    APP_NOT_FOUND = "-1",
+    /** Access Key 错误 */
+    ACCESS_KEY_ERROR = "-2",
+    /** API 校验密匙错误 */
+    API_KEY_ERROR = "-3",
+    /** 调用方对该Method没有权限 */
+    METHOD_NOT_PERMITTED = "-4",
+    /** 账号未登录 */
+    NOT_LOGGED_IN = "-101",
+    /** 账号被封停 */
+    ACCOUNT_BANNED = "-102",
+    /** 积分不足 */
+    POINTS_INSUFFICIENT = "-103",
+    /** 硬币不足 */
+    COINS_INSUFFICIENT = "-104",
+    /** 验证码错误 */
+    CAPTCHA_ERROR = "-105",
+    /** 账号非正式会员或在适应期 */
+    MEMBERSHIP_LIMITED = "-106",
+    /** 应用不存在或者被封禁 */
+    APP_BANNED = "-107",
+    /** 未绑定手机 */
+    PHONE_NOT_BOUND = "-108",
+    /** 未绑定手机 */
+    PHONE_NOT_BOUND_2 = "-110",
+    /** csrf 校验失败 */
+    CSRF_ERROR = "-111",
+    /** 系统升级中 */
+    SYSTEM_UPDATING = "-112",
+    /** 账号尚未实名认证 */
+    NOT_REAL_NAME_VERIFIED = "-113",
+    /** 请先绑定手机 */
+    NEED_BIND_PHONE = "-114",
+    /** 请先完成实名认证 */
+    NEED_REAL_NAME_VERIFICATION = "-115",
+    /** 木有改动 */
+    NO_CHANGE = "-304",
+    /** 撞车跳转 */
+    CONFLICT_REDIRECT = "-307",
+    /** 风控校验失败 (UA 或 wbi 参数不合法) */
+    RISK_CONTROL_FAILED = "-352",
+    /** 请求错误 */
+    BAD_REQUEST = "-400",
+    /** 未认证 (或非法请求) */
+    UNAUTHORIZED = "-401",
+    /** 访问权限不足 */
+    FORBIDDEN = "-403",
+    /** 啥都木有 */
+    NOT_FOUND = "-404",
+    /** 不支持该方法 */
+    METHOD_NOT_ALLOWED = "-405",
+    /** 冲突 */
+    CONFLICT = "-409",
+    /** 请求被拦截 (客户端 ip 被服务端风控) */
+    IP_BLOCKED = "-412",
+    /** 服务器错误 */
+    SERVER_ERROR = "-500",
+    /** 过载保护,服务暂不可用 */
+    SERVICE_UNAVAILABLE = "-503",
+    /** 服务调用超时 */
+    GATEWAY_TIMEOUT = "-504",
+    /** 超出限制 */
+    RATE_LIMITED = "-509",
+    /** 上传文件不存在 */
+    FILE_NOT_FOUND = "-616",
+    /** 上传文件太大 */
+    FILE_TOO_LARGE = "-617",
+    /** 登录失败次数太多 */
+    LOGIN_ATTEMPTS_EXCEEDED = "-625",
+    /** 用户不存在 */
+    USER_NOT_FOUND = "-626",
+    /** 密码太弱 */
+    WEAK_PASSWORD = "-628",
+    /** 用户名或密码错误 */
+    INVALID_CREDENTIALS = "-629",
+    /** 操作对象数量限制 */
+    OBJECT_LIMIT_EXCEEDED = "-632",
+    /** 被锁定 */
+    ACCOUNT_LOCKED = "-643",
+    /** 用户等级太低 */
+    USER_LEVEL_TOO_LOW = "-650",
+    /** 重复的用户 */
+    DUPLICATE_USER = "-652",
+    /** Token 过期 */
+    TOKEN_EXPIRED = "-658",
+    /** 密码时间戳过期 */
+    PASSWORD_TIMESTAMP_EXPIRED = "-662",
+    /** 地理区域限制 */
+    GEO_RESTRICTED = "-688",
+    /** 版权限制 */
+    COPYRIGHT_RESTRICTED = "-689",
+    /** 扣节操失败 */
+    REPUTATION_DEDUCTION_FAILED = "-701",
+    /** 请求过于频繁，请稍后再试 */
+    TOO_MANY_REQUESTS = "-799",
+    /** 服务器开小差了 */
+    SERVER_TEMPORARILY_UNAVAILABLE = "-8888",
+    /** 未知错误 */
+    UNKNOWN = "UNKNOWN"
+}
+/** 快手平台API错误码 */
+declare enum kuaishouAPIErrorCode {
+    /** Cookie无效或已过期 */
+    COOKIE = "INVALID_COOKIE",
+    /** 未知错误 */
+    UNKNOWN = "UNKNOWN_ERROR"
+}
 
 type DyEmojiList = {
     emoji_list: EmojiListElement[];
@@ -13243,6 +13384,21 @@ type TypeControl = {
     typeMode?: 'strict' | 'loose';
 };
 
+/**
+ * API请求错误类型
+ * 该类型是方法 `getXXXData` 封装后请求遇到错误时的返回类型
+ */
+type APIErrorType<T extends 'douyin' | 'bilibili' | 'kuaishou' | 'default' = 'default'> = {
+    /** 错误码 */
+    code: T extends 'douyin' ? douoyinAPIErrorCode : T extends 'bilibili' ? bilibiliAPIErrorCode : T extends 'kuaishou' ? kuaishouAPIErrorCode : amagiAPIErrorCode;
+    /** 错误时的响应数据 */
+    data: any;
+    /** amagi 错误详情 */
+    amagiError: ErrorDetail;
+    /** 错误信息 */
+    amagiMessage: string;
+};
+
 /**
  * 快捷获取抖音数据
  * @param type - 请求数据类型
@@ -13309,7 +13465,7 @@ declare const fetchKuaishouData: typeof getKuaishouData;
 
 declare class CustomLogger {
     private logger;
-    chalk: typeof chalk;
+    chalk: ChalkInstance;
     red: (text: string) => string;
     green: (text: string) => string;
     yellow: (text: string) => string;
@@ -13589,6 +13745,13 @@ declare function bv2av(bvid: string): number;
  */
 declare function wbi_sign(BASEURL: string | URL, cookie: string): Promise<string>;
 
+/**
+ * 哔哩哔哩API官方HTTP请求错误码
+ */
+declare const bilibiliErrorCodeMap: {
+    [key: string]: string;
+};
+
 declare function qtparam(BASEURL: string, cookie: string): Promise<{
     QUERY: string;
     STATUS: string;
@@ -14068,7 +14231,7 @@ type AmagiConstructor = {
      * @param options - 请求参数，是一个对象
      * @returns 返回接口的原始数据
      */
-    getDouyinData: () => typeof douyinUtils.getDouyinData;
+    getDouyinData: typeof douyinUtils.getDouyinData;
     /**
      * 快捷获取B站数据
      * @param type - 请求数据类型
@@ -14076,7 +14239,7 @@ type AmagiConstructor = {
      * @param options - 请求参数，是一个对象
      * @returns 返回接口的原始数据
      */
-    getBilibiliData: () => typeof bilibiliUtils.getBilibiliData;
+    getBilibiliData: typeof bilibiliUtils.getBilibiliData;
     /**
      * 快捷获取快手数据
      * @param type - 请求数据类型
@@ -14084,7 +14247,7 @@ type AmagiConstructor = {
      * @param options - 请求参数，是一个对象
      * @returns 返回接口的原始数据
      */
-    getKuaishouData: () => typeof kuaishouUtils.getKuaishouData;
+    getKuaishouData: typeof kuaishouUtils.getKuaishouData;
 };
 /** After instantiation, it can interact with the specified platform API to quickly obtain data. */
 declare const CreateApp: AmagiConstructor;
@@ -14092,4 +14255,4 @@ declare const CreateApp: AmagiConstructor;
 declare const Client: AmagiConstructor;
 declare const amagi: AmagiConstructor;
 
-export { type BiliAv2Bv, type BiliBangumiVideoInfo, type BiliBangumiVideoPlayurlIsLogin, type BiliBangumiVideoPlayurlNoLogin, type BiliBiliVideoPlayurlNoLogin, type BiliBv2AV, type BiliCheckQrcode, type BiliDynamicCard, type BiliDynamicInfo, type BiliEmojiList, type BiliLiveRoomDef, type BiliLiveRoomDetail, type BiliNewLoginQrcode, type BiliOneWork, type BiliUserDynamic, type BiliUserFullView, type BiliUserProfile, type BiliVideoPlayurlIsLogin, type BiliWorkComments, type BilibiliDataOptions, type BilibiliDataOptionsMap, type BilibiliMethodOptionsMap, type BilibiliRequest, BilibiliValidateData, CreateApp, type DouyinDataOptions, type DouyinDataOptionsMap, type DouyinMethodOptionsMap, type DouyinRequest, DouyinValidateData, type DyEmojiList, type DyEmojiProList, type DyImageAlbumWork, type DyMusicWork, type DySearchInfo, type DySlidesWork, type DySuggestWords, type DyUserInfo, type DyUserLiveVideos, type DyUserPostVideos, type DyVideoWork, type DyWorkComments, type KsEmojiList, type KsOneWork, type KsWorkComments, KuaishouAPI, type KuaishouDataOptions, type KuaishouDataOptionsMap, type KuaishouMethodOptionsMap, type KusiahouRequest, KusiahouValidateData, Networks, type NetworksConfigType, type OmitMethodType, type TypeControl, amagi, amagiClient, av2bv, bilibili, bilibiliAPI, bilibiliApiUrls, bilibiliUtils, bv2av, type cookiesOptions, Client as default, douyin, douyinAPI, douyinApiUrls, douyinSign, douyinUtils, fetchBilibiliData, fetchDouyinData, fetchKuaishouData, getBilibiliData, getDouyinData, getKuaishouData, kuaishou, kuaishouAPI, kuaishouApiUrls, kuaishouUtils, logMiddleware, logger, qtparam, registerBilibiliRoutes, registerDouyinRoutes, registerKuaishouRoutes, wbi_sign };
+export { type APIErrorType, type BiliAv2Bv, type BiliBangumiVideoInfo, type BiliBangumiVideoPlayurlIsLogin, type BiliBangumiVideoPlayurlNoLogin, type BiliBiliVideoPlayurlNoLogin, type BiliBv2AV, type BiliCheckQrcode, type BiliDynamicCard, type BiliDynamicInfo, type BiliEmojiList, type BiliLiveRoomDef, type BiliLiveRoomDetail, type BiliNewLoginQrcode, type BiliOneWork, type BiliUserDynamic, type BiliUserFullView, type BiliUserProfile, type BiliVideoPlayurlIsLogin, type BiliWorkComments, type BilibiliDataOptions, type BilibiliDataOptionsMap, type BilibiliMethodOptionsMap, type BilibiliRequest, BilibiliValidateData, CreateApp, type DouyinDataOptions, type DouyinDataOptionsMap, type DouyinMethodOptionsMap, type DouyinRequest, DouyinValidateData, type DyEmojiList, type DyEmojiProList, type DyImageAlbumWork, type DyMusicWork, type DySearchInfo, type DySlidesWork, type DySuggestWords, type DyUserInfo, type DyUserLiveVideos, type DyUserPostVideos, type DyVideoWork, type DyWorkComments, type KsEmojiList, type KsOneWork, type KsWorkComments, KuaishouAPI, type KuaishouDataOptions, type KuaishouDataOptionsMap, type KuaishouMethodOptionsMap, type KusiahouRequest, KusiahouValidateData, Networks, type NetworksConfigType, type OmitMethodType, type TypeControl, amagi, amagiClient, av2bv, bilibili, bilibiliAPI, bilibiliApiUrls, bilibiliErrorCodeMap, bilibiliUtils, bv2av, type cookiesOptions, Client as default, douyin, douyinAPI, douyinApiUrls, douyinSign, douyinUtils, fetchBilibiliData, fetchDouyinData, fetchKuaishouData, getBilibiliData, getDouyinData, getKuaishouData, kuaishou, kuaishouAPI, kuaishouApiUrls, kuaishouUtils, logMiddleware, logger, qtparam, registerBilibiliRoutes, registerDouyinRoutes, registerKuaishouRoutes, wbi_sign };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikenxuan/amagi",
-  "version": "4.4.16",
+  "version": "4.4.18",
   "description": "抖音、B站的 web 端相关数据接口基于 Node.js 的实现",
   "keywords": [
     "douyin",
@@ -60,8 +60,8 @@
     "sort": "npx sort-package-json"
   },
   "dependencies": {
-    "axios": "npm:@karinjs/axios@^1.1.8",
-    "chalk": "4.1.2",
+    "axios": "npm:@karinjs/axios@^1.2.0",
+    "chalk": "5.4.1",
     "express": "npm:@karinjs/express@^1.0.3",
     "log4js": "npm:@karinjs/log4js@1.1.4",
     "pino-pretty": "^13.0.0"