@onebots/adapter-discord 1.0.0

package/lib/lite/rest.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Discord REST API 轻量封装
+ * Node.js 使用原生 https 模块，Cloudflare Workers 使用 fetch
+ */
+export interface RESTOptions {
+    token: string;
+    proxy?: {
+        url: string;
+        username?: string;
+        password?: string;
+    };
+}
+export interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    body?: any;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+}
+/**
+ * 轻量版 Discord REST 客户端
+ */
+export declare class DiscordREST {
+    private token;
+    private proxyUrl?;
+    private agent;
+    private initialized;
+    constructor(options: RESTOptions);
+    /**
+     * 初始化代理 Agent（延迟加载）
+     */
+    private initAgent;
+    /**
+     * Node.js 原生 HTTPS 请求
+     */
+    private nodeRequest;
+    /**
+     * Fetch 请求（Cloudflare Workers 等环境）
+     */
+    private fetchRequest;
+    /**
+     * 发送请求
+     */
+    request<T = any>(endpoint: string, options?: RequestOptions): Promise<T>;
+    /** 获取当前用户 */
+    getCurrentUser(): Promise<any>;
+    /** 获取用户 */
+    getUser(userId: string): Promise<any>;
+    /** 获取频道 */
+    getChannel(channelId: string): Promise<any>;
+    /** 发送消息 */
+    createMessage(channelId: string, content: string | {
+        content?: string;
+        embeds?: any[];
+        components?: any[];
+    }): Promise<any>;
+    /** 编辑消息 */
+    editMessage(channelId: string, messageId: string, content: string | {
+        content?: string;
+        embeds?: any[];
+    }): Promise<any>;
+    /** 删除消息 */
+    deleteMessage(channelId: string, messageId: string): Promise<any>;
+    /** 获取消息 */
+    getMessage(channelId: string, messageId: string): Promise<any>;
+    /** 获取消息历史 */
+    getMessages(channelId: string, options?: {
+        limit?: number;
+        before?: string;
+        after?: string;
+        around?: string;
+    }): Promise<any>;
+    /** 获取服务器 */
+    getGuild(guildId: string): Promise<any>;
+    /** 获取服务器列表 */
+    getGuilds(): Promise<any>;
+    /** 获取服务器成员 */
+    getGuildMember(guildId: string, userId: string): Promise<any>;
+    /** 获取服务器成员列表 */
+    getGuildMembers(guildId: string, options?: {
+        limit?: number;
+        after?: string;
+    }): Promise<any>;
+    /** 踢出成员 */
+    removeGuildMember(guildId: string, userId: string): Promise<any>;
+    /** 封禁成员 */
+    banGuildMember(guildId: string, userId: string, options?: {
+        delete_message_seconds?: number;
+    }): Promise<any>;
+    /** 回复 Interaction */
+    createInteractionResponse(interactionId: string, interactionToken: string, response: any): Promise<any>;
+    /** 获取原始 Interaction 回复 */
+    getOriginalInteractionResponse(applicationId: string, interactionToken: string): Promise<any>;
+    /** 编辑原始 Interaction 回复 */
+    editOriginalInteractionResponse(applicationId: string, interactionToken: string, content: any): Promise<any>;
+    /** 创建后续消息 */
+    createFollowupMessage(applicationId: string, interactionToken: string, content: any): Promise<any>;
+    /** 获取 Gateway URL */
+    getGateway(): Promise<any>;
+    /** 获取 Gateway Bot URL（带分片信息） */
+    getGatewayBot(): Promise<any>;
+}
+//# sourceMappingURL=rest.d.ts.map

package/lib/lite/rest.js

@@ -0,0 +1,292 @@
+/**
+ * Discord REST API 轻量封装
+ * Node.js 使用原生 https 模块，Cloudflare Workers 使用 fetch
+ */
+const DISCORD_API_BASE = 'https://discord.com/api/v10';
+/**
+ * 检测是否为 Node.js 环境
+ */
+function isNode() {
+    return typeof process !== 'undefined' && process.versions?.node !== undefined;
+}
+/**
+ * 轻量版 Discord REST 客户端
+ */
+export class DiscordREST {
+    token;
+    proxyUrl;
+    agent = null;
+    initialized = false;
+    constructor(options) {
+        this.token = options.token;
+        if (options.proxy?.url) {
+            const proxyUrl = new URL(options.proxy.url);
+            if (options.proxy.username)
+                proxyUrl.username = options.proxy.username;
+            if (options.proxy.password)
+                proxyUrl.password = options.proxy.password;
+            this.proxyUrl = proxyUrl.toString();
+        }
+    }
+    /**
+     * 初始化代理 Agent（延迟加载）
+     */
+    async initAgent() {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        if (!this.proxyUrl || !isNode())
+            return;
+        try {
+            // @ts-ignore - https-proxy-agent 是可选依赖
+            const { HttpsProxyAgent } = await import('https-proxy-agent');
+            this.agent = new HttpsProxyAgent(this.proxyUrl);
+            console.log(`[DiscordREST] 已配置代理: ${this.proxyUrl.replace(/:[^:@]+@/, ':***@')}`);
+        }
+        catch {
+            console.warn('[DiscordREST] https-proxy-agent 未安装，将直接连接');
+        }
+    }
+    /**
+     * Node.js 原生 HTTPS 请求
+     */
+    nodeRequest(url, options) {
+        return new Promise(async (resolve, reject) => {
+            const https = await import('https');
+            const urlObj = new URL(url);
+            const reqOptions = {
+                hostname: urlObj.hostname,
+                port: urlObj.port || 443,
+                path: urlObj.pathname + urlObj.search,
+                method: options.method,
+                headers: options.headers,
+            };
+            // 添加代理 agent
+            if (this.agent) {
+                reqOptions.agent = this.agent;
+            }
+            const req = https.request(reqOptions, (res) => {
+                let data = '';
+                res.on('data', (chunk) => {
+                    data += chunk;
+                });
+                res.on('end', () => {
+                    if (res.statusCode === 204) {
+                        resolve(undefined);
+                        return;
+                    }
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        try {
+                            resolve(data ? JSON.parse(data) : undefined);
+                        }
+                        catch {
+                            resolve(data);
+                        }
+                    }
+                    else {
+                        let errorMsg = `Discord API Error: ${res.statusCode}`;
+                        try {
+                            const errorData = JSON.parse(data);
+                            errorMsg += ` - ${JSON.stringify(errorData)}`;
+                        }
+                        catch {
+                            errorMsg += ` - ${data}`;
+                        }
+                        reject(new Error(errorMsg));
+                    }
+                });
+            });
+            req.on('error', (error) => {
+                reject(error);
+            });
+            // 设置超时
+            req.setTimeout(30000, () => {
+                req.destroy();
+                reject(new Error('Request timeout'));
+            });
+            if (options.body) {
+                req.write(options.body);
+            }
+            req.end();
+        });
+    }
+    /**
+     * Fetch 请求（Cloudflare Workers 等环境）
+     */
+    async fetchRequest(url, options) {
+        const response = await fetch(url, {
+            method: options.method,
+            headers: options.headers,
+            body: options.body,
+        });
+        if (response.status === 204) {
+            return undefined;
+        }
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ message: response.statusText }));
+            throw new Error(`Discord API Error: ${response.status} - ${JSON.stringify(error)}`);
+        }
+        return response.json();
+    }
+    /**
+     * 发送请求
+     */
+    async request(endpoint, options = {}) {
+        // 初始化代理
+        await this.initAgent();
+        const { method = 'GET', body, headers = {}, query } = options;
+        let url = `${DISCORD_API_BASE}${endpoint}`;
+        if (query) {
+            const filteredQuery = Object.fromEntries(Object.entries(query).filter(([_, v]) => v !== undefined));
+            if (Object.keys(filteredQuery).length > 0) {
+                const params = new URLSearchParams(filteredQuery);
+                url += `?${params.toString()}`;
+            }
+        }
+        const requestHeaders = {
+            'Authorization': `Bot ${this.token}`,
+            'Content-Type': 'application/json',
+            'User-Agent': 'OneBots Discord Lite (https://github.com/lc-cn/onebots)',
+            ...headers,
+        };
+        const requestBody = body ? JSON.stringify(body) : undefined;
+        // Node.js 环境使用原生 https 模块（支持 agent）
+        if (isNode()) {
+            return this.nodeRequest(url, {
+                method,
+                headers: requestHeaders,
+                body: requestBody,
+            });
+        }
+        // 其他环境（Cloudflare Workers 等）使用 fetch
+        return this.fetchRequest(url, {
+            method,
+            headers: requestHeaders,
+            body: requestBody,
+        });
+    }
+    // ============================================
+    // 用户相关
+    // ============================================
+    /** 获取当前用户 */
+    async getCurrentUser() {
+        return this.request('/users/@me');
+    }
+    /** 获取用户 */
+    async getUser(userId) {
+        return this.request(`/users/${userId}`);
+    }
+    // ============================================
+    // 频道相关
+    // ============================================
+    /** 获取频道 */
+    async getChannel(channelId) {
+        return this.request(`/channels/${channelId}`);
+    }
+    /** 发送消息 */
+    async createMessage(channelId, content) {
+        const body = typeof content === 'string' ? { content } : content;
+        return this.request(`/channels/${channelId}/messages`, {
+            method: 'POST',
+            body,
+        });
+    }
+    /** 编辑消息 */
+    async editMessage(channelId, messageId, content) {
+        const body = typeof content === 'string' ? { content } : content;
+        return this.request(`/channels/${channelId}/messages/${messageId}`, {
+            method: 'PATCH',
+            body,
+        });
+    }
+    /** 删除消息 */
+    async deleteMessage(channelId, messageId) {
+        return this.request(`/channels/${channelId}/messages/${messageId}`, {
+            method: 'DELETE',
+        });
+    }
+    /** 获取消息 */
+    async getMessage(channelId, messageId) {
+        return this.request(`/channels/${channelId}/messages/${messageId}`);
+    }
+    /** 获取消息历史 */
+    async getMessages(channelId, options) {
+        return this.request(`/channels/${channelId}/messages`, {
+            query: options,
+        });
+    }
+    // ============================================
+    // 服务器相关
+    // ============================================
+    /** 获取服务器 */
+    async getGuild(guildId) {
+        return this.request(`/guilds/${guildId}`);
+    }
+    /** 获取服务器列表 */
+    async getGuilds() {
+        return this.request('/users/@me/guilds');
+    }
+    /** 获取服务器成员 */
+    async getGuildMember(guildId, userId) {
+        return this.request(`/guilds/${guildId}/members/${userId}`);
+    }
+    /** 获取服务器成员列表 */
+    async getGuildMembers(guildId, options) {
+        return this.request(`/guilds/${guildId}/members`, {
+            query: options,
+        });
+    }
+    /** 踢出成员 */
+    async removeGuildMember(guildId, userId) {
+        return this.request(`/guilds/${guildId}/members/${userId}`, {
+            method: 'DELETE',
+        });
+    }
+    /** 封禁成员 */
+    async banGuildMember(guildId, userId, options) {
+        return this.request(`/guilds/${guildId}/bans/${userId}`, {
+            method: 'PUT',
+            body: options,
+        });
+    }
+    // ============================================
+    // Interactions 相关
+    // ============================================
+    /** 回复 Interaction */
+    async createInteractionResponse(interactionId, interactionToken, response) {
+        return this.request(`/interactions/${interactionId}/${interactionToken}/callback`, {
+            method: 'POST',
+            body: response,
+        });
+    }
+    /** 获取原始 Interaction 回复 */
+    async getOriginalInteractionResponse(applicationId, interactionToken) {
+        return this.request(`/webhooks/${applicationId}/${interactionToken}/messages/@original`);
+    }
+    /** 编辑原始 Interaction 回复 */
+    async editOriginalInteractionResponse(applicationId, interactionToken, content) {
+        return this.request(`/webhooks/${applicationId}/${interactionToken}/messages/@original`, {
+            method: 'PATCH',
+            body: content,
+        });
+    }
+    /** 创建后续消息 */
+    async createFollowupMessage(applicationId, interactionToken, content) {
+        return this.request(`/webhooks/${applicationId}/${interactionToken}`, {
+            method: 'POST',
+            body: content,
+        });
+    }
+    // ============================================
+    // Gateway 相关
+    // ============================================
+    /** 获取 Gateway URL */
+    async getGateway() {
+        return this.request('/gateway');
+    }
+    /** 获取 Gateway Bot URL（带分片信息） */
+    async getGatewayBot() {
+        return this.request('/gateway/bot');
+    }
+}
+//# sourceMappingURL=rest.js.map

package/lib/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Discord 适配器类型定义
+ * 轻量版 - 不依赖 discord.js
+ */
+/**
+ * 代理配置
+ */
+export interface ProxyConfig {
+    /** 代理服务器地址，如 http://127.0.0.1:7890 */
+    url: string;
+    /** 代理用户名（可选） */
+    username?: string;
+    /** 代理密码（可选） */
+    password?: string;
+}
+/**
+ * Gateway Intents 名称
+ */
+export type GatewayIntentName = 'Guilds' | 'GuildMembers' | 'GuildModeration' | 'GuildEmojisAndStickers' | 'GuildIntegrations' | 'GuildWebhooks' | 'GuildInvites' | 'GuildVoiceStates' | 'GuildPresences' | 'GuildMessages' | 'GuildMessageReactions' | 'GuildMessageTyping' | 'DirectMessages' | 'DirectMessageReactions' | 'DirectMessageTyping' | 'MessageContent' | 'GuildScheduledEvents' | 'AutoModerationConfiguration' | 'AutoModerationExecution';
+/**
+ * 在线状态
+ */
+export type PresenceStatus = 'online' | 'idle' | 'dnd' | 'invisible';
+/**
+ * 活动类型
+ */
+export declare enum ActivityType {
+    Playing = 0,
+    Streaming = 1,
+    Listening = 2,
+    Watching = 3,
+    Custom = 4,
+    Competing = 5
+}
+/**
+ * Discord 配置类型
+ */
+export interface DiscordConfig {
+    /** 账号标识 */
+    account_id: string;
+    /** Discord Bot Token */
+    token: string;
+    /** 代理配置（用于访问 Discord API） */
+    proxy?: ProxyConfig;
+    /** Gateway Intents - 可选，默认包含常用intents */
+    intents?: GatewayIntentName[];
+    /** 机器人初始状态 */
+    presence?: {
+        status?: PresenceStatus;
+        activities?: Array<{
+            name: string;
+            type?: ActivityType;
+            url?: string;
+        }>;
+    };
+}
+/**
+ * 频道类型
+ */
+export declare enum ChannelType {
+    GuildText = 0,
+    DM = 1,
+    GuildVoice = 2,
+    GroupDM = 3,
+    GuildCategory = 4,
+    GuildAnnouncement = 5,
+    AnnouncementThread = 10,
+    PublicThread = 11,
+    PrivateThread = 12,
+    GuildStageVoice = 13,
+    GuildDirectory = 14,
+    GuildForum = 15,
+    GuildMedia = 16
+}
+/**
+ * 消息类型
+ */
+export declare enum MessageType {
+    Default = 0,
+    RecipientAdd = 1,
+    RecipientRemove = 2,
+    Call = 3,
+    ChannelNameChange = 4,
+    ChannelIconChange = 5,
+    ChannelPinnedMessage = 6,
+    UserJoin = 7,
+    GuildBoost = 8,
+    GuildBoostTier1 = 9,
+    GuildBoostTier2 = 10,
+    GuildBoostTier3 = 11,
+    ChannelFollowAdd = 12,
+    GuildDiscoveryDisqualified = 14,
+    GuildDiscoveryRequalified = 15,
+    ThreadCreated = 18,
+    Reply = 19,
+    ChatInputCommand = 20,
+    ThreadStarterMessage = 21,
+    GuildInviteReminder = 22,
+    ContextMenuCommand = 23,
+    AutoModerationAction = 24
+}
+/**
+ * Discord 事件类型
+ */
+export type DiscordEventType = 'ready' | 'messageCreate' | 'messageUpdate' | 'messageDelete' | 'guildMemberAdd' | 'guildMemberRemove' | 'guildMemberUpdate' | 'guildCreate' | 'guildDelete' | 'channelCreate' | 'channelDelete' | 'channelUpdate' | 'messageReactionAdd' | 'messageReactionRemove' | 'interactionCreate' | 'error';
+//# sourceMappingURL=types.d.ts.map

package/lib/types.js

@@ -0,0 +1,64 @@
+/**
+ * Discord 适配器类型定义
+ * 轻量版 - 不依赖 discord.js
+ */
+/**
+ * 活动类型
+ */
+export var ActivityType;
+(function (ActivityType) {
+    ActivityType[ActivityType["Playing"] = 0] = "Playing";
+    ActivityType[ActivityType["Streaming"] = 1] = "Streaming";
+    ActivityType[ActivityType["Listening"] = 2] = "Listening";
+    ActivityType[ActivityType["Watching"] = 3] = "Watching";
+    ActivityType[ActivityType["Custom"] = 4] = "Custom";
+    ActivityType[ActivityType["Competing"] = 5] = "Competing";
+})(ActivityType || (ActivityType = {}));
+/**
+ * 频道类型
+ */
+export var ChannelType;
+(function (ChannelType) {
+    ChannelType[ChannelType["GuildText"] = 0] = "GuildText";
+    ChannelType[ChannelType["DM"] = 1] = "DM";
+    ChannelType[ChannelType["GuildVoice"] = 2] = "GuildVoice";
+    ChannelType[ChannelType["GroupDM"] = 3] = "GroupDM";
+    ChannelType[ChannelType["GuildCategory"] = 4] = "GuildCategory";
+    ChannelType[ChannelType["GuildAnnouncement"] = 5] = "GuildAnnouncement";
+    ChannelType[ChannelType["AnnouncementThread"] = 10] = "AnnouncementThread";
+    ChannelType[ChannelType["PublicThread"] = 11] = "PublicThread";
+    ChannelType[ChannelType["PrivateThread"] = 12] = "PrivateThread";
+    ChannelType[ChannelType["GuildStageVoice"] = 13] = "GuildStageVoice";
+    ChannelType[ChannelType["GuildDirectory"] = 14] = "GuildDirectory";
+    ChannelType[ChannelType["GuildForum"] = 15] = "GuildForum";
+    ChannelType[ChannelType["GuildMedia"] = 16] = "GuildMedia";
+})(ChannelType || (ChannelType = {}));
+/**
+ * 消息类型
+ */
+export var MessageType;
+(function (MessageType) {
+    MessageType[MessageType["Default"] = 0] = "Default";
+    MessageType[MessageType["RecipientAdd"] = 1] = "RecipientAdd";
+    MessageType[MessageType["RecipientRemove"] = 2] = "RecipientRemove";
+    MessageType[MessageType["Call"] = 3] = "Call";
+    MessageType[MessageType["ChannelNameChange"] = 4] = "ChannelNameChange";
+    MessageType[MessageType["ChannelIconChange"] = 5] = "ChannelIconChange";
+    MessageType[MessageType["ChannelPinnedMessage"] = 6] = "ChannelPinnedMessage";
+    MessageType[MessageType["UserJoin"] = 7] = "UserJoin";
+    MessageType[MessageType["GuildBoost"] = 8] = "GuildBoost";
+    MessageType[MessageType["GuildBoostTier1"] = 9] = "GuildBoostTier1";
+    MessageType[MessageType["GuildBoostTier2"] = 10] = "GuildBoostTier2";
+    MessageType[MessageType["GuildBoostTier3"] = 11] = "GuildBoostTier3";
+    MessageType[MessageType["ChannelFollowAdd"] = 12] = "ChannelFollowAdd";
+    MessageType[MessageType["GuildDiscoveryDisqualified"] = 14] = "GuildDiscoveryDisqualified";
+    MessageType[MessageType["GuildDiscoveryRequalified"] = 15] = "GuildDiscoveryRequalified";
+    MessageType[MessageType["ThreadCreated"] = 18] = "ThreadCreated";
+    MessageType[MessageType["Reply"] = 19] = "Reply";
+    MessageType[MessageType["ChatInputCommand"] = 20] = "ChatInputCommand";
+    MessageType[MessageType["ThreadStarterMessage"] = 21] = "ThreadStarterMessage";
+    MessageType[MessageType["GuildInviteReminder"] = 22] = "GuildInviteReminder";
+    MessageType[MessageType["ContextMenuCommand"] = 23] = "ContextMenuCommand";
+    MessageType[MessageType["AutoModerationAction"] = 24] = "AutoModerationAction";
+})(MessageType || (MessageType = {}));
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@onebots/adapter-discord",
+  "version": "1.0.0",
+  "description": "onebots Discord 适配器（轻量版，支持 Node.js 和 Cloudflare Workers）",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./lite": {
+      "types": "./lib/lite/index.d.ts",
+      "default": "./lib/lite/index.js"
+    }
+  },
+  "keywords": [
+    "onebots",
+    "discord",
+    "adapter",
+    "cloudflare-workers",
+    "serverless",
+    "lightweight"
+  ],
+  "author": "凉菜",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "/lib/**/*.js",
+    "/lib/**/*.d.ts"
+  ],
+  "devDependencies": {
+    "tsc-alias": "latest",
+    "typescript": "latest",
+    "@types/node": "^22.7.3"
+  },
+  "peerDependencies": {
+    "onebots": "1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ws": {
+      "optional": true
+    },
+    "https-proxy-agent": {
+      "optional": true
+    },
+    "socks-proxy-agent": {
+      "optional": true
+    }
+  },
+  "dependencies": {},
+  "optionalDependencies": {
+    "ws": "^8.18.0",
+    "https-proxy-agent": "^7.0.6",
+    "socks-proxy-agent": "^8.0.5"
+  },
+  "scripts": {
+    "build": "rm -f *.tsbuildinfo && tsc --project tsconfig.json && tsc-alias -p tsconfig.json",
+    "clean": "rm -rf lib *.tsbuildinfo"
+  }
+}