@dorakika/bot-qq 0.0.1

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@dorakika/bot-qq",
+  "version": "0.0.1",
+  "description": "QQ Bot 开发 SDK",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./hono": "./src/adaptor/hono.ts"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "dependencies": {
+    "@stablelib/ed25519": "^2.0.2",
+    "hono": "^4.11.7"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.3"
+  }
+}

package/src/adaptor/hono.ts

@@ -0,0 +1,13 @@
+import { Hono } from "hono";
+import { ApiPayload, QQBot } from "..";
+
+/** 创建hono路由 */
+export function createHonoAdaptor(client: QQBot) {
+    const app = new Hono();
+    app.all('/', async c => {
+        const payload = await c.req.json<ApiPayload>();
+        const result = await client.onPayload(payload);
+        return c.json(result);
+    })
+    return app;
+}

package/src/http/group.ts

@@ -0,0 +1,13 @@
+import type { QQBot } from "..";
+
+export class GroupClient {
+    private client: QQBot;
+    constructor(client: QQBot) {
+        this.client = client;
+    }
+
+    /** 向用户发送单聊消息 */
+    sendMessage(group_openid: string, msg: any) {
+        return this.client.request(`/v2/groups/${group_openid}/messages`, msg);
+    }
+}

package/src/http/users.ts

@@ -0,0 +1,20 @@
+import type { QQBot } from "..";
+
+export class UserClient {
+    private client: QQBot;
+    constructor(client: QQBot) {
+        this.client = client;
+    }
+
+    /** 向用户发送单聊消息 */
+    sendMessage(openid: string, msg: any) {
+        return this.client.request(`/v2/users/${openid}/messages`, msg);
+    }
+
+    /** 撤回消息 */
+    recallMessage(openid: string, msgId: string) {
+        return this.client.request(`/v2/users/${openid}/messages/${msgId}`, {}, 'delete');
+    }
+
+    /** ark */
+}

package/src/index.ts

@@ -0,0 +1,131 @@
+import * as ed from '@stablelib/ed25519';
+import { UserClient } from './http/users';
+import { GroupClient } from './http/group';
+import type { ApiPayload, EventHandlers, EventType } from './types';
+import { Hono } from 'hono';
+
+export * from './types'
+
+interface QQBotOptions {
+    appId: string;
+    clientSecret: string;
+}
+
+export class QQBot {
+    readonly appId: string;
+    readonly clientSecret: string;
+    private eventBus = new EventBus();
+    private baseApiBot = 'https://bots.qq.com';
+    private baseApiSgroup = 'https://api.sgroup.qq.com';
+    constructor({ appId, clientSecret }: QQBotOptions) {
+        this.appId = appId;
+        this.clientSecret = clientSecret;
+        this.generateKeypair(clientSecret);
+    }
+
+    /** 密钥 */
+    private keyPair!: ed.KeyPair;
+    /** 生成密钥 */
+    private generateKeypair(seed: string) {
+        while (seed.length < 32) {
+            seed = seed.repeat(2);
+        }
+        seed = seed.slice(0, 32);
+        this.keyPair = ed.generateKeyPairFromSeed(Buffer.from(seed));
+    }
+    /** 签名 */
+    sign(data: any[]) {
+        const msg = Buffer.from([]);
+        data.forEach(d => {
+            msg.write(d);
+        });
+        const signature = ed.sign(this.keyPair.secretKey, msg);
+        return signature;
+    }
+
+    /** 输入输出payload */
+    async onPayload(payload: any) {
+        if (payload.op === 13) {
+            const signature = this.sign([payload.d.event_ts, payload.d.plain_token]);
+            return { signature, event_ts: payload.d.event_ts };
+        } else if (payload.op === 0) {
+            const eventType = payload.id.split(':')[0];
+            this.eventBus.emit(eventType, payload.d);
+            return {}
+        }
+    }
+
+    /** webhook事件监听 */
+    on<E extends EventType>(eventType: E, callback: EventHandlers[E]) {
+        this.eventBus.on(eventType, callback);
+    }
+    off<E extends EventType>(eventType: E, callback: EventHandlers[E]) {
+        this.eventBus.off(eventType, callback);
+    }
+
+    /** token 过期时间 */
+    private expiredTime: number = 0;
+    /** accessToken */
+    private accessToken: string = "";
+    /** 刷新Token */
+    protected async refreshAccessToken() {
+        const now = Date.now();
+        // 未过期
+        if (now <= this.expiredTime) return;
+
+        const res = await fetch(this.baseApiBot + '/app/getAppAccessToken', {
+            method: 'post',
+            body: JSON.stringify({
+                appId: this.appId,
+                clientSecret: this.clientSecret,
+            }),
+            headers: { 'Content-Type': 'application/json' }
+        }).then(res => res.json());
+        const { access_token, expires_in } = res as any;
+        this.accessToken = access_token;
+        this.expiredTime = now + expires_in * 1000;
+        console.log('refresh accessToken success, expired in', new Date(this.expiredTime).toLocaleString())
+    }
+
+    /** 带鉴权的请求 */
+    async request<Req = Record<string, unknown>, Res = unknown>(url: string, body: Req, method = 'post') {
+        await this.refreshAccessToken();
+        return fetch(this.baseApiSgroup + url, {
+            method,
+            body: JSON.stringify(body),
+            headers: { 'Authorization': `QQBot ${this.accessToken}`, 'Content-Type': 'application/json' }
+        }).then(res => res.json()) as Promise<Res>
+    }
+
+    /** 用户相关 */
+    users = new UserClient(this);
+    /** 群聊相关 */
+    groups = new GroupClient(this);
+}
+
+
+class EventBus {
+    private listeners: { [key: string]: Function[] } = {};
+
+    // 注册事件监听器
+    on(event: string, listener: Function) {
+        if (!this.listeners[event]) {
+            this.listeners[event] = [];
+        }
+        this.listeners[event].push(listener);
+    }
+
+    // 触发事件
+    emit(event: string, ...args: any[]) {
+        if (this.listeners[event]) {
+            this.listeners[event].forEach(listener => listener(...args));
+        }
+    }
+
+    // 移除事件监听器
+    off(event: string, listener: Function) {
+        if (!this.listeners[event]) return;
+
+        this.listeners[event] = this.listeners[event].filter(l => l !== listener);
+    }
+}

package/src/types/index.ts

@@ -0,0 +1,65 @@
+/** Payload类型 */
+export type ApiPayload<OpCode extends number = number, Id = string, D = Record<string, unknown>> = {
+    /** 事件id */
+    id: Id;
+    /** opcode、连接维护 */
+    op: OpCode;
+    /** 下行消息序列号，标识消息唯一性 */
+    s: number;
+    /** 事件类型 */
+    t: string;
+    /** 事件内容 */
+    d: D;
+}
+
+export enum EventType {
+    /** 机器人加入群聊 */
+    GROUP_ADD_ROBOT = 'GROUP_ADD_ROBOT',
+    /** 用户单聊发消息给机器人 */
+    C2C_MESSAGE_CREATE = 'C2C_MESSAGE_CREATE',
+    /** 机器人群聊被@ */
+    GROUP_AT_MESSAGE_CREATE = 'GROUP_AT_MESSAGE_CREATE',
+}
+
+
+/** 用户单聊发送消息给机器人 */
+export interface C2CMessageCreate {
+    /** 平台方消息ID，可以用于被动消息发送 */
+    id: string;
+    author: {
+        /** 用户openid */
+        user_openid: string;
+    };
+    content: string;
+    timestamp: string;
+    attachments: {
+        content_type: 'image/jpeg' | 'image/png' | 'image/gif' | 'file' | 'video/mp4' | 'voice';
+        filename: string;
+        height: number;
+        width: number;
+        size: number;
+        url: string;
+    }[];
+}
+
+/** 机器人群聊被@ */
+export interface GroupAtMessageCreate {
+    id: string;
+    content: string;
+    timestamp: string;
+    author: {
+        id: string;
+        member_openid: string;
+        union_openid: string;
+    };
+    group_id: string;
+    group_openid: string;
+    message_scene: { source: 'default' };
+    message_type: number;
+}
+
+export type EventHandlers = {
+    [EventType.C2C_MESSAGE_CREATE]: (data: C2CMessageCreate) => void;
+    [EventType.GROUP_AT_MESSAGE_CREATE]: (data: GroupAtMessageCreate) => void;
+    [key: string]: (data: any) => void;
+}