@onebots/adapter-discord 1.0.0

package/lib/bot.d.ts

@@ -0,0 +1,293 @@
+/**
+ * Discord Bot 客户端
+ * 轻量版实现，直接封装 Discord API，支持 Node.js 和 Cloudflare Workers
+ */
+import { EventEmitter } from 'events';
+import { DiscordLite } from './lite/index.js';
+import type { DiscordREST } from './lite/rest.js';
+import type { DiscordConfig } from './types.js';
+export interface DiscordUser {
+    id: string;
+    username: string;
+    discriminator: string;
+    global_name?: string | null;
+    avatar: string | null;
+    bot?: boolean;
+    displayAvatarURL: () => string;
+    tag?: string;
+}
+export interface DiscordMessage {
+    id: string;
+    channel_id: string;
+    guild_id?: string;
+    author: DiscordUser;
+    content: string;
+    timestamp: string;
+    edited_timestamp?: string | null;
+    tts: boolean;
+    mention_everyone: boolean;
+    mentions: DiscordUser[];
+    attachments: DiscordAttachment[];
+    embeds: any[];
+    pinned: boolean;
+    type: number;
+    createdTimestamp: number;
+    channel: {
+        id: string;
+        type: number;
+    };
+    guild?: {
+        id: string;
+        name?: string;
+    };
+}
+export interface DiscordAttachment {
+    id: string;
+    filename: string;
+    size: number;
+    url: string;
+    proxy_url: string;
+    height?: number;
+    width?: number;
+    content_type?: string;
+}
+export interface DiscordGuild {
+    id: string;
+    name: string;
+    icon: string | null;
+    owner_id: string;
+    member_count?: number;
+}
+export interface DiscordChannel {
+    id: string;
+    type: number;
+    guild_id?: string;
+    name?: string;
+    topic?: string | null;
+    nsfw?: boolean;
+    parent_id?: string | null;
+}
+export interface DiscordMember {
+    user: DiscordUser;
+    nick?: string | null;
+    roles: string[];
+    joined_at: string;
+    premium_since?: string | null;
+    pending?: boolean;
+    communication_disabled_until?: string | null;
+}
+/**
+ * Discord Bot
+ * 基于轻量客户端实现，兼容 Node.js 和 Cloudflare Workers
+ */
+export declare class DiscordBot extends EventEmitter {
+    private client;
+    private config;
+    private ready;
+    private user;
+    private guilds;
+    constructor(config: DiscordConfig);
+    /**
+     * 解析 intents 配置
+     */
+    private parseIntents;
+    /**
+     * 设置事件监听器
+     */
+    private setupEventListeners;
+    /**
+     * 启动 Bot
+     */
+    start(): Promise<void>;
+    /**
+     * 停止 Bot
+     */
+    stop(): Promise<void>;
+    /**
+     * 获取 Bot 是否就绪
+     */
+    isReady(): boolean;
+    /**
+     * 发送消息到频道
+     */
+    sendMessage(channelId: string, content: string | {
+        content?: string;
+        embeds?: any[];
+        files?: any[];
+    }): Promise<DiscordMessage>;
+    /**
+     * 发送私信
+     */
+    sendDM(userId: string, content: string | {
+        content?: string;
+        embeds?: any[];
+        files?: any[];
+    }): Promise<DiscordMessage>;
+    /**
+     * 发送 Embed 消息
+     */
+    sendEmbed(channelId: string, embeds: any[]): Promise<DiscordMessage>;
+    /**
+     * 发送带附件的消息
+     */
+    sendWithAttachments(channelId: string, content: string, _attachments: any[]): Promise<DiscordMessage>;
+    /**
+     * 编辑消息
+     */
+    editMessage(channelId: string, messageId: string, content: string): Promise<DiscordMessage>;
+    /**
+     * 删除消息
+     */
+    deleteMessage(channelId: string, messageId: string): Promise<void>;
+    /**
+     * 获取消息
+     */
+    getMessage(channelId: string, messageId: string): Promise<DiscordMessage>;
+    /**
+     * 获取消息历史
+     */
+    getMessageHistory(channelId: string, limit?: number, before?: string): Promise<Map<string, DiscordMessage>>;
+    /**
+     * 添加消息反应
+     */
+    addReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
+    /**
+     * 移除消息反应
+     */
+    removeReaction(channelId: string, messageId: string, emoji: string, userId?: string): Promise<void>;
+    /**
+     * 获取机器人信息
+     */
+    getBotUser(): DiscordUser | null;
+    /**
+     * 获取用户信息
+     */
+    getUser(userId: string): Promise<DiscordUser>;
+    /**
+     * 获取成员信息
+     */
+    getMember(guildId: string, userId: string): Promise<DiscordMember>;
+    /**
+     * 获取服务器列表
+     */
+    getGuilds(): Map<string, DiscordGuild>;
+    /**
+     * 获取服务器信息
+     */
+    getGuild(guildId: string): Promise<DiscordGuild>;
+    /**
+     * 获取服务器成员列表
+     */
+    getGuildMembers(guildId: string, limit?: number): Promise<Map<string, DiscordMember>>;
+    /**
+     * 获取服务器成员信息
+     */
+    getGuildMember(guildId: string, userId: string): Promise<DiscordMember>;
+    /**
+     * 踢出成员
+     */
+    kickMember(guildId: string, userId: string, _reason?: string): Promise<void>;
+    /**
+     * 封禁成员
+     */
+    banMember(guildId: string, userId: string, options?: {
+        reason?: string;
+        deleteMessageSeconds?: number;
+    }): Promise<void>;
+    /**
+     * 解除封禁
+     */
+    unbanMember(guildId: string, userId: string, _reason?: string): Promise<void>;
+    /**
+     * 禁言成员（超时）
+     */
+    timeoutMember(guildId: string, userId: string, duration: number, _reason?: string): Promise<DiscordMember>;
+    /**
+     * 解除禁言
+     */
+    removeTimeout(guildId: string, userId: string, _reason?: string): Promise<DiscordMember>;
+    /**
+     * 修改成员昵称
+     */
+    setMemberNickname(guildId: string, userId: string, nickname: string | null, _reason?: string): Promise<DiscordMember>;
+    /**
+     * 添加角色
+     */
+    addRole(guildId: string, userId: string, roleId: string, _reason?: string): Promise<DiscordMember>;
+    /**
+     * 移除角色
+     */
+    removeRole(guildId: string, userId: string, roleId: string, _reason?: string): Promise<DiscordMember>;
+    /**
+     * 获取频道
+     */
+    getChannel(channelId: string): Promise<DiscordChannel | null>;
+    /**
+     * 获取服务器频道列表
+     */
+    getGuildChannels(guildId: string): Promise<Map<string, DiscordChannel>>;
+    /**
+     * 创建文本频道
+     */
+    createTextChannel(guildId: string, name: string, options?: {
+        topic?: string;
+        parent?: string;
+        nsfw?: boolean;
+    }): Promise<DiscordChannel>;
+    /**
+     * 删除频道
+     */
+    deleteChannel(channelId: string): Promise<void>;
+    /**
+     * 更新频道
+     */
+    updateChannel(channelId: string, options: {
+        name?: string;
+        topic?: string;
+        nsfw?: boolean;
+        parent?: string;
+    }): Promise<DiscordChannel>;
+    /**
+     * 获取服务器角色列表
+     */
+    getGuildRoles(guildId: string): Promise<Map<string, any>>;
+    /**
+     * 获取角色信息
+     */
+    getRole(guildId: string, roleId: string): Promise<any | null>;
+    /**
+     * 创建角色
+     */
+    createRole(guildId: string, options: {
+        name: string;
+        color?: number;
+        hoist?: boolean;
+        mentionable?: boolean;
+        permissions?: bigint;
+    }): Promise<any>;
+    /**
+     * 删除角色
+     */
+    deleteRole(guildId: string, roleId: string): Promise<void>;
+    /**
+     * 获取 REST 客户端
+     */
+    getREST(): DiscordREST;
+    /**
+     * 获取原始 Discord Lite 客户端
+     */
+    getClient(): DiscordLite;
+    /**
+     * 包装用户对象
+     */
+    private wrapUser;
+    /**
+     * 包装成员对象
+     */
+    private wrapMember;
+    /**
+     * 包装消息对象
+     */
+    private wrapMessage;
+}
+//# sourceMappingURL=bot.d.ts.map