@perk-net/perk-pushplus-sdk 1.2.0 → 1.2.2

package/dist/index.global.js

@@ -12,6 +12,7 @@ var PerkPushPlus = (function (exports) {
     Channel2["EXTENSION"] = "extension";
     Channel2["APP"] = "app";
     Channel2["CLAWBOT"] = "clawbot";
+    Channel2["QQ"] = "qq";
     return Channel2;
   })(Channel || {});
   var Template = /* @__PURE__ */ ((Template2) => {
@@ -376,6 +377,26 @@ var PerkPushPlus = (function (exports) {
       }
       return parseApiResponse(resp);
     }
+    /**
+     * 执行带二进制请求体的请求并返回原始 ApiResponse（不进行 code 校验）。
+     * 用于 multipart 上传等场景。
+     */
+    async executeRaw(method, path, headers, body) {
+      const url = this.resolveUrl(path);
+      const resp = await callExecuteRaw(this.http, {
+        method,
+        url,
+        headers: headers != null ? headers : void 0,
+        body
+      });
+      if (!isSuccessfulHttpStatus(resp.statusCode)) {
+        throw new PushPlusError(
+          `PushPlus \u63A5\u53E3 HTTP \u8C03\u7528\u5931\u8D25: status=${resp.statusCode}, body=${resp.body}`,
+          resp.statusCode
+        );
+      }
+      return parseApiResponse(resp);
+    }
     /** 执行请求并直接返回 data；非 200 抛出异常。 */
     async executeForData(method, path, headers, body) {
       var _a;
@@ -506,6 +527,39 @@ var PerkPushPlus = (function (exports) {
         (_b = resp.code) != null ? _b : -1
       );
     }
+    /** 以 multipart 上传文件（自动携带 access-key；code=401 时刷新后重试一次）。 */
+    executeOpenMultipart(path, multipart) {
+      return this.executeOpenRaw("POST", path, multipart.body, {
+        "Content-Type": multipart.contentType
+      });
+    }
+    /**
+     * 执行带二进制 body 的开放接口请求；当返回 code=401 时自动刷新 key 并重试一次。
+     */
+    async executeOpenRaw(method, path, body, extraHeaders) {
+      var _a, _b;
+      const headers = { ...await this.headersWithAccessKey(), ...extraHeaders != null ? extraHeaders : {} };
+      const resp = await this.executeRaw(method, path, headers, body);
+      if (isApiSuccess(resp)) {
+        return resp.data;
+      }
+      if (resp.code === _OpenAbstractApi.CODE_ACCESS_KEY_INVALID) {
+        this.accessKeyManager.invalidate();
+        const retryHeaders = { ...await this.headersWithAccessKey(), ...extraHeaders != null ? extraHeaders : {} };
+        const retry = await this.executeRaw(method, path, retryHeaders, body);
+        if (isApiSuccess(retry)) {
+          return retry.data;
+        }
+        throw new PushPlusError(
+          `PushPlus \u5F00\u653E\u63A5\u53E3\u4E1A\u52A1\u5931\u8D25(\u91CD\u8BD5\u540E): code=${retry.code}, msg=${retry.msg}`,
+          (_a = retry.code) != null ? _a : -1
+        );
+      }
+      throw new PushPlusError(
+        `PushPlus \u5F00\u653E\u63A5\u53E3\u4E1A\u52A1\u5931\u8D25: code=${resp.code}, msg=${resp.msg}`,
+        (_b = resp.code) != null ? _b : -1
+      );
+    }
   };
   _OpenAbstractApi.HEADER_ACCESS_KEY = "access-key";
   /** PushPlus AccessKey 失效相关的业务码（用于触发自动重试）。 */
@@ -568,6 +622,50 @@ var PerkPushPlus = (function (exports) {
     }
   };
 
+  // src/multipart.ts
+  function buildFileMultipart(fileName, contentType, fileBytes) {
+    if (fileBytes == null || fileBytes.byteLength === 0) {
+      throw new PushPlusError("\u4E0A\u4F20\u6587\u4EF6\u5185\u5BB9\u4E0D\u80FD\u4E3A\u7A7A");
+    }
+    const safeName = fileName && fileName.trim() ? fileName : "file";
+    const mime = contentType && contentType.trim() ? contentType : "application/octet-stream";
+    const boundary = "----PushPlusBoundary" + randomBoundarySuffix();
+    const crlf = "\r\n";
+    const enc = new TextEncoder();
+    const head = enc.encode(
+      `--${boundary}${crlf}Content-Disposition: form-data; name="file"; filename="${escapeFileName(safeName)}"${crlf}Content-Type: ${mime}${crlf}${crlf}`
+    );
+    const tail = enc.encode(`${crlf}--${boundary}--${crlf}`);
+    const body = new Uint8Array(head.byteLength + fileBytes.byteLength + tail.byteLength);
+    body.set(head, 0);
+    body.set(fileBytes, head.byteLength);
+    body.set(tail, head.byteLength + fileBytes.byteLength);
+    return { contentType: `multipart/form-data; boundary=${boundary}`, body };
+  }
+  async function toFileBytes(file) {
+    if (file instanceof Uint8Array) {
+      return file;
+    }
+    if (file instanceof ArrayBuffer) {
+      return new Uint8Array(file);
+    }
+    if (typeof Blob !== "undefined" && file instanceof Blob) {
+      const ab = await file.arrayBuffer();
+      return new Uint8Array(ab);
+    }
+    throw new PushPlusError(`\u4E0D\u652F\u6301\u7684\u4E0A\u4F20\u6587\u4EF6\u7C7B\u578B: ${Object.prototype.toString.call(file)}`);
+  }
+  function escapeFileName(name) {
+    return name.replace(/"/g, "_").replace(/\r/g, " ").replace(/\n/g, " ");
+  }
+  function randomBoundarySuffix() {
+    let s = "";
+    for (let i = 0; i < 32; i++) {
+      s += Math.floor(Math.random() * 16).toString(16);
+    }
+    return s;
+  }
+
   // src/api/doc-api.ts
   var DocApi = class extends OpenAbstractApi {
     constructor(config, http, mgr) {
@@ -585,6 +683,19 @@ var PerkPushPlus = (function (exports) {
     create(title) {
       return this.executeOpen("POST", "/push/api/open/doc/create", { title });
     }
+    /**
+     * 导入 Word（.docx）创建文档。
+     *
+     * 标题默认取文件名；创建后默认关闭分享，需再调用 publish 才会同步到分享页。
+     */
+    async importWord(file, fileName = "document.docx") {
+      const bytes = await toFileBytes(file);
+      const name = fileName && fileName.trim() ? fileName : "document.docx";
+      return this.executeOpenMultipart(
+        "/push/api/open/doc/import",
+        buildFileMultipart(name, guessDocxContentType(name), bytes)
+      );
+    }
     /** 获取文档元信息与 HTML 草稿正文。 */
     content(docCode) {
       return this.executeOpen(
@@ -626,6 +737,9 @@ var PerkPushPlus = (function (exports) {
       return this.executeOpen("POST", "/push/api/open/doc/updateShare", body);
     }
   };
+  function guessDocxContentType(name) {
+    return name.toLowerCase().endsWith(".docx") ? "application/vnd.openxmlformats-officedocument.wordprocessingml.document" : "application/octet-stream";
+  }
 
   // src/api/excel-api.ts
   var ExcelApi = class extends OpenAbstractApi {
@@ -644,6 +758,19 @@ var PerkPushPlus = (function (exports) {
     create(title) {
       return this.executeOpen("POST", "/push/api/open/excel/create", { title });
     }
+    /**
+     * 导入 Excel（.xlsx / .xls）创建表格。
+     *
+     * 标题默认取文件名；创建后默认关闭分享，需再调用 publish 才会同步到分享页。
+     */
+    async importExcel(file, fileName = "workbook.xlsx") {
+      const bytes = await toFileBytes(file);
+      const name = fileName && fileName.trim() ? fileName : "workbook.xlsx";
+      return this.executeOpenMultipart(
+        "/push/api/open/excel/import",
+        buildFileMultipart(name, guessExcelContentType(name), bytes)
+      );
+    }
     /** 获取表格元信息与整表 JSON 草稿。 */
     content(docCode) {
       return this.executeOpen(
@@ -714,6 +841,16 @@ var PerkPushPlus = (function (exports) {
       throw new PushPlusError(`\u5E8F\u5217\u5316\u8868\u683C\u5185\u5BB9\u5931\u8D25: ${e.message}`, -1, { cause: e });
     }
   }
+  function guessExcelContentType(name) {
+    const lower = name.toLowerCase();
+    if (lower.endsWith(".xlsx")) {
+      return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    }
+    if (lower.endsWith(".xls")) {
+      return "application/vnd.ms-excel";
+    }
+    return "application/octet-stream";
+  }
 
   // src/api/form-api.ts
   var FormApi = class extends OpenAbstractApi {
@@ -809,6 +946,40 @@ var PerkPushPlus = (function (exports) {
     async editRemark(id, remark) {
       await this.executeOpen("POST", "/api/open/friend/editRemark", { id, remark });
     }
+    /**
+     * 5. 将好友加入黑名单。
+     *
+     * 加入后将解除双方好友关系，对方无法再添加你。不能将自己加入黑名单，仅可将已有好友加入黑名单。
+     *
+     * @param friendId 好友 id（好友列表中的 friendId 字段）
+     */
+    async addBlacklist(friendId) {
+      await this.executeOpen(
+        "POST",
+        this.appendQuery("/api/open/friend/addBlacklist", { friendId })
+      );
+    }
+    /** 6. 好友黑名单列表。 */
+    blacklistList(query) {
+      return this.executeOpen(
+        "POST",
+        "/api/open/friend/blacklistList",
+        query != null ? query : {}
+      );
+    }
+    /**
+     * 7. 解除好友黑名单。
+     *
+     * 解除后不会自动恢复好友关系，需重新扫码添加。
+     *
+     * @param id 黑名单记录 ID（黑名单列表中的 id 字段）
+     */
+    async removeBlacklist(id) {
+      await this.executeOpen(
+        "POST",
+        this.appendQuery("/api/open/friend/removeBlacklist", { id })
+      );
+    }
   };
 
   // src/api/image-api.ts
@@ -857,7 +1028,7 @@ var PerkPushPlus = (function (exports) {
       }
       const fileName = options.fileName || "file";
       const contentType = options.contentType || guessContentTypeByName(fileName) || "application/octet-stream";
-      const boundary = "----PushPlusBoundary" + randomBoundarySuffix();
+      const boundary = "----PushPlusBoundary" + randomBoundarySuffix2();
       const body = buildMultipartBody(boundary, uploadToken, fileName, contentType, bytes);
       const resp = await callExecuteRaw(this.http, {
         method: "POST",
@@ -943,7 +1114,7 @@ var PerkPushPlus = (function (exports) {
     const crlf = "\r\n";
     const enc = new TextEncoder();
     const head = enc.encode(
-      `--${boundary}${crlf}Content-Disposition: form-data; name="token"${crlf}${crlf}${uploadToken}${crlf}--${boundary}${crlf}Content-Disposition: form-data; name="file"; filename="${escapeFileName(fileName)}"${crlf}Content-Type: ${contentType}${crlf}${crlf}`
+      `--${boundary}${crlf}Content-Disposition: form-data; name="token"${crlf}${crlf}${uploadToken}${crlf}--${boundary}${crlf}Content-Disposition: form-data; name="file"; filename="${escapeFileName2(fileName)}"${crlf}Content-Type: ${contentType}${crlf}${crlf}`
     );
     const tail = enc.encode(`${crlf}--${boundary}--${crlf}`);
     const out = new Uint8Array(head.byteLength + fileBytes.byteLength + tail.byteLength);
@@ -952,7 +1123,7 @@ var PerkPushPlus = (function (exports) {
     out.set(tail, head.byteLength + fileBytes.byteLength);
     return out;
   }
-  function escapeFileName(name) {
+  function escapeFileName2(name) {
     return name.replace(/"/g, "_").replace(/\r/g, " ").replace(/\n/g, " ");
   }
   function guessContentTypeByName(name) {
@@ -965,7 +1136,7 @@ var PerkPushPlus = (function (exports) {
     if (lower.endsWith(".svg")) return "image/svg+xml";
     return null;
   }
-  function randomBoundarySuffix() {
+  function randomBoundarySuffix2() {
     let s = "";
     for (let i = 0; i < 32; i++) {
       s += Math.floor(Math.random() * 16).toString(16);
@@ -1157,6 +1328,55 @@ var PerkPushPlus = (function (exports) {
     }
   };
 
+  // src/api/qqbot-api.ts
+  var SEND_TYPE_QQ_GROUP = 2;
+  var QqBotApi = class extends OpenAbstractApi {
+    constructor(config, http, mgr) {
+      super(config, http, mgr);
+    }
+    /** 1. 获取绑定链接与绑定码；refresh 为 true 时旧绑定码失效并重新生成。 */
+    getBindLink(refresh = false) {
+      const path = refresh ? this.appendQuery("/api/open/qqBot/getBindLink", { refresh: true }) : "/api/open/qqBot/getBindLink";
+      return this.executeOpen("GET", path);
+    }
+    /** 2. 查询绑定状态。 */
+    botInfo() {
+      return this.executeOpen("GET", "/api/open/qqBot/botInfo");
+    }
+    /** 3. 解绑 QQ 机器人。 */
+    async unbind() {
+      await this.executeOpen("GET", "/api/open/qqBot/unbind");
+    }
+    /** 4. 获取机器人已加入的 QQ 群列表。 */
+    async groupList() {
+      var _a;
+      return (_a = await this.executeOpen("GET", "/api/open/qqBot/groupList")) != null ? _a : [];
+    }
+    /** 5. 获取 QQ 机器人渠道配置列表。 */
+    list(q) {
+      return this.executeOpen("POST", "/api/open/qqBot/list", q != null ? q : {});
+    }
+    /** 6. 新增渠道配置，用于把消息发送到指定 QQ 群；发给自己无需创建配置。 */
+    async add(req) {
+      await this.executeOpen("POST", "/api/open/qqBot/add", withDefaultSendType(req));
+    }
+    /** 7. 修改渠道配置；配置编码不可修改。 */
+    async edit(req) {
+      await this.executeOpen("POST", "/api/open/qqBot/edit", withDefaultSendType(req));
+    }
+    /** 8. 删除渠道配置。 */
+    async delete(id) {
+      await this.executeOpen(
+        "DELETE",
+        this.appendQuery("/api/open/qqBot/delete", { id })
+      );
+    }
+  };
+  function withDefaultSendType(req) {
+    var _a;
+    return { ...req, sendType: (_a = req.sendType) != null ? _a : SEND_TYPE_QQ_GROUP };
+  }
+
   // src/api/setting-api.ts
   var SettingApi = class extends OpenAbstractApi {
     constructor(config, http, mgr) {
@@ -1308,6 +1528,42 @@ var PerkPushPlus = (function (exports) {
     async editRemark(id, remark) {
       await this.executeOpen("POST", "/api/open/topicUser/editRemark", { id, remark });
     }
+    /**
+     * 4. 将订阅人加入黑名单。
+     *
+     * 加入后将移出群组，对方无法再加入该群组。积分群组不支持黑名单。不能将自己加入黑名单。
+     *
+     * @param topicRelationId 用户编号（订阅人列表中的 id 字段）
+     */
+    async addBlacklist(topicRelationId) {
+      const path = this.appendQuery("/api/open/topicUser/addBlacklist", { topicRelationId });
+      await this.executeOpen("POST", path);
+    }
+    /**
+     * 5. 订阅人黑名单列表。
+     *
+     * `query.params.topicId` 必填。
+     */
+    blacklistList(query) {
+      return this.executeOpen(
+        "POST",
+        "/api/open/topicUser/blacklistList",
+        query
+      );
+    }
+    /**
+     * 6. 解除订阅人黑名单。
+     *
+     * 解除后不会自动恢复群组订阅，对方可重新加入该群组。
+     *
+     * @param id 黑名单记录 ID（黑名单列表中的 id 字段）
+     */
+    async removeBlacklist(id) {
+      await this.executeOpen(
+        "POST",
+        this.appendQuery("/api/open/topicUser/removeBlacklist", { id })
+      );
+    }
   };
 
   // src/api/user-api.ts
@@ -1372,7 +1628,7 @@ var PerkPushPlus = (function (exports) {
       logRequest: (_g = cfg.logRequest) != null ? _g : false,
       rateLimitGuardEnabled: (_h = cfg.rateLimitGuardEnabled) != null ? _h : true,
       rateLimitCooldownMs: (_i = cfg.rateLimitCooldownMs) != null ? _i : 0,
-      userAgent: (_j = cfg.userAgent) != null ? _j : `@perk-net/perk-pushplus-sdk/1.2.0`
+      userAgent: (_j = cfg.userAgent) != null ? _j : `@perk-net/perk-pushplus-sdk/1.2.1`
     };
   }
 
@@ -1464,6 +1720,7 @@ var PerkPushPlus = (function (exports) {
       this.webhook = new WebhookApi(this.config, this.httpRequester, this.accessKeyManager);
       this.channel = new ChannelApi(this.config, this.httpRequester, this.accessKeyManager);
       this.clawBot = new ClawBotApi(this.config, this.httpRequester, this.accessKeyManager);
+      this.qqBot = new QqBotApi(this.config, this.httpRequester, this.accessKeyManager);
       this.setting = new SettingApi(this.config, this.httpRequester, this.accessKeyManager);
       this.pre = new PreApi(this.config, this.httpRequester, this.accessKeyManager);
       this.image = new ImageApi(this.config, this.httpRequester, this.accessKeyManager);
@@ -1731,6 +1988,7 @@ var PerkPushPlus = (function (exports) {
   exports.PushPlusClientBuilder = PushPlusClientBuilder;
   exports.PushPlusError = PushPlusError;
   exports.PushPlusException = PushPlusException;
+  exports.QqBotApi = QqBotApi;
   exports.RateLimitGuard = RateLimitGuard;
   exports.SendRequestBuilder = SendRequestBuilder;
   exports.SendStatus = SendStatus;