@zhin.js/adapter-discord 5.0.1 → 5.0.3

package/lib/endpoint.d.ts

@@ -1,124 +1,71 @@
-/**
- * Discord Endpoint 实现 (Gateway)
- */
-import { Client, Message as DiscordMessage, TextChannel, DMChannel, NewsChannel, ThreadChannel, EmbedBuilder, AttachmentBuilder, MessageCreateOptions, ChatInputCommandInteraction } from 'discord.js';
-import { Endpoint, Message, SendOptions, SendContent, MessageSegment, type EditMessageOptions } from 'zhin.js';
-import type { DiscordGatewayConfig, DiscordChannelMessage } from "./types.js";
-import type { DiscordAdapter } from "./adapter.js";
-export declare class DiscordEndpoint extends Client implements Endpoint<DiscordGatewayConfig, DiscordChannelMessage> {
-    adapter: DiscordAdapter;
-    $config: DiscordGatewayConfig;
-    private slashCommandHandlers;
-    /** message_id -> channel_id，用于在仅有 message_id 的场景执行 reaction 操作 */
-    private readonly messageChannelMap;
-    $connected: boolean;
-    get pluginLogger(): import("zhin.js").Logger;
-    get $id(): string;
-    constructor(adapter: DiscordAdapter, $config: DiscordGatewayConfig);
-    private handleDiscordMessage;
-    private handleSlashCommand;
-    private handleButtonInteraction;
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    $formatMessage(msg: DiscordChannelMessage): Message<DiscordChannelMessage>;
-    parseMessageContent(msg: DiscordChannelMessage): MessageSegment[];
-    parseTextContent(content: string, msg: DiscordChannelMessage): MessageSegment[];
-    parseAttachment(attachment: any): MessageSegment[];
-    $sendMessage(options: SendOptions): Promise<string>;
-    sendContentToChannel(channel: TextChannel | DMChannel | NewsChannel | ThreadChannel, content: SendContent, extraOptions?: MessageCreateOptions): Promise<DiscordMessage<boolean>>;
-    $editMessage(options: EditMessageOptions): Promise<void>;
-    $recallMessage(id: string): Promise<void>;
-    /**
-     * 踢出成员
-     * @param guildId 服务器 ID
-     * @param userId 用户 ID
-     * @param reason 原因
-     */
+import type { EndpointInstance } from '@zhin.js/adapter';
+import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from '@zhin.js/plugin-runtime';
+import { type CreateDiscordClient } from './gateway.js';
+import { type DiscordButtonInbound, type DiscordInboundMessage, type ResolvedDiscordGatewayConfig, type ResolvedDiscordInteractionsConfig } from './protocol.js';
+export type { CreateDiscordClient, DiscordClientTransport, } from './gateway.js';
+export interface DiscordEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly config: ResolvedDiscordGatewayConfig;
+    readonly createClient?: CreateDiscordClient;
+}
+export declare class DiscordGatewayEndpoint implements EndpointInstance {
+    #private;
+    constructor(options: DiscordEndpointOptions);
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
+    /** Test / internal: admit a message when open. */
+    admit(msg: DiscordInboundMessage): void;
+    /** Test / internal: admit a button interaction when open. */
+    admitButton(interaction: DiscordButtonInbound): void;
+    addRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
+    removeRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
+    getRoles(guildId: string): Promise<unknown[]>;
+    createThread(channelId: string, name: string, messageId?: string, autoArchiveDuration?: number): Promise<{
+        id: string;
+    }>;
+    addReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
+    sendEmbed(channelId: string, embedData: Record<string, unknown>): Promise<{
+        id: string;
+    }>;
+    createForumPost(channelId: string, name: string, content: string, tags?: string[]): Promise<{
+        id: string;
+    }>;
     kickMember(guildId: string, userId: string, reason?: string): Promise<boolean>;
-    /**
-     * 封禁成员
-     * @param guildId 服务器 ID
-     * @param userId 用户 ID
-     * @param reason 原因
-     * @param deleteMessageDays 删除消息天数
-     */
-    banMember(guildId: string, userId: string, reason?: string, deleteMessageDays?: number): Promise<boolean>;
-    /**
-     * 解除封禁
-     * @param guildId 服务器 ID
-     * @param userId 用户 ID
-     * @param reason 原因
-     */
+    banMember(guildId: string, userId: string, reason?: string): Promise<boolean>;
     unbanMember(guildId: string, userId: string, reason?: string): Promise<boolean>;
-    /**
-     * 超时（禁言）成员
-     * @param guildId 服务器 ID
-     * @param userId 用户 ID
-     * @param duration 超时时长（秒），0 表示取消超时
-     * @param reason 原因
-     */
     timeoutMember(guildId: string, userId: string, duration?: number, reason?: string): Promise<boolean>;
-    /**
-     * 修改成员昵称
-     * @param guildId 服务器 ID
-     * @param userId 用户 ID
-     * @param nickname 新昵称
-     */
     setNickname(guildId: string, userId: string, nickname: string): Promise<boolean>;
-    /**
-     * 添加角色
-     * @param guildId 服务器 ID
-     * @param userId 用户 ID
-     * @param roleId 角色 ID
-     */
-    addRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
-    /**
-     * 移除角色
-     * @param guildId 服务器 ID
-     * @param userId 用户 ID
-     * @param roleId 角色 ID
-     */
-    removeRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
-    /**
-     * 获取服务器角色列表
-     * @param guildId 服务器 ID
-     */
-    getRoles(guildId: string): Promise<any[]>;
-    /**
-     * 获取成员列表
-     * @param guildId 服务器 ID
-     * @param limit 数量限制
-     */
-    getMembers(guildId: string, limit?: number): Promise<any[]>;
-    /**
-     * 获取服务器信息
-     * @param guildId 服务器 ID
-     */
-    getGuildInfo(guildId: string): Promise<any>;
-    createThread(channelId: string, name: string, messageId?: string, autoArchiveDuration?: number): Promise<ThreadChannel>;
-    addReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
-    private resolveDiscordMessageRef;
-    $addReaction(messageId: string, emoji: string): Promise<string | null>;
-    $removeReaction(messageId: string, reactionId: string): Promise<void>;
-    sendEmbed(channelId: string, embedData: {
-        title?: string;
-        description?: string;
-        color?: number;
-        url?: string;
-        fields?: {
-            name: string;
-            value: string;
-            inline?: boolean;
-        }[];
-    }): Promise<DiscordMessage<boolean>>;
-    createForumPost(channelId: string, name: string, content: string, tags?: string[]): Promise<ThreadChannel>;
-    handleFileSegment(data: any, files: AttachmentBuilder[], textContent: string): Promise<void>;
-    createEmbedFromData(data: any): EmbedBuilder;
-    private getActivityType;
-    private registerSlashCommands;
-    addSlashCommandHandler(commandName: string, handler: (interaction: ChatInputCommandInteraction) => Promise<void>): void;
-    removeSlashCommandHandler(commandName: string): boolean;
-    private fileExists;
-    static formatContentToText(content: SendContent): string;
+    getMembers(guildId: string, limit?: number): Promise<unknown[]>;
+    getGuildInfo(guildId: string): Promise<unknown>;
+}
+export interface DiscordInteractionsEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly http: HttpHost;
+    readonly config: ResolvedDiscordInteractionsConfig;
+    readonly fetch?: typeof globalThis.fetch;
+}
+export declare class DiscordInteractionsEndpoint implements EndpointInstance {
+    #private;
+    constructor(options: DiscordInteractionsEndpointOptions);
+    get isOpen(): boolean;
+    get config(): ResolvedDiscordInteractionsConfig;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
+    admit(msg: DiscordInboundMessage): void;
 }
-//# sourceMappingURL=endpoint.d.ts.map