@zhin.js/adapter-telegram 5.0.1 → 5.0.3

package/lib/endpoint.d.ts

@@ -1,155 +1,65 @@
 /**
- * Telegram Endpoint 实现
+ * TelegramEndpoint — lifecycle, outbound, admit, Bot API helpers for agent tools.
  */
-import { Telegraf } from "telegraf";
-import type { Message as TelegramMessage, ChatMember } from "telegraf/types";
-import { Endpoint, Message, SendOptions, type QuotedMessagePayload } from 'zhin.js';
-import type { TelegramEndpointConfig } from "./types.js";
-import type { TelegramAdapter } from "./adapter.js";
-export declare class TelegramEndpoint extends Telegraf implements Endpoint<TelegramEndpointConfig, TelegramMessage> {
-    adapter: TelegramAdapter;
-    $config: TelegramEndpointConfig;
-    $connected: boolean;
-    /** message_id -> chat_id，用于在仅有 message_id 的场景执行 reaction 操作 */
-    private readonly messageChatMap;
-    /** reply_to_message 解析结果缓存，供 $getMsg 使用 */
-    private readonly quotedPayloadCache;
-    get pluginLogger(): import("zhin.js").Logger;
-    get $id(): string;
-    constructor(adapter: TelegramAdapter, $config: TelegramEndpointConfig);
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    private static readonly CHAT_MEMBER_CACHE_TTL_MS;
-    private static readonly CHAT_MEMBER_CACHE_MAX;
-    private chatMemberCache;
-    private sweepChatMemberCache;
-    private enrichGroupSender;
-    private handleTelegramMessage;
-    $formatMessage(msg: TelegramMessage): Message<TelegramMessage>;
-    $getMsg(messageId: string): Promise<QuotedMessagePayload>;
-    private cacheQuotedTelegramMessage;
-    private $formatCallbackQuery;
-    private parseMessageContent;
-    private parseTextWithEntities;
-    $sendMessage(options: SendOptions): Promise<string>;
-    $editMessage(options: import('zhin.js').EditMessageOptions): Promise<void>;
-    private sendContentToChat;
-    $recallMessage(id: string): Promise<void>;
-    private resolveTelegramMessageRef;
-    $addReaction(messageId: string, emoji: string): Promise<string | null>;
-    $removeReaction(messageId: string, _reactionId: string): Promise<void>;
-    /**
-     * 踢出用户
-     * @param chatId 聊天 ID
-     * @param userId 用户 ID
-     * @param untilDate 封禁截止时间（Unix 时间戳），0 表示永久
-     */
-    kickMember(chatId: number, userId: number, untilDate?: number): Promise<boolean>;
-    /**
-     * 解除封禁
-     * @param chatId 聊天 ID
-     * @param userId 用户 ID
-     */
-    unbanMember(chatId: number, userId: number): Promise<boolean>;
-    /**
-     * 限制用户权限（禁言等）
-     * @param chatId 聊天 ID
-     * @param userId 用户 ID
-     * @param permissions 权限设置
-     * @param untilDate 限制截止时间
-     */
-    restrictMember(chatId: number, userId: number, permissions: {
-        can_send_messages?: boolean;
-        can_send_media_messages?: boolean;
-        can_send_polls?: boolean;
-        can_send_other_messages?: boolean;
-        can_add_web_page_previews?: boolean;
-        can_change_info?: boolean;
-        can_invite_users?: boolean;
-        can_pin_messages?: boolean;
-    }, untilDate?: number): Promise<boolean>;
-    /**
-     * 禁言用户
-     * @param chatId 聊天 ID
-     * @param userId 用户 ID
-     * @param duration 禁言时长（秒），0 表示解除禁言
-     */
-    muteMember(chatId: number, userId: number, duration?: number): Promise<boolean>;
-    /**
-     * 提升/降级管理员
-     * @param chatId 聊天 ID
-     * @param userId 用户 ID
-     * @param promote 是否提升为管理员
-     */
-    setAdmin(chatId: number, userId: number, promote?: boolean): Promise<boolean>;
-    /**
-     * 设置聊天标题
-     * @param chatId 聊天 ID
-     * @param title 新标题
-     */
-    setChatTitle(chatId: number, title: string): Promise<boolean>;
-    /**
-     * 设置聊天描述
-     * @param chatId 聊天 ID
-     * @param description 新描述
-     */
-    setChatDescription(chatId: number, description: string): Promise<boolean>;
-    /**
-     * 置顶消息
-     * @param chatId 聊天 ID
-     * @param messageId 消息 ID
-     */
+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 ResolvedTelegramConfig, type TelegramCallbackQuery, type TelegramChatMember, type TelegramMessage, type TelegramUpdate } from './protocol.js';
+export type TelegramFetch = (url: string, init?: {
+    readonly method?: string;
+    readonly headers?: Record<string, string>;
+    readonly body?: string;
+    readonly signal?: AbortSignal;
+}) => Promise<{
+    readonly ok: boolean;
+    readonly status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+export interface TelegramEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly config: ResolvedTelegramConfig;
+    readonly http?: HttpHost;
+    readonly fetch?: TelegramFetch;
+}
+export declare class TelegramEndpoint implements EndpointInstance {
+    #private;
+    constructor(options: TelegramEndpointOptions);
+    /** Used by webhook handler. */
+    get isOpen(): boolean;
+    get config(): ResolvedTelegramConfig;
+    get allowedUpdates(): readonly string[];
+    getUpdateOffset(): number;
+    setUpdateOffset(offset: number): void;
+    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: TelegramMessage): void;
+    /** Test / internal: admit a callback query when open. */
+    admitCallback(query: TelegramCallbackQuery): void;
+    /** Used by webhook / polling handlers. */
+    handleUpdate(update: TelegramUpdate): void;
+    callApi<T = unknown>(method: string, params?: Record<string, unknown>, signal?: AbortSignal): Promise<T>;
     pinMessage(chatId: number, messageId: number): Promise<boolean>;
-    /**
-     * 取消置顶消息
-     * @param chatId 聊天 ID
-     * @param messageId 消息 ID（可选，不提供则取消所有置顶）
-     */
     unpinMessage(chatId: number, messageId?: number): Promise<boolean>;
-    /**
-     * 获取聊天信息
-     * @param chatId 聊天 ID
-     */
-    getChatInfo(chatId: number): Promise<any>;
-    /**
-     * 获取聊天成员
-     * @param chatId 聊天 ID
-     * @param userId 用户 ID
-     */
-    getChatMember(chatId: number, userId: number): Promise<ChatMember>;
-    /**
-     * 获取管理员列表
-     * @param chatId 聊天 ID
-     */
-    getChatAdmins(chatId: number): Promise<ChatMember[]>;
-    /**
-     * 获取聊天成员数量
-     * @param chatId 聊天 ID
-     */
+    setChatDescription(chatId: number, description: string): Promise<boolean>;
+    setMessageReaction(chatId: number, messageId: number, reaction: string): Promise<boolean>;
     getChatMemberCount(chatId: number): Promise<number>;
-    /**
-     * 创建邀请链接
-     * @param chatId 聊天 ID
-     */
+    getChatAdmins(chatId: number): Promise<TelegramChatMember[]>;
+    sendStickerMessage(chatId: number, sticker: string): Promise<{
+        message_id: number;
+    }>;
+    setChatPermissionsAll(chatId: number, permissions: Record<string, boolean | undefined>): Promise<boolean>;
     createInviteLink(chatId: number): Promise<string>;
-    sendPoll(chatId: number, question: string, options: string[], isAnonymous?: boolean, allowsMultipleAnswers?: boolean): Promise<TelegramMessage>;
-    setMessageReaction(chatId: number, messageId: number, reaction: string): Promise<boolean>;
-    sendStickerMessage(chatId: number, sticker: string): Promise<TelegramMessage>;
-    setChatPermissionsAll(chatId: number, permissions: {
-        can_send_messages?: boolean;
-        can_send_audios?: boolean;
-        can_send_documents?: boolean;
-        can_send_photos?: boolean;
-        can_send_videos?: boolean;
-        can_send_video_notes?: boolean;
-        can_send_voice_notes?: boolean;
-        can_send_polls?: boolean;
-        can_send_other_messages?: boolean;
-        can_add_web_page_previews?: boolean;
-        can_change_info?: boolean;
-        can_invite_users?: boolean;
-        can_pin_messages?: boolean;
-        can_manage_topics?: boolean;
-    }): Promise<boolean>;
+    sendPoll(chatId: number, question: string, options: string[], isAnonymous?: boolean, allowsMultipleAnswers?: boolean): Promise<{
+        message_id: number;
+    }>;
 }
-//# sourceMappingURL=endpoint.d.ts.map