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

package/README.md

@@ -5,7 +5,7 @@
 - **同时支持 Node.js 与浏览器**：Node.js 18+ 使用内置 `fetch`，浏览器使用原生 `fetch`，无运行时依赖。
 - **三种产物**：CommonJS (`.cjs`) + ESModule (`.js`) + 浏览器 IIFE (`.global.js`)，可通过 npm / `<script>` 直接加载。
 - **完整 TypeScript 类型**：所有请求 / 响应 / 枚举 / 回调全部带类型声明。
-- **全部开放接口**：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、功能设置、预处理、图片服务（含一键上传到 PushPlus 图床）、push 表单、push 文档、push 表格。
+- **全部开放接口**：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、QQ 机器人、功能设置、预处理、图片服务（含一键上传到 PushPlus 图床）、push 表单、push 文档、push 表格。
 - **AccessKey 自动管理**：缓存 + 过期前自动刷新；`code=401` 自动刷新并重试一次。
 - **本地限流守卫**：命中 `code=900` 后按 token 短路同 token 后续发送，避免被服务端长期封禁。
 - **Builder 链式 API**：与 Java/Python SDK 风格保持一致。
@@ -195,6 +195,19 @@ const mps = await client.channel.mpList();
 // ClawBot
 const botQr = await client.clawBot.getBotQrcode();
 
+// QQ 机器人：绑定 -> 认领群 -> 建配置 -> 发到群
+const link = await client.qqBot.getBindLink();   // link.url 生成二维码，或私聊发送 link.bindCode
+const bind = await client.qqBot.botInfo();       // bind.isBind === 1 表示已绑定
+const qqGroups = await client.qqBot.groupList();
+await client.qqBot.add({ qqName: '运维告警群', qqCode: 'ops-group', qqGroupId: qqGroups[0].id });
+await client.send({
+  title: '服务告警',
+  content: '订单服务响应超时',
+  channel: Channel.QQ,
+  option: 'ops-group', // 不传 option 则发给自己
+  template: Template.TXT,
+});
+
 // 设置
 await client.setting.changeIsSend(1); // 启用发送
 await client.setting.changeOpenMessageType(0);

package/dist/index.cjs

@@ -11,6 +11,7 @@ var Channel = /* @__PURE__ */ ((Channel2) => {
   Channel2["EXTENSION"] = "extension";
   Channel2["APP"] = "app";
   Channel2["CLAWBOT"] = "clawbot";
+  Channel2["QQ"] = "qq";
   return Channel2;
 })(Channel || {});
 var Template = /* @__PURE__ */ ((Template2) => {
@@ -1326,6 +1327,55 @@ var PreApi = class extends OpenAbstractApi {
   }
 };
 
+// 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) {
@@ -1669,6 +1719,7 @@ var PushPlusClient = class _PushPlusClient {
     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);
@@ -1936,6 +1987,7 @@ exports.PushPlusClient = PushPlusClient;
 exports.PushPlusClientBuilder = PushPlusClientBuilder;
 exports.PushPlusError = PushPlusError;
 exports.PushPlusException = PushPlusException;
+exports.QqBotApi = QqBotApi;
 exports.RateLimitGuard = RateLimitGuard;
 exports.SendRequestBuilder = SendRequestBuilder;
 exports.SendStatus = SendStatus;