kook-client 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# kook-client
+[![CI](https://github.com/zhinjs/kook-client/actions/workflows/release.yaml/badge.svg?branch=master&event=push)](https://github.com/zhinjs/kook-client/actions/workflows/release.yaml)
+[![Docs](https://github.com/zhinjs/kook-client/actions/workflows/docs.yaml/badge.svg?branch=master&event=push)](https://github.com/zhinjs/kook-client/actions/workflows/docs.yaml)
+[![npm version](https://img.shields.io/npm/v/kook-client/latest.svg)](https://www.npmjs.com/package/kook-client)
+[![qq group](https://img.shields.io/badge/group-446290761-blue?style=flat-square&labelColor=FAFAFA&logo=data:image/png;base64,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&logoColor=000000)](https://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=rYaL-gcqTjWYqwBs9TDoVSXKu-i5ircB&authKey=TO02faBOpfhmfkw3YQuUCG2HxUEwWCuFdMBf5nSt3qyWD%2FqaO453O9Dx%2BK8JwBdM&noverify=0&group_code=446290761)
+## 安装依赖
+
+```shell
+npm i kook-client # or yarn add kook-client
+```
+
+## 使用
+
+```js
+const {Client} = require('kook-client')
+// 创建机器人
+const client = new Client({
+	logLevel:'info', // 日志等级
+	ignore:'bot', // 忽略消息配置，可选值为：bot|self
+	token:'', // 机器人秘钥
+	mode:'websocket' // 链接模式
+})
+// 启动机器人
+client.connect()
+```
+
+## 发送消息
+```javascript
+const {Client} = require('kook-client')
+const client = new Client({
+	// ...
+})
+// 只有启动后，才能发送
+client.connect().then(() => {
+	// 频道被动回复
+	client.on('message.channel', (e) => {
+		e.reply('hello world')
+	})
+	// 频道私信被动回复
+	client.on('message.private', (e) => {
+		e.reply('hello world')
+	})
+	// 主动发送频道消息
+	client.sendChannelMsg(channel_id, 'hello')
+	// 主动发送私聊消息
+	client.sendPrivateMsg(user_id, 'hello')
+})
+```
+
+## API
+文档待更新

package/lib/client.js

@@ -0,0 +1,222 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Client_instances, _Client_initChannels, _Client_initUsers, _Client_initBlacklist;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = void 0;
+exports.defineConfig = defineConfig;
+exports.createClient = createClient;
+const baseClient_1 = require("./core/baseClient");
+const guild_1 = require("./entries/guild");
+const channel_1 = require("./entries/channel");
+const user_1 = require("./entries/user");
+const guildMember_1 = require("./entries/guildMember");
+const channelMember_1 = require("./entries/channelMember");
+class Client extends baseClient_1.BaseClient {
+    constructor(config) {
+        super(Object.assign({}, Client.defaultConfig, config));
+        _Client_instances.add(this);
+        this.guilds = new Map();
+        this.blacklist = new Map();
+        this.channels = new Map();
+        this.guildMembers = new Map();
+        this.channelMembers = new Map();
+        this.users = new Map();
+        this.pickGuild = guild_1.Guild.as.bind(this);
+        this.pickGuildMember = guildMember_1.GuildMember.as.bind(this);
+        this.pickChannel = channel_1.Channel.as.bind(this);
+        this.pickChannelMember = channelMember_1.ChannelMember.as.bind(this);
+        this.pickUser = user_1.User.as.bind(this);
+        const nodeVersion = parseInt(process.version.slice(1));
+        if (nodeVersion < 16) {
+            this.logger.warn(`你的node版本(${process.version}) <16，可能会出现不可预测的错误，请升级node版本，为确保服务正常运行，请升级node版本`);
+        }
+        process.on("uncaughtException", e => {
+            this.logger.debug(e.stack);
+        });
+    }
+    get black_user_nums() {
+        return [...this.blacklist.values()].reduce((a, b) => a + b.size, 0);
+    }
+    async getSelfInfo() {
+        const { data } = await this.request.get('/v3/user/me');
+        return data;
+    }
+    async setOnline() {
+        const result = await this.request.post('/v3/user/online');
+        return result['code'] === 0;
+    }
+    async setOffline() {
+        const result = await this.request.post('/v3/user/offline');
+        return result['code'] === 0;
+    }
+    async getOnlineStatus() {
+        const { data } = await this.request.get('/v3/user/get-online-status');
+        return data;
+    }
+    /**
+     * 获取频道列表
+     */
+    async getGuildList() {
+        const _getGuildList = async (page = 1, page_size = 100) => {
+            const res = await this.request.get('/v3/guild/list', {
+                params: {
+                    page,
+                    page_size
+                }
+            }).catch(() => ({ data: { items: [] } })); // 私域不支持获取频道列表，做个兼容
+            if (!res.data.items?.length)
+                return [];
+            const result = res.data.items || [];
+            const { meta: { page_total } } = res.data;
+            if (page === page_total)
+                return result;
+            return [...result, ...await _getGuildList(page + 1)];
+        };
+        return await _getGuildList();
+    }
+    /**
+     * 获取频道信息
+     * @param guild_id
+     */
+    async getGuildInfo(guild_id) {
+        const { data } = await this.request.get(`/v3/guild/view`, {
+            params: { guild_id }
+        });
+        return data;
+    }
+    async getChannelList(guild_id) {
+        const _getChannelList = async (page = 1, page_size = 100) => {
+            const res = await this.request.get(`/v3/channel/list`, {
+                params: {
+                    page,
+                    page_size,
+                    guild_id
+                }
+            }).catch(() => ({ data: { items: [] } })); // 公域没有权限，做个兼容
+            if (!res.data.items?.length)
+                return [];
+            const result = res.data.items || [];
+            if (page === res.data.meta.page_total)
+                return result;
+            return [...result, ...await _getChannelList(page + 1)];
+        };
+        return await _getChannelList();
+    }
+    /**
+     * 获取频道成员列表
+     * @param guild_id
+     * @param channel_id
+     */
+    async getGuildUserList(guild_id, channel_id) {
+        const _getGuildMemberList = async (page = 1, page_size = 100) => {
+            const res = await this.request.get(`/v3/guild/user-list`, {
+                params: {
+                    page,
+                    page_size,
+                    guild_id,
+                    channel_id
+                }
+            }).catch(() => ({ data: { items: [] } })); // 公域没有权限，做个兼容
+            if (!res.data.items?.length)
+                return [];
+            const result = res.data.items || [];
+            if (page === res.data.meta?.page_total)
+                return result;
+            return [...result, ...await _getGuildMemberList(page + 1)];
+        };
+        return await _getGuildMemberList();
+    }
+    async getBlacklist(guild_id) {
+        const { data: { items } } = await this.request.get('/v3/blacklist/list', {
+            params: {
+                guild_id
+            }
+        });
+        return items;
+    }
+    async sendPrivateMsg(user_id, message, quote) {
+        return this.pickUser(user_id).sendMsg(message, quote);
+    }
+    async sendChannelMsg(channel_id, message, quote) {
+        return this.pickChannel(channel_id).sendMsg(message, quote);
+    }
+    async getPrivateMsg(user_id, message_id) {
+        return this.pickUser(user_id).getMsg(message_id);
+    }
+    async getChannelMsg(channel_id, message_id) {
+        return this.pickChannel(channel_id).getMsg(message_id);
+    }
+    async recallPrivateMsg(user_id, message_id) {
+        return this.pickUser(user_id).recallMsg(message_id);
+    }
+    async recallChannelMsg(channel_id, message_is) {
+        return this.pickChannel(channel_id).recallMsg(message_is);
+    }
+    async getPrivateChatHistory(user_id, message_id, len = 50) {
+        return this.pickUser(user_id).getChatHistory(message_id, len);
+    }
+    async getChannelChatHistory(channel_id, message_id, len = 50) {
+        return this.pickChannel(channel_id).getChatHistory(message_id, len);
+    }
+    async init() {
+        const userInfo = await this.getSelfInfo();
+        this.self_id = userInfo.id;
+        this.nickname = userInfo.nickname;
+        this.logger.info(`welcome ${this.nickname}, 正在加载资源...`);
+        const guilds = await this.getGuildList();
+        for (const guildInfo of guilds) {
+            this.guilds.set(guildInfo.id, guildInfo);
+            await __classPrivateFieldGet(this, _Client_instances, "m", _Client_initChannels).call(this, guildInfo.id);
+            await __classPrivateFieldGet(this, _Client_instances, "m", _Client_initUsers).call(this, guildInfo.id);
+            await __classPrivateFieldGet(this, _Client_instances, "m", _Client_initBlacklist).call(this, guildInfo.id);
+        }
+        this.logger.info(`加载了${this.guilds.size}个服务器，共计${this.channels.size}个频道,${this.users.size}个用户,${this.blacklist.size}个黑名单用户`);
+    }
+    async connect() {
+        await this.receiver.connect();
+        return this.init();
+    }
+    async disconnect() {
+        await this.receiver.disconnect();
+    }
+}
+exports.Client = Client;
+_Client_instances = new WeakSet(), _Client_initChannels = async function _Client_initChannels(guild_id) {
+    const channels = await this.getChannelList(guild_id);
+    for (const channel of channels) {
+        this.channelMembers.set(channel.id, new Map());
+        this.channels.set(channel.id, channel);
+        const channelMembers = await this.getGuildUserList(guild_id, channel.id);
+        for (const temp of channelMembers) {
+            const userInfo = this.users.get(temp.id) || temp;
+            this.channelMembers.get(channel.id)?.set(userInfo.id, userInfo);
+        }
+    }
+}, _Client_initUsers = async function _Client_initUsers(guild_id) {
+    this.guildMembers.set(guild_id, new Map());
+    const users = await this.getGuildUserList(guild_id);
+    for (const temp of users) {
+        const user = this.users.get(temp.id) || temp;
+        this.guildMembers.get(guild_id)?.set(user.id, user);
+        this.users.set(user.id, user);
+    }
+}, _Client_initBlacklist = async function _Client_initBlacklist(guild_id) {
+    this.blacklist.set(guild_id, new Map());
+    const blacklist = await this.getBlacklist(guild_id);
+    for (const temp of blacklist) {
+        this.blacklist.get(guild_id)?.set(temp.user_id, temp);
+    }
+};
+(function (Client) {
+    Client.defaultConfig = {};
+})(Client || (exports.Client = Client = {}));
+function defineConfig(config) {
+    return config;
+}
+function createClient(config) {
+    return new Client(config);
+}

package/lib/constans.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotifyType = exports.ChannelType = exports.UnsupportedMethodError = exports.OpCode = void 0;
+// 心跳参数
+var OpCode;
+(function (OpCode) {
+    OpCode[OpCode["Event"] = 0] = "Event";
+    OpCode[OpCode["Hello"] = 1] = "Hello";
+    OpCode[OpCode["Ping"] = 2] = "Ping";
+    OpCode[OpCode["Pong"] = 3] = "Pong";
+    OpCode[OpCode["Reconnect"] = 5] = "Reconnect";
+    OpCode[OpCode["ResumeAck"] = 6] = "ResumeAck";
+})(OpCode || (exports.OpCode = OpCode = {}));
+exports.UnsupportedMethodError = new Error('暂未支持');
+var ChannelType;
+(function (ChannelType) {
+    ChannelType["Channel"] = "GROUP";
+    ChannelType["Private"] = "PERSON";
+    ChannelType["Notice"] = "BROADCAST";
+})(ChannelType || (exports.ChannelType = ChannelType = {}));
+var NotifyType;
+(function (NotifyType) {
+    NotifyType[NotifyType["Default"] = 0] = "Default";
+    NotifyType[NotifyType["All"] = 1] = "All";
+    NotifyType[NotifyType["At"] = 2] = "At";
+    NotifyType[NotifyType["Off"] = 3] = "Off";
+})(NotifyType || (exports.NotifyType = NotifyType = {}));

package/lib/core/baseClient.js

@@ -0,0 +1,166 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const form_data_1 = __importDefault(require("form-data"));
+const log4js = __importStar(require("log4js"));
+const events_1 = require("events");
+const utils_1 = require("../utils");
+const receiver_1 = require("../core/receiver");
+class BaseClient extends events_1.EventEmitter {
+    constructor(config) {
+        var _a;
+        super();
+        this.processedEvents = new Set();
+        this.config = Object.assign({}, BaseClient.defaultConfig, config);
+        this.request = axios_1.default.create({
+            baseURL: 'https://www.kookapp.cn/api',
+            timeout: config.timeout || 5000,
+            headers: {
+                'User-Agent': `NodeJSSDK/0.0.1`
+            }
+        });
+        this.request.interceptors.request.use((config) => {
+            config.headers['Authorization'] = `Bot ${this.config.token}`;
+            config.headers['Accept-Language'] = this.config.language;
+            if (config['rest']) {
+                const restObj = config['rest'];
+                delete config['rest'];
+                for (const key in restObj) {
+                    config.url = config.url.replace(':' + key, restObj[key]);
+                }
+            }
+            if (config.headers['Content-Type'] === 'multipart/form-data') {
+                delete config.data.message_reference;
+                const formData = new form_data_1.default(); // 使用 form-data
+                for (const key in config.data) {
+                    if (config.data[key] !== undefined) {
+                        formData.append(key, config.data[key]); // 使用 append 而不是 set
+                    }
+                }
+                config.data = formData;
+            }
+            return config;
+        });
+        this.request.interceptors.response.use((res) => res.data, (res) => {
+            if (!res || !res.response || !res.response.data)
+                return Promise.reject(res);
+            const { code = res?.response.status, message = res?.response.statusText } = res?.response?.data || {};
+            const err = new Error(`request "${res.config.url}" error with code(${code}): ${message}`);
+            return Promise.reject(err);
+        });
+        this.logger = log4js.getLogger(`[KOOK]`);
+        this.logger.level = (_a = this.config).logLevel || (_a.logLevel = 'info');
+        this.receiver = receiver_1.Receiver.create(config.mode, this, config);
+        this.logger.info(`using ${config.mode} mode`);
+    }
+    /**
+ * 上传多媒体文件
+ * @param data 文件数据：可以是本地文件(file://)或网络地址(http://)或base64或Buffer
+ * @returns 返回可直接访问的文件URL
+ */
+    async uploadMedia(data) {
+        const formData = new form_data_1.default();
+        const fileData = await (0, utils_1.getFile)(data);
+        // console.error(await getFile(data));
+        formData.append('file', fileData, 'awa.png'); // 显式指定文件名
+        try {
+            const response = await this.request.post(`/v3/asset/create`, formData, {
+                headers: {
+                    ...formData.getHeaders(), // 自动设置 Content-Type
+                    'Accept': 'application/json',
+                },
+            });
+            // console.log("fileData结果:", fileData); // 调试日志
+            // console.log("Data结果:", data); // 调试日志
+            const url = response.data?.url;
+            if (!url) {
+                throw new Error(`Invalid response: ${JSON.stringify(response.data)}`);
+            }
+            return url;
+        }
+        catch (error) {
+            // console.error("Upload failed:", error.response?.data || error.message);
+            throw new Error(`Upload failed: ${error.message}`);
+        }
+    }
+    em(event, payload) {
+        // 添加消息去重逻辑 - 放在方法最前面
+        const eventId = payload.msg_id || payload.event_id;
+        if (eventId && this.processedEvents.has(eventId)) {
+            this.logger.debug(`Ignoring duplicate event: ${eventId}`);
+            return;
+        }
+        // 记录已处理事件
+        if (eventId)
+            this.processedEvents.add(eventId);
+        // 原始事件处理逻辑
+        const eventNames = event.split('.');
+        const [post_type, detail_type, ...sub_type] = eventNames;
+        Object.assign(payload, {
+            post_type,
+            [`${post_type}_type`]: detail_type,
+            sub_type: sub_type.join('.'),
+            ...payload
+        });
+        let prefix = '';
+        while (eventNames.length) {
+            let fullEventName = `${prefix}.${eventNames.shift()}`;
+            if (fullEventName.startsWith('.'))
+                fullEventName = fullEventName.slice(1);
+            this.emit(fullEventName, payload);
+            prefix = fullEventName;
+        }
+    }
+}
+exports.BaseClient = BaseClient;
+(function (BaseClient) {
+    BaseClient.defaultConfig = {
+        ignore: 'bot'
+    };
+    function getFullTargetId(message) {
+        switch (message.message_type) {
+            case "private":
+                return `private-${message.author_id}`;
+            case "channel":
+                return `channel-${message.channel_id}:${message.author_id}`;
+        }
+    }
+    BaseClient.getFullTargetId = getFullTargetId;
+})(BaseClient || (exports.BaseClient = BaseClient = {}));

package/lib/core/receiver.js

@@ -0,0 +1,88 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Receiver_instances, _Receiver_transformEvent, _Receiver_transformChannelEvent, _Receiver_transformPrivateEvent, _Receiver_transformNoticeEvent;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Receiver = void 0;
+const events_1 = require("events");
+const crypto_1 = require("crypto");
+const constans_1 = require("../constans");
+const event_1 = require("../event");
+class Receiver extends events_1.EventEmitter {
+    constructor(c) {
+        super();
+        _Receiver_instances.add(this);
+        this.c = c;
+        this.sn = 0;
+        this.buffer = [];
+        this.on("event", __classPrivateFieldGet(this, _Receiver_instances, "m", _Receiver_transformEvent).bind(this));
+    }
+    reset() {
+        this.sn = 0;
+        this.buffer = [];
+    }
+    decryptData(data, key) {
+        if (!this.compress)
+            return data;
+        const decodeData = Buffer.from(data, 'base64');
+        const iv = decodeData.subarray(0, 16).toString('utf8');
+        const encryptedData = decodeData.subarray(16);
+        const finalKey = key.padEnd(32, '0');
+        const finalKeyBuf = Buffer.from(finalKey, 'utf8');
+        const finalIvBuf = Buffer.from(iv, 'utf8');
+        const decipher = (0, crypto_1.createDecipheriv)('aes-256-cbc', finalKeyBuf, finalIvBuf);
+        const decryptedData = decipher.update(encryptedData);
+        return decryptedData.toString('utf8') + decipher.final().toString('utf8');
+    }
+}
+exports.Receiver = Receiver;
+_Receiver_instances = new WeakSet(), _Receiver_transformEvent = function _Receiver_transformEvent(event) {
+    switch (event.channel_type) {
+        case constans_1.ChannelType.Channel:
+            return __classPrivateFieldGet(this, _Receiver_instances, "m", _Receiver_transformChannelEvent).call(this, event);
+        case constans_1.ChannelType.Private:
+            return __classPrivateFieldGet(this, _Receiver_instances, "m", _Receiver_transformPrivateEvent).call(this, event);
+        case constans_1.ChannelType.Notice:
+            return __classPrivateFieldGet(this, _Receiver_instances, "m", _Receiver_transformNoticeEvent).call(this, event);
+        default:
+            throw new Error(`unknown channel type ${event.channel_type}`);
+    }
+}, _Receiver_transformChannelEvent = function _Receiver_transformChannelEvent(event) {
+    if (event.type === 255)
+        return __classPrivateFieldGet(this, _Receiver_instances, "m", _Receiver_transformNoticeEvent).call(this, event);
+    if (event.extra?.author?.bot && this.c.config.ignore === 'bot')
+        return;
+    if (event.author_id === this.c.self_id && this.c.config.ignore === 'self')
+        return;
+    const messageEvent = new event_1.ChannelMessageEvent(this.c, event);
+    this.c.em('message.channel', messageEvent);
+    this.c.logger.info(`recv from Channel(${messageEvent.channel_id}): ${messageEvent.raw_message}`);
+}, _Receiver_transformPrivateEvent = function _Receiver_transformPrivateEvent(event) {
+    if (event.type === 255)
+        return __classPrivateFieldGet(this, _Receiver_instances, "m", _Receiver_transformNoticeEvent).call(this, event);
+    if (event.extra?.author?.bot && this.c.config.ignore === 'bot')
+        return;
+    if (event.author_id === this.c.self_id && this.c.config.ignore === 'self')
+        return;
+    const messageEvent = new event_1.PrivateMessageEvent(this.c, event);
+    this.c.em('message.private', messageEvent);
+    this.c.logger.info(`recv from User(${messageEvent.author_id}): ${messageEvent.raw_message}`);
+}, _Receiver_transformNoticeEvent = function _Receiver_transformNoticeEvent(event) {
+};
+(function (Receiver) {
+    const adapters = new Map;
+    function register(mode, receiver) {
+        adapters.set(mode, receiver);
+    }
+    Receiver.register = register;
+    function create(mode, ...args) {
+        const Construct = adapters.get(mode);
+        if (!Construct)
+            throw new Error(`未找到${mode}模式的接收器`);
+        return new Construct(...args);
+    }
+    Receiver.create = create;
+})(Receiver || (exports.Receiver = Receiver = {}));

package/lib/core/receivers/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebsocketReceiver = exports.WebhookReceiver = void 0;
+var webhook_1 = require("./webhook");
+Object.defineProperty(exports, "WebhookReceiver", { enumerable: true, get: function () { return webhook_1.WebhookReceiver; } });
+var websocket_1 = require("./websocket");
+Object.defineProperty(exports, "WebsocketReceiver", { enumerable: true, get: function () { return websocket_1.WebsocketReceiver; } });

package/lib/core/receivers/webhook.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookReceiver = void 0;
+const receiver_1 = require("../../core/receiver");
+class WebhookReceiver extends receiver_1.Receiver {
+    constructor(client, config) {
+        super(client);
+        this.config = config;
+    }
+    connect() {
+        return Promise.resolve(undefined);
+    }
+    disconnect() {
+        return Promise.resolve(undefined);
+    }
+}
+exports.WebhookReceiver = WebhookReceiver;
+receiver_1.Receiver.register('webhook', WebhookReceiver);