@zhin.js/adapter-discord 1.0.87 → 1.1.0

package/lib/gateway.js

@@ -0,0 +1,303 @@
+import { createReadStream, promises as fs } from 'node:fs';
+import path from 'node:path';
+import { Client, GatewayIntentBits, EmbedBuilder, AttachmentBuilder, ActionRowBuilder, ButtonBuilder, ButtonStyle, REST, Routes, PermissionFlagsBits, } from 'discord.js';
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import { activityTypeCode, resolveChannelKind, } from './protocol.js';
+const logger = getLogger('discord');
+export const DEFAULT_INTENTS = [
+    GatewayIntentBits.Guilds,
+    GatewayIntentBits.GuildMessages,
+    GatewayIntentBits.MessageContent,
+    GatewayIntentBits.DirectMessages,
+    GatewayIntentBits.GuildMembers,
+    GatewayIntentBits.GuildMessageReactions,
+];
+export function defaultCreateClient(intents) {
+    return new Client({ intents: [...intents] });
+}
+export function resolveSenderRole(msg) {
+    if (msg.isGuildOwner)
+        return 'owner';
+    const tokens = msg.permissionTokens ?? [];
+    if (tokens.includes('ADMINISTRATOR') || tokens.includes('MODERATE_MEMBERS'))
+        return 'admin';
+    if (msg.guildId)
+        return 'member';
+    return undefined;
+}
+export function normalizeDiscordMessage(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const msg = raw;
+    if (!msg.author || !msg.channel)
+        return null;
+    const permissionTokens = [];
+    let isGuildOwner = false;
+    const member = msg.member;
+    const guild = msg.guild;
+    if (member && guild) {
+        const checks = [
+            [PermissionFlagsBits.Administrator, 'ADMINISTRATOR'],
+            [PermissionFlagsBits.ManageRoles, 'MANAGE_ROLES'],
+            [PermissionFlagsBits.ModerateMembers, 'MODERATE_MEMBERS'],
+            [PermissionFlagsBits.ManageChannels, 'MANAGE_CHANNELS'],
+            [PermissionFlagsBits.ManageGuild, 'MANAGE_GUILD'],
+        ];
+        for (const [bit, name] of checks) {
+            if (member.permissions.has(bit))
+                permissionTokens.push(name);
+        }
+        if (guild.ownerId === msg.author.id) {
+            isGuildOwner = true;
+            permissionTokens.push('guild_owner', 'ADMINISTRATOR');
+        }
+    }
+    return {
+        id: msg.id,
+        content: msg.content ?? '',
+        channelId: msg.channel.id,
+        channelKind: resolveChannelKind(msg.channel.type),
+        authorId: msg.author.id,
+        authorName: member?.displayName || msg.author.displayName || msg.author.username,
+        authorBot: msg.author.bot,
+        createdTimestamp: msg.createdTimestamp,
+        guildId: guild?.id,
+        isGuildOwner,
+        permissionTokens,
+        attachments: [...msg.attachments.values()].map((a) => ({
+            id: a.id,
+            name: a.name ?? undefined,
+            url: a.url,
+            contentType: a.contentType ?? undefined,
+            size: a.size,
+        })),
+        embedTitles: msg.embeds.map((e) => e.title || e.description || 'embed').filter(Boolean),
+        stickerNames: [...msg.stickers.values()].map((s) => s.name),
+        replyToId: msg.reference?.messageId ?? undefined,
+    };
+}
+export async function toMessageCreateOptions(body) {
+    const options = {};
+    if (body.content)
+        options.content = body.content;
+    if (body.embeds?.length) {
+        options.embeds = body.embeds.map((data) => {
+            const embed = new EmbedBuilder();
+            if (data.title)
+                embed.setTitle(String(data.title));
+            if (data.description)
+                embed.setDescription(String(data.description));
+            if (data.color != null)
+                embed.setColor(data.color);
+            if (data.url)
+                embed.setURL(String(data.url));
+            const thumb = data.thumbnail;
+            if (thumb?.url)
+                embed.setThumbnail(thumb.url);
+            const image = data.image;
+            if (image?.url)
+                embed.setImage(image.url);
+            if (data.author)
+                embed.setAuthor(data.author);
+            if (data.footer)
+                embed.setFooter(data.footer);
+            if (data.timestamp)
+                embed.setTimestamp(new Date(String(data.timestamp)));
+            if (Array.isArray(data.fields))
+                embed.addFields(data.fields);
+            return embed;
+        });
+    }
+    if (body.files?.length) {
+        const files = [];
+        for (const file of body.files) {
+            if (file.base64) {
+                files.push(new AttachmentBuilder(decodeBase64(file.base64), {
+                    name: file.name || 'attachment',
+                }));
+            }
+            else if (file.file && await fileExists(file.file)) {
+                files.push(new AttachmentBuilder(createReadStream(file.file), {
+                    name: file.name || path.basename(file.file),
+                }));
+            }
+            else if (file.url) {
+                files.push(new AttachmentBuilder(file.url, { name: file.name || 'attachment' }));
+            }
+            else {
+                logger.warn(formatCompact({
+                    op: 'discord_outbound_media_dropped',
+                    reason: 'missing_source',
+                    name: file.name,
+                }));
+            }
+        }
+        if (files.length)
+            options.files = files;
+    }
+    if (body.components?.length) {
+        options.components = body.components.map((row) => new ActionRowBuilder().addComponents(...row.components.map((btn) => {
+            const b = new ButtonBuilder()
+                .setCustomId(btn.custom_id)
+                .setLabel(btn.label)
+                .setDisabled(!!btn.disabled);
+            if (btn.style === 4)
+                b.setStyle(ButtonStyle.Danger);
+            else if (btn.style === 1)
+                b.setStyle(ButtonStyle.Primary);
+            else
+                b.setStyle(ButtonStyle.Secondary);
+            return b;
+        })));
+    }
+    return options;
+}
+async function registerSlashCommands(config, applicationId, guildIds = []) {
+    if (!config.slashCommands?.length)
+        return;
+    const rest = new REST({ version: '10' }).setToken(config.token);
+    if (config.globalCommands) {
+        await rest.put(Routes.applicationCommands(applicationId), {
+            body: config.slashCommands,
+        });
+        logger.info(formatCompact({ op: 'slash_commands', scope: 'global' }));
+        return;
+    }
+    // globalCommands=false 时按 guild 注册，否则 enableSlashCommands 会是静默 no-op
+    if (guildIds.length === 0) {
+        logger.warn(formatCompact({
+            op: 'slash_commands',
+            ok: false,
+            error: 'enableSlashCommands=true but globalCommands=false and no guilds cached; slash commands not registered',
+        }));
+        return;
+    }
+    for (const guildId of guildIds) {
+        await rest.put(Routes.applicationGuildCommands(applicationId, guildId), {
+            body: config.slashCommands,
+        });
+    }
+    logger.info(formatCompact({ op: 'slash_commands', scope: 'guild', guilds: guildIds.length }));
+}
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** base64:// / data:*;base64, 前缀归一，Buffer.from 只接受纯 base64。 */
+function decodeBase64(value) {
+    const stripped = value.startsWith('base64://') ? value.slice('base64://'.length) : value;
+    const comma = stripped.startsWith('data:') ? stripped.indexOf(',') : -1;
+    return Buffer.from(comma >= 0 ? stripped.slice(comma + 1) : stripped, 'base64');
+}
+export async function connectDiscordGatewayClient(client, config, handlers) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        client.on('messageCreate', (raw) => {
+            handlers.onPlatformEvent('messageCreate', raw);
+            const msg = normalizeDiscordMessage(raw);
+            if (!msg)
+                return;
+            // clientReady 之后 client.user 一定可用；消息事件只会在此之后到达
+            const botId = client.user?.id;
+            const mentions = raw.mentions;
+            const mentionedBot = !!botId && mentions?.users?.has?.(botId) === true;
+            handlers.onMessage(mentionedBot ? { ...msg, mentionedBot: true } : msg);
+        });
+        client.on('interactionCreate', (raw) => {
+            handlers.onPlatformEvent('interactionCreate', raw);
+            const interaction = raw;
+            if (!interaction.isButton?.())
+                return;
+            void interaction.deferUpdate?.().catch(() => { });
+            if (!interaction.channel)
+                return;
+            handlers.onButton({
+                id: interaction.id,
+                customId: interaction.customId,
+                channelId: interaction.channel.id,
+                channelKind: resolveChannelKind(interaction.channel.type),
+                userId: interaction.user.id,
+                userName: interaction.user.username || interaction.user.displayName || interaction.user.id,
+                sourceMessageId: interaction.message?.id,
+            });
+        });
+        client.on('guildMemberAdd', (raw) => {
+            handlers.onPlatformEvent('guildMemberAdd', raw);
+            const member = raw;
+            const guildId = member.guild?.id;
+            const userId = member.user?.id;
+            if (!guildId || !userId)
+                return;
+            handlers.onGuildMemberAdd?.({
+                guildId,
+                userId,
+                userName: member.user?.username || member.user?.displayName,
+            });
+        });
+        client.on('guildMemberRemove', (raw) => {
+            handlers.onPlatformEvent('guildMemberRemove', raw);
+            const member = raw;
+            const guildId = member.guild?.id;
+            const userId = member.user?.id;
+            if (!guildId || !userId)
+                return;
+            handlers.onGuildMemberRemove?.({
+                guildId,
+                userId,
+                userName: member.user?.username || member.user?.displayName,
+            });
+        });
+        client.once('clientReady', () => {
+            handlers.onPlatformEvent('clientReady', client.user);
+            void (async () => {
+                try {
+                    if (config.defaultActivity && client.user?.setActivity) {
+                        client.user.setActivity(config.defaultActivity.name, {
+                            type: activityTypeCode(config.defaultActivity.type),
+                            url: config.defaultActivity.url,
+                        });
+                    }
+                    if (config.enableSlashCommands && config.slashCommands?.length && client.user) {
+                        const guildIds = [...client.guilds.cache.values()].map((guild) => guild.id);
+                        await registerSlashCommands(config, client.user.id, guildIds);
+                    }
+                    if (!settled) {
+                        settled = true;
+                        resolve();
+                    }
+                }
+                catch (error) {
+                    if (!settled) {
+                        settled = true;
+                        reject(error);
+                    }
+                }
+            })();
+        });
+        client.on('error', (error) => {
+            logger.error('Discord client error:', error);
+            if (!settled) {
+                settled = true;
+                reject(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+        client.on('warn', (info) => {
+            logger.warn('Discord client warning:', info);
+        });
+        client.login(config.token).catch((error) => {
+            if (!settled) {
+                settled = true;
+                const raw = error instanceof Error ? error.message : String(error);
+                const tokenShapeHint = config.token.split('.').length === 3
+                    ? ''
+                    : '；当前 token 不是标准三段式 Bot Token 格式，请到 Discord Developer Portal → Bot → Reset Token 重新获取（勿用 Client Secret）';
+                reject(new Error(`Discord 连接失败：请检查 token 是否为 Bot Token 且未过期、Bot 是否已开启所需 Intents${tokenShapeHint}（原始错误：${raw}）`, { cause: error instanceof Error ? error : undefined }));
+            }
+        });
+    });
+}

package/lib/index.d.ts

@@ -1,18 +1,6 @@
-import { PageManager } from "@zhin.js/console";
-import { DiscordAdapter } from "./adapter.js";
-declare module "zhin.js" {
-    namespace Plugin {
-        interface Contexts {
-            router: import("@zhin.js/http").Router;
-            web: PageManager;
-        }
-    }
-    interface Adapters {
-        discord: DiscordAdapter;
-    }
-}
-export * from "./types.js";
-export { DiscordBot } from "./bot.js";
-export { DiscordInteractionsBot } from "./bot-interactions.js";
-export { DiscordAdapter, type DiscordBotLike } from "./adapter.js";
-//# sourceMappingURL=index.d.ts.map
+export { activityTypeCode, formatButtonContent, formatInboundContent, formatOutboundBody, resolveChannelKind, resolveDiscordConfig, senderDisplayName, type DiscordAdapterConfig, type DiscordButtonInbound, type DiscordInboundAttachment, type DiscordInboundMessage, type DiscordOutboundBody, type DiscordWireSegment, type ResolvedDiscordConfig, type ResolvedDiscordGatewayConfig, type ResolvedDiscordInteractionsConfig, } from './protocol.js';
+export { discordClient, type DiscordClient, type DiscordClientEventMap, } from './client.js';
+export { checkDiscordPlatformPermit, discordGroupPermitResolver, normalizeDiscordSenderForPermit, platformPermit, } from './platform-permit.js';
+export { DiscordGatewayEndpoint, DiscordInteractionsEndpoint, type CreateDiscordClient, type DiscordClientTransport, type DiscordEndpointOptions, type DiscordInteractionsEndpointOptions, } from './endpoint.js';
+export { connectDiscordGatewayClient, defaultCreateClient, normalizeDiscordMessage, resolveSenderRole, toMessageCreateOptions, type DiscordGatewayConnectHandlers, } from './gateway.js';
+export { handleDiscordInteractionRequest, registerDiscordInteractionRoutes, type DiscordInteractionsHandler, } from './webhook.js';

package/lib/index.js

@@ -1,323 +1,6 @@
-/**
- * Discord 适配器入口：单一适配器，支持 Gateway / Interactions（connection: gateway | interactions）
- */
-import path from "node:path";
-import { usePlugin, createGroupManagementTools } from "zhin.js";
-import { DiscordAdapter } from "./adapter.js";
-export * from "./types.js";
-export { DiscordBot } from "./bot.js";
-export { DiscordInteractionsBot } from "./bot-interactions.js";
-export { DiscordAdapter } from "./adapter.js";
-const plugin = usePlugin();
-const { provide, useContext } = plugin;
-provide({
-    name: "discord",
-    description: "Discord 适配器（Gateway / Interactions）",
-    mounted: async (p) => {
-        const adapter = new DiscordAdapter(p);
-        await adapter.start();
-        return adapter;
-    },
-    dispose: async (adapter) => {
-        await adapter.stop();
-    },
-});
-useContext('tool', 'discord', (toolService, discord) => {
-    const groupTools = createGroupManagementTools(discord, 'discord');
-    const disposers = groupTools.map(t => toolService.addTool(t, plugin.name));
-    function getGatewayBot(botId) {
-        const bot = discord.bots.get(botId);
-        if (!bot)
-            throw new Error(`Bot ${botId} 不存在`);
-        if (bot.$config.connection !== 'gateway') {
-            throw new Error('此工具仅支持 connection: gateway');
-        }
-        return bot;
-    }
-    disposers.push(toolService.addTool({
-        name: 'discord_add_role',
-        description: '给成员添加 Discord 角色',
-        parameters: {
-            type: 'object',
-            properties: {
-                bot: { type: 'string', description: 'Bot 名称' },
-                guild_id: { type: 'string', description: '服务器 ID' },
-                user_id: { type: 'string', description: '用户 ID' },
-                role_id: { type: 'string', description: '角色 ID' },
-            },
-            required: ['bot', 'guild_id', 'user_id', 'role_id'],
-        },
-        platforms: ['discord'],
-        tags: ['discord'],
-        execute: async (args) => {
-            const bot = getGatewayBot(args.bot);
-            const success = await bot.addRole(args.guild_id, args.user_id, args.role_id);
-            return { success, message: success ? `已给用户 ${args.user_id} 添加角色` : '操作失败' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'discord_remove_role',
-        description: '移除成员的 Discord 角色',
-        parameters: {
-            type: 'object',
-            properties: {
-                bot: { type: 'string', description: 'Bot 名称' },
-                guild_id: { type: 'string', description: '服务器 ID' },
-                user_id: { type: 'string', description: '用户 ID' },
-                role_id: { type: 'string', description: '角色 ID' },
-            },
-            required: ['bot', 'guild_id', 'user_id', 'role_id'],
-        },
-        platforms: ['discord'],
-        tags: ['discord'],
-        execute: async (args) => {
-            const bot = getGatewayBot(args.bot);
-            const success = await bot.removeRole(args.guild_id, args.user_id, args.role_id);
-            return { success, message: success ? `已移除用户 ${args.user_id} 的角色` : '操作失败' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'discord_list_roles',
-        description: '获取 Discord 服务器角色列表',
-        parameters: {
-            type: 'object',
-            properties: {
-                bot: { type: 'string', description: 'Bot 名称' },
-                guild_id: { type: 'string', description: '服务器 ID' },
-            },
-            required: ['bot', 'guild_id'],
-        },
-        platforms: ['discord'],
-        tags: ['discord'],
-        execute: async (args) => {
-            const bot = getGatewayBot(args.bot);
-            const roles = await bot.getRoles(args.guild_id);
-            return { roles, count: roles.length };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'discord_create_thread',
-        description: '在 Discord 频道中创建帖子/子线程',
-        parameters: {
-            type: 'object',
-            properties: {
-                bot: { type: 'string', description: 'Bot 名称' },
-                channel_id: { type: 'string', description: '频道 ID' },
-                name: { type: 'string', description: '帖子标题' },
-                message_id: { type: 'string', description: '基于某条消息创建（可选）' },
-                auto_archive_duration: {
-                    type: 'number',
-                    description: '自动归档时间（分钟：60/1440/4320/10080）',
-                },
-            },
-            required: ['bot', 'channel_id', 'name'],
-        },
-        platforms: ['discord'],
-        tags: ['discord'],
-        execute: async (args) => {
-            const bot = getGatewayBot(args.bot);
-            const thread = await bot.createThread(args.channel_id, args.name, args.message_id, args.auto_archive_duration);
-            return { success: true, thread_id: thread.id, message: `帖子 "${args.name}" 已创建` };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'discord_react',
-        description: '对 Discord 消息添加表情反应',
-        parameters: {
-            type: 'object',
-            properties: {
-                bot: { type: 'string', description: 'Bot 名称' },
-                channel_id: { type: 'string', description: '频道 ID' },
-                message_id: { type: 'string', description: '消息 ID' },
-                emoji: {
-                    type: 'string',
-                    description: '表情（Unicode 表情或自定义表情如 <:name:id>）',
-                },
-            },
-            required: ['bot', 'channel_id', 'message_id', 'emoji'],
-        },
-        platforms: ['discord'],
-        tags: ['discord'],
-        execute: async (args) => {
-            const bot = getGatewayBot(args.bot);
-            await bot.addReaction(args.channel_id, args.message_id, args.emoji);
-            return { success: true, message: `已添加反应 ${args.emoji}` };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'discord_send_embed',
-        description: '发送 Discord 富文本嵌入消息（Embed）',
-        parameters: {
-            type: 'object',
-            properties: {
-                bot: { type: 'string', description: 'Bot 名称' },
-                channel_id: { type: 'string', description: '频道 ID' },
-                title: { type: 'string', description: 'Embed 标题' },
-                description: { type: 'string', description: 'Embed 描述' },
-                color: { type: 'number', description: '颜色值（十进制，如 0x00ff00 = 65280）' },
-                url: { type: 'string', description: '标题链接（可选）' },
-                fields: {
-                    type: 'string',
-                    description: '字段，JSON 格式: [{"name":"k","value":"v","inline":false}]',
-                },
-            },
-            required: ['bot', 'channel_id'],
-        },
-        platforms: ['discord'],
-        tags: ['discord'],
-        execute: async (args) => {
-            const bot = getGatewayBot(args.bot);
-            const embedData = {};
-            if (args.title)
-                embedData.title = args.title;
-            if (args.description)
-                embedData.description = args.description;
-            if (args.color)
-                embedData.color = args.color;
-            if (args.url)
-                embedData.url = args.url;
-            if (args.fields) {
-                try {
-                    embedData.fields = JSON.parse(args.fields);
-                }
-                catch {
-                    return { success: false, message: 'fields 格式错误，应为 JSON 数组' };
-                }
-            }
-            const msg = await bot.sendEmbed(args.channel_id, embedData);
-            return { success: true, message_id: msg.id, message: 'Embed 已发送' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'discord_forum_post',
-        description: '在 Discord 论坛频道中创建帖子',
-        parameters: {
-            type: 'object',
-            properties: {
-                bot: { type: 'string', description: 'Bot 名称' },
-                channel_id: { type: 'string', description: '论坛频道 ID' },
-                name: { type: 'string', description: '帖子标题' },
-                content: { type: 'string', description: '帖子内容' },
-                tags: { type: 'string', description: '标签名，逗号分隔（可选）' },
-            },
-            required: ['bot', 'channel_id', 'name', 'content'],
-        },
-        platforms: ['discord'],
-        tags: ['discord'],
-        execute: async (args) => {
-            const bot = getGatewayBot(args.bot);
-            const tagList = args.tags ? args.tags.split(',').map((t) => t.trim()) : undefined;
-            const thread = await bot.createForumPost(args.channel_id, args.name, args.content, tagList);
-            return { success: true, thread_id: thread.id, message: `论坛帖 "${args.name}" 已创建` };
-        },
-    }, plugin.name));
-    return () => disposers.forEach(d => d());
-});
-// ── Web 控制台 ─────────────────────────────────────────────────────────
-useContext("web", (pageManager) => {
-    pageManager.addEntry({
-        id: "discord",
-        development: path.resolve(import.meta.dirname, "../client/index.tsx"),
-        production: path.resolve(import.meta.dirname, "../dist/index.js"),
-        meta: { name: "Discord" },
-    });
-});
-useContext("router", "discord", (router, discord) => {
-    router.get("/api/discord/bots", async (ctx) => {
-        try {
-            const bots = Array.from(discord.bots.values());
-            const result = bots.map((bot) => {
-                try {
-                    const client = bot.client || bot;
-                    return {
-                        name: bot.$config.name,
-                        connected: bot.$connected || false,
-                        mode: bot.$config.connection || "gateway",
-                        guildCount: client.guilds?.cache?.size || 0,
-                        channelCount: client.channels?.cache?.size || 0,
-                        status: bot.$connected ? "online" : "offline",
-                        user: client.user ? { tag: client.user.tag, id: client.user.id } : null,
-                    };
-                }
-                catch {
-                    return { name: bot.$config.name, connected: false, mode: "unknown", guildCount: 0, channelCount: 0, status: "error", user: null };
-                }
-            });
-            ctx.body = { success: true, data: result };
-        }
-        catch {
-            ctx.status = 500;
-            ctx.body = { success: false, error: "获取机器人数据失败" };
-        }
-    });
-    // Bot 连接/断开
-    router.post("/api/discord/bots/:name/connect", async (ctx) => {
-        try {
-            const bot = discord.bots.get(ctx.params.name);
-            if (!bot) {
-                ctx.status = 404;
-                ctx.body = { success: false, error: "Bot 不存在" };
-                return;
-            }
-            if (bot.$connected) {
-                ctx.body = { success: true, message: "已经在线" };
-                return;
-            }
-            await bot.$connect();
-            ctx.body = { success: true, message: "连接成功" };
-        }
-        catch (e) {
-            ctx.status = 500;
-            ctx.body = { success: false, error: e?.message || "连接失败" };
-        }
-    });
-    router.post("/api/discord/bots/:name/disconnect", async (ctx) => {
-        try {
-            const bot = discord.bots.get(ctx.params.name);
-            if (!bot) {
-                ctx.status = 404;
-                ctx.body = { success: false, error: "Bot 不存在" };
-                return;
-            }
-            if (!bot.$connected) {
-                ctx.body = { success: true, message: "已经离线" };
-                return;
-            }
-            await bot.$disconnect();
-            ctx.body = { success: true, message: "已断开" };
-        }
-        catch (e) {
-            ctx.status = 500;
-            ctx.body = { success: false, error: e?.message || "断开失败" };
-        }
-    });
-    // 服务器列表（仅 Gateway 模式）
-    router.get("/api/discord/bots/:name/guilds", async (ctx) => {
-        try {
-            const bot = discord.bots.get(ctx.params.name);
-            if (!bot) {
-                ctx.status = 404;
-                ctx.body = { success: false, error: "Bot 不存在" };
-                return;
-            }
-            if (!bot.$connected) {
-                ctx.status = 400;
-                ctx.body = { success: false, error: "Bot 未连接" };
-                return;
-            }
-            const client = bot.client || bot;
-            const guilds = client.guilds?.cache?.map((g) => ({
-                id: g.id,
-                name: g.name,
-                memberCount: g.memberCount,
-                icon: g.iconURL({ size: 64 }),
-            })) || [];
-            ctx.body = { success: true, data: guilds };
-        }
-        catch (e) {
-            ctx.status = 500;
-            ctx.body = { success: false, error: e?.message || "获取服务器列表失败" };
-        }
-    });
-});
-//# sourceMappingURL=index.js.map
+export { activityTypeCode, formatButtonContent, formatInboundContent, formatOutboundBody, resolveChannelKind, resolveDiscordConfig, senderDisplayName, } from './protocol.js';
+export { discordClient, } from './client.js';
+export { checkDiscordPlatformPermit, discordGroupPermitResolver, normalizeDiscordSenderForPermit, platformPermit, } from './platform-permit.js';
+export { DiscordGatewayEndpoint, DiscordInteractionsEndpoint, } from './endpoint.js';
+export { connectDiscordGatewayClient, defaultCreateClient, normalizeDiscordMessage, resolveSenderRole, toMessageCreateOptions, } from './gateway.js';
+export { handleDiscordInteractionRequest, registerDiscordInteractionRoutes, } from './webhook.js';

package/lib/platform-permit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Discord platform permit — Guild 权限位
+ */
+import type { PermissionSubject } from '@zhin.js/permission';
+export declare function platformPermit(perm: string): string;
+export declare function discordGroupPermitResolver(logicalPerm: string): string;
+export declare function normalizeDiscordSenderForPermit(input: {
+    isOwner?: boolean;
+    permissions?: string[];
+}): {
+    role?: string;
+    permissions?: string[];
+};
+export declare function checkDiscordPlatformPermit(perm: string, subject: PermissionSubject): boolean;