@onebots/adapter-discord 1.0.0

package/lib/bot.js

@@ -0,0 +1,526 @@
+/**
+ * Discord Bot 客户端
+ * 轻量版实现，直接封装 Discord API，支持 Node.js 和 Cloudflare Workers
+ */
+import { EventEmitter } from 'events';
+import { DiscordLite, GatewayIntents } from './lite/index.js';
+/**
+ * Discord Bot
+ * 基于轻量客户端实现，兼容 Node.js 和 Cloudflare Workers
+ */
+export class DiscordBot 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: 'gateway',
+        };
+        this.client = new DiscordLite(clientOptions);
+        this.setupEventListeners();
+    }
+    /**
+     * 解析 intents 配置
+     */
+    parseIntents(intentsConfig) {
+        if (!intentsConfig || intentsConfig.length === 0) {
+            // 默认 intents
+            return (GatewayIntents.Guilds |
+                GatewayIntents.GuildMessages |
+                GatewayIntents.GuildMembers |
+                GatewayIntents.GuildMessageReactions |
+                GatewayIntents.DirectMessages |
+                GatewayIntents.DirectMessageReactions |
+                GatewayIntents.MessageContent |
+                GatewayIntents.GuildVoiceStates |
+                GatewayIntents.GuildPresences);
+        }
+        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 = this.wrapUser(user);
+            this.emit('ready', this.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', this.wrapMember(member));
+        });
+        this.client.on('guildMemberRemove', (member) => {
+            this.emit('guildMemberRemove', this.wrapMember(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
+     */
+    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');
+    }
+    /**
+     * 获取 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;
+    }
+    /**
+     * 获取用户信息
+     */
+    async getUser(userId) {
+        const result = await this.getREST().getUser(userId);
+        return this.wrapUser(result);
+    }
+    /**
+     * 获取成员信息
+     */
+    async getMember(guildId, userId) {
+        const result = await this.getREST().getGuildMember(guildId, userId);
+        return this.wrapMember(result);
+    }
+    // ============================================
+    // 服务器（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, this.wrapMember(member));
+        }
+        return map;
+    }
+    /**
+     * 获取服务器成员信息
+     */
+    async getGuildMember(guildId, userId) {
+        const result = await this.getREST().getGuildMember(guildId, userId);
+        return this.wrapMember(result);
+    }
+    /**
+     * 踢出成员
+     */
+    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();
+        const result = await this.getREST().request(`/guilds/${guildId}/members/${userId}`, {
+            method: 'PATCH',
+            body: { communication_disabled_until: until },
+        });
+        return this.wrapMember(result);
+    }
+    /**
+     * 解除禁言
+     */
+    async removeTimeout(guildId, userId, _reason) {
+        const result = await this.getREST().request(`/guilds/${guildId}/members/${userId}`, {
+            method: 'PATCH',
+            body: { communication_disabled_until: null },
+        });
+        return this.wrapMember(result);
+    }
+    /**
+     * 修改成员昵称
+     */
+    async setMemberNickname(guildId, userId, nickname, _reason) {
+        const result = await this.getREST().request(`/guilds/${guildId}/members/${userId}`, {
+            method: 'PATCH',
+            body: { nick: nickname },
+        });
+        return this.wrapMember(result);
+    }
+    /**
+     * 添加角色
+     */
+    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;
+    }
+    /**
+     * 包装用户对象
+     */
+    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'}`,
+        };
+    }
+    /**
+     * 包装成员对象
+     */
+    wrapMember(member) {
+        return {
+            ...member,
+            user: this.wrapUser(member.user),
+        };
+    }
+    /**
+     * 包装消息对象
+     */
+    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/index.d.ts

@@ -0,0 +1,7 @@
+export type { DiscordConfig, ProxyConfig, GatewayIntentName, PresenceStatus } from './types.js';
+export { ChannelType, MessageType, ActivityType } from './types.js';
+export * from './adapter.js';
+export { DiscordBot } from './bot.js';
+export type { DiscordUser, DiscordMessage, DiscordGuild, DiscordChannel, DiscordMember, DiscordAttachment } from './bot.js';
+export * from './lite/index.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -0,0 +1,8 @@
+export { ChannelType, MessageType, ActivityType } from './types.js';
+// 导出适配器
+export * from './adapter.js';
+// 导出 Bot
+export { DiscordBot } from './bot.js';
+// 导出轻量版客户端（用于独立使用或 Serverless）
+export * from './lite/index.js';
+//# sourceMappingURL=index.js.map