@onebots/adapter-discord 1.0.0

package/lib/lite/bot.js

@@ -0,0 +1,527 @@
+/**
+ * Discord Lite Bot 客户端
+ * 轻量版实现，不依赖 discord.js，支持 Cloudflare Workers
+ */
+import { EventEmitter } from 'events';
+import { DiscordLite, GatewayIntents } from './index.js';
+/**
+ * Discord Lite Bot
+ * 基于轻量客户端实现，兼容 Node.js 和 Cloudflare Workers
+ */
+export class DiscordLiteBot extends EventEmitter {
+    client;
+    config;
+    ready = false;
+    user = null;
+    guilds = new Map();
+    constructor(config) {
+        super();
+        this.config = config;
+        // 解析 intents
+        const intents = this.parseIntents(config.intents);
+        const clientOptions = {
+            token: config.token,
+            intents,
+            proxy: config.proxy,
+            mode: config.mode,
+            applicationId: config.application_id,
+            publicKey: config.public_key,
+        };
+        this.client = new DiscordLite(clientOptions);
+        this.setupEventListeners();
+    }
+    /**
+     * 解析 intents 配置
+     */
+    parseIntents(intentsConfig) {
+        if (typeof intentsConfig === 'number') {
+            return intentsConfig;
+        }
+        if (!intentsConfig || intentsConfig.length === 0) {
+            // 默认 intents
+            return (GatewayIntents.Guilds |
+                GatewayIntents.GuildMessages |
+                GatewayIntents.GuildMembers |
+                GatewayIntents.GuildMessageReactions |
+                GatewayIntents.DirectMessages |
+                GatewayIntents.DirectMessageReactions |
+                GatewayIntents.MessageContent);
+        }
+        let result = 0;
+        const intentMap = {
+            'Guilds': GatewayIntents.Guilds,
+            'GuildMembers': GatewayIntents.GuildMembers,
+            'GuildModeration': GatewayIntents.GuildModeration,
+            'GuildEmojisAndStickers': GatewayIntents.GuildEmojisAndStickers,
+            'GuildIntegrations': GatewayIntents.GuildIntegrations,
+            'GuildWebhooks': GatewayIntents.GuildWebhooks,
+            'GuildInvites': GatewayIntents.GuildInvites,
+            'GuildVoiceStates': GatewayIntents.GuildVoiceStates,
+            'GuildPresences': GatewayIntents.GuildPresences,
+            'GuildMessages': GatewayIntents.GuildMessages,
+            'GuildMessageReactions': GatewayIntents.GuildMessageReactions,
+            'GuildMessageTyping': GatewayIntents.GuildMessageTyping,
+            'DirectMessages': GatewayIntents.DirectMessages,
+            'DirectMessageReactions': GatewayIntents.DirectMessageReactions,
+            'DirectMessageTyping': GatewayIntents.DirectMessageTyping,
+            'MessageContent': GatewayIntents.MessageContent,
+            'GuildScheduledEvents': GatewayIntents.GuildScheduledEvents,
+        };
+        for (const intent of intentsConfig) {
+            if (intent in intentMap) {
+                result |= intentMap[intent];
+            }
+        }
+        return result;
+    }
+    /**
+     * 设置事件监听器
+     */
+    setupEventListeners() {
+        this.client.on('ready', (user) => {
+            this.ready = true;
+            this.user = user;
+            this.emit('ready', this.wrapUser(user));
+        });
+        this.client.on('messageCreate', (message) => {
+            this.emit('messageCreate', this.wrapMessage(message));
+        });
+        this.client.on('messageUpdate', (message) => {
+            this.emit('messageUpdate', null, this.wrapMessage(message));
+        });
+        this.client.on('messageDelete', (data) => {
+            this.emit('messageDelete', data);
+        });
+        this.client.on('guildCreate', (guild) => {
+            this.guilds.set(guild.id, guild);
+            this.emit('guildCreate', guild);
+        });
+        this.client.on('guildDelete', (guild) => {
+            this.guilds.delete(guild.id);
+            this.emit('guildDelete', guild);
+        });
+        this.client.on('guildMemberAdd', (member) => {
+            this.emit('guildMemberAdd', member);
+        });
+        this.client.on('guildMemberRemove', (member) => {
+            this.emit('guildMemberRemove', member);
+        });
+        this.client.on('interactionCreate', (interaction) => {
+            this.emit('interactionCreate', interaction);
+        });
+        this.client.on('error', (error) => {
+            this.emit('error', error);
+        });
+        this.client.on('close', (code, reason) => {
+            this.ready = false;
+            this.emit('close', code, reason);
+        });
+    }
+    // ============================================
+    // 生命周期管理
+    // ============================================
+    /**
+     * 启动 Bot (Gateway 模式)
+     */
+    async start() {
+        try {
+            await this.client.start();
+        }
+        catch (error) {
+            this.emit('error', error);
+            throw error;
+        }
+    }
+    /**
+     * 停止 Bot
+     */
+    async stop() {
+        this.ready = false;
+        this.client.stop();
+        this.emit('stopped');
+    }
+    /**
+     * 处理 HTTP 请求 (Interactions 模式)
+     */
+    async handleRequest(request) {
+        return this.client.handleRequest(request);
+    }
+    /**
+     * 获取 Bot 是否就绪
+     */
+    isReady() {
+        return this.ready;
+    }
+    // ============================================
+    // 消息相关方法
+    // ============================================
+    /**
+     * 发送消息到频道
+     */
+    async sendMessage(channelId, content) {
+        const body = typeof content === 'string' ? { content } : content;
+        const result = await this.getREST().createMessage(channelId, body);
+        return this.wrapMessage(result);
+    }
+    /**
+     * 发送私信
+     */
+    async sendDM(userId, content) {
+        // 首先创建 DM 频道
+        const dmChannel = await this.getREST().request('/users/@me/channels', {
+            method: 'POST',
+            body: { recipient_id: userId },
+        });
+        return this.sendMessage(dmChannel.id, content);
+    }
+    /**
+     * 发送 Embed 消息
+     */
+    async sendEmbed(channelId, embeds) {
+        return this.sendMessage(channelId, { embeds });
+    }
+    /**
+     * 发送带附件的消息
+     */
+    async sendWithAttachments(channelId, content, _attachments) {
+        // 轻量版暂不支持附件上传，仅发送文本
+        return this.sendMessage(channelId, content);
+    }
+    /**
+     * 编辑消息
+     */
+    async editMessage(channelId, messageId, content) {
+        const result = await this.getREST().editMessage(channelId, messageId, content);
+        return this.wrapMessage(result);
+    }
+    /**
+     * 删除消息
+     */
+    async deleteMessage(channelId, messageId) {
+        await this.getREST().deleteMessage(channelId, messageId);
+    }
+    /**
+     * 获取消息
+     */
+    async getMessage(channelId, messageId) {
+        const result = await this.getREST().getMessage(channelId, messageId);
+        return this.wrapMessage(result);
+    }
+    /**
+     * 获取消息历史
+     */
+    async getMessageHistory(channelId, limit = 50, before) {
+        const query = { limit: String(limit) };
+        if (before)
+            query.before = before;
+        const messages = await this.getREST().getMessages(channelId, query);
+        const map = new Map();
+        for (const msg of messages) {
+            map.set(msg.id, this.wrapMessage(msg));
+        }
+        return map;
+    }
+    /**
+     * 添加消息反应
+     */
+    async addReaction(channelId, messageId, emoji) {
+        const encodedEmoji = encodeURIComponent(emoji);
+        await this.getREST().request(`/channels/${channelId}/messages/${messageId}/reactions/${encodedEmoji}/@me`, {
+            method: 'PUT',
+        });
+    }
+    /**
+     * 移除消息反应
+     */
+    async removeReaction(channelId, messageId, emoji, userId) {
+        const encodedEmoji = encodeURIComponent(emoji);
+        const target = userId || '@me';
+        await this.getREST().request(`/channels/${channelId}/messages/${messageId}/reactions/${encodedEmoji}/${target}`, {
+            method: 'DELETE',
+        });
+    }
+    // ============================================
+    // 用户相关方法
+    // ============================================
+    /**
+     * 获取机器人信息
+     */
+    getBotUser() {
+        return this.user ? this.wrapUser(this.user) : null;
+    }
+    /**
+     * 获取用户信息
+     */
+    async getUser(userId) {
+        const result = await this.getREST().getUser(userId);
+        return this.wrapUser(result);
+    }
+    /**
+     * 获取成员信息
+     */
+    async getMember(guildId, userId) {
+        return this.getREST().getGuildMember(guildId, userId);
+    }
+    // ============================================
+    // 服务器（Guild）相关方法
+    // ============================================
+    /**
+     * 获取服务器列表
+     */
+    getGuilds() {
+        return this.guilds;
+    }
+    /**
+     * 获取服务器信息
+     */
+    async getGuild(guildId) {
+        const result = await this.getREST().getGuild(guildId);
+        this.guilds.set(result.id, result);
+        return result;
+    }
+    /**
+     * 获取服务器成员列表
+     */
+    async getGuildMembers(guildId, limit) {
+        const query = {};
+        if (limit)
+            query.limit = String(limit);
+        const members = await this.getREST().getGuildMembers(guildId, query);
+        const map = new Map();
+        for (const member of members) {
+            map.set(member.user.id, member);
+        }
+        return map;
+    }
+    /**
+     * 获取服务器成员信息
+     */
+    async getGuildMember(guildId, userId) {
+        return this.getREST().getGuildMember(guildId, userId);
+    }
+    /**
+     * 踢出成员
+     */
+    async kickMember(guildId, userId, _reason) {
+        await this.getREST().removeGuildMember(guildId, userId);
+    }
+    /**
+     * 封禁成员
+     */
+    async banMember(guildId, userId, options) {
+        await this.getREST().banGuildMember(guildId, userId, {
+            delete_message_seconds: options?.deleteMessageSeconds,
+        });
+    }
+    /**
+     * 解除封禁
+     */
+    async unbanMember(guildId, userId, _reason) {
+        await this.getREST().request(`/guilds/${guildId}/bans/${userId}`, {
+            method: 'DELETE',
+        });
+    }
+    /**
+     * 禁言成员（超时）
+     */
+    async timeoutMember(guildId, userId, duration, _reason) {
+        const until = new Date(Date.now() + duration * 1000).toISOString();
+        return this.getREST().request(`/guilds/${guildId}/members/${userId}`, {
+            method: 'PATCH',
+            body: { communication_disabled_until: until },
+        });
+    }
+    /**
+     * 解除禁言
+     */
+    async removeTimeout(guildId, userId, _reason) {
+        return this.getREST().request(`/guilds/${guildId}/members/${userId}`, {
+            method: 'PATCH',
+            body: { communication_disabled_until: null },
+        });
+    }
+    /**
+     * 修改成员昵称
+     */
+    async setMemberNickname(guildId, userId, nickname, _reason) {
+        return this.getREST().request(`/guilds/${guildId}/members/${userId}`, {
+            method: 'PATCH',
+            body: { nick: nickname },
+        });
+    }
+    /**
+     * 添加角色
+     */
+    async addRole(guildId, userId, roleId, _reason) {
+        await this.getREST().request(`/guilds/${guildId}/members/${userId}/roles/${roleId}`, {
+            method: 'PUT',
+        });
+        return this.getGuildMember(guildId, userId);
+    }
+    /**
+     * 移除角色
+     */
+    async removeRole(guildId, userId, roleId, _reason) {
+        await this.getREST().request(`/guilds/${guildId}/members/${userId}/roles/${roleId}`, {
+            method: 'DELETE',
+        });
+        return this.getGuildMember(guildId, userId);
+    }
+    // ============================================
+    // 频道相关方法
+    // ============================================
+    /**
+     * 获取频道
+     */
+    async getChannel(channelId) {
+        try {
+            return await this.getREST().getChannel(channelId);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 获取服务器频道列表
+     */
+    async getGuildChannels(guildId) {
+        const channels = await this.getREST().request(`/guilds/${guildId}/channels`);
+        const map = new Map();
+        for (const channel of channels) {
+            map.set(channel.id, channel);
+        }
+        return map;
+    }
+    /**
+     * 创建文本频道
+     */
+    async createTextChannel(guildId, name, options) {
+        return this.getREST().request(`/guilds/${guildId}/channels`, {
+            method: 'POST',
+            body: {
+                name,
+                type: 0, // GUILD_TEXT
+                topic: options?.topic,
+                parent_id: options?.parent,
+                nsfw: options?.nsfw,
+            },
+        });
+    }
+    /**
+     * 删除频道
+     */
+    async deleteChannel(channelId) {
+        await this.getREST().request(`/channels/${channelId}`, {
+            method: 'DELETE',
+        });
+    }
+    /**
+     * 更新频道
+     */
+    async updateChannel(channelId, options) {
+        return this.getREST().request(`/channels/${channelId}`, {
+            method: 'PATCH',
+            body: {
+                name: options.name,
+                topic: options.topic,
+                nsfw: options.nsfw,
+                parent_id: options.parent,
+            },
+        });
+    }
+    // ============================================
+    // 角色相关方法
+    // ============================================
+    /**
+     * 获取服务器角色列表
+     */
+    async getGuildRoles(guildId) {
+        const roles = await this.getREST().request(`/guilds/${guildId}/roles`);
+        const map = new Map();
+        for (const role of roles) {
+            map.set(role.id, role);
+        }
+        return map;
+    }
+    /**
+     * 获取角色信息
+     */
+    async getRole(guildId, roleId) {
+        const roles = await this.getGuildRoles(guildId);
+        return roles.get(roleId) || null;
+    }
+    /**
+     * 创建角色
+     */
+    async createRole(guildId, options) {
+        return this.getREST().request(`/guilds/${guildId}/roles`, {
+            method: 'POST',
+            body: {
+                name: options.name,
+                color: options.color,
+                hoist: options.hoist,
+                mentionable: options.mentionable,
+                permissions: options.permissions?.toString(),
+            },
+        });
+    }
+    /**
+     * 删除角色
+     */
+    async deleteRole(guildId, roleId) {
+        await this.getREST().request(`/guilds/${guildId}/roles/${roleId}`, {
+            method: 'DELETE',
+        });
+    }
+    // ============================================
+    // 工具方法
+    // ============================================
+    /**
+     * 获取 REST 客户端
+     */
+    getREST() {
+        return this.client.getREST();
+    }
+    /**
+     * 获取原始 Discord Lite 客户端
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * 获取当前运行模式
+     */
+    getMode() {
+        return this.client.getMode();
+    }
+    /**
+     * 包装用户对象（添加辅助方法）
+     */
+    wrapUser(user) {
+        return {
+            ...user,
+            global_name: user.global_name || user.globalName,
+            displayAvatarURL: () => {
+                if (user.avatar) {
+                    return `https://cdn.discordapp.com/avatars/${user.id}/${user.avatar}.png`;
+                }
+                const defaultAvatar = parseInt(user.discriminator || '0') % 5;
+                return `https://cdn.discordapp.com/embed/avatars/${defaultAvatar}.png`;
+            },
+            tag: `${user.username}#${user.discriminator || '0'}`,
+        };
+    }
+    /**
+     * 包装消息对象
+     */
+    wrapMessage(message) {
+        return {
+            ...message,
+            createdTimestamp: new Date(message.timestamp).getTime(),
+            channel: { id: message.channel_id, type: message.guild_id ? 0 : 1 },
+            guild: message.guild_id ? { id: message.guild_id } : undefined,
+            author: this.wrapUser(message.author),
+        };
+    }
+}
+//# sourceMappingURL=bot.js.map

package/lib/lite/gateway.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Discord Gateway WebSocket 客户端
+ * 用于 Node.js 环境
+ */
+import { EventEmitter } from 'events';
+import { DiscordREST } from './rest.js';
+export declare enum GatewayOpcodes {
+    Dispatch = 0,
+    Heartbeat = 1,
+    Identify = 2,
+    PresenceUpdate = 3,
+    VoiceStateUpdate = 4,
+    Resume = 6,
+    Reconnect = 7,
+    RequestGuildMembers = 8,
+    InvalidSession = 9,
+    Hello = 10,
+    HeartbeatAck = 11
+}
+export declare enum GatewayIntents {
+    Guilds = 1,
+    GuildMembers = 2,
+    GuildModeration = 4,
+    GuildEmojisAndStickers = 8,
+    GuildIntegrations = 16,
+    GuildWebhooks = 32,
+    GuildInvites = 64,
+    GuildVoiceStates = 128,
+    GuildPresences = 256,
+    GuildMessages = 512,
+    GuildMessageReactions = 1024,
+    GuildMessageTyping = 2048,
+    DirectMessages = 4096,
+    DirectMessageReactions = 8192,
+    DirectMessageTyping = 16384,
+    MessageContent = 32768,
+    GuildScheduledEvents = 65536,
+    AutoModerationConfiguration = 1048576,
+    AutoModerationExecution = 2097152
+}
+export interface GatewayOptions {
+    token: string;
+    intents: number;
+    proxy?: {
+        url: string;
+        username?: string;
+        password?: string;
+    };
+}
+export declare class DiscordGateway extends EventEmitter {
+    private ws;
+    private token;
+    private intents;
+    private proxyUrl?;
+    private heartbeatInterval;
+    private sequence;
+    private sessionId;
+    private resumeGatewayUrl;
+    private rest;
+    private isReady;
+    constructor(options: GatewayOptions);
+    /**
+     * 连接 Gateway
+     */
+    connect(): Promise<void>;
+    /**
+     * 连接到指定 Gateway URL
+     */
+    private connectToGateway;
+    /**
+     * 处理 Gateway 消息
+     */
+    private handleMessage;
+    /**
+     * 处理 Dispatch 事件
+     */
+    private handleDispatch;
+    /**
+     * 发送 Identify
+     */
+    private identify;
+    /**
+     * 发送 Resume
+     */
+    private resume;
+    /**
+     * 开始心跳
+     */
+    private startHeartbeat;
+    /**
+     * 停止心跳
+     */
+    private stopHeartbeat;
+    /**
+     * 发送心跳
+     */
+    private sendHeartbeat;
+    /**
+     * 发送数据
+     */
+    private send;
+    /**
+     * 重连
+     */
+    private reconnect;
+    /**
+     * 清理资源
+     */
+    private cleanup;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 获取 REST 客户端
+     */
+    getREST(): DiscordREST;
+}
+//# sourceMappingURL=gateway.d.ts.map