telegram-botbuilder 1.6.5 → 2.0.0

package/lib/actions/wait_for_input.d.ts

@@ -0,0 +1,14 @@
+import type { Action, WaitForInputOptions, CallbackFunction } from "../types/action.js";
+/**
+ * Create an action that waits for text input and calls handler with result
+ */
+export declare function wait_for_text(handler: CallbackFunction | string, options?: WaitForInputOptions): Action;
+/**
+ * Create an action that waits for file upload and calls handler with result
+ */
+export declare function wait_for_file(handler: CallbackFunction | string, options?: WaitForInputOptions): Action;
+/**
+ * Create an action that waits for photo upload
+ */
+export declare function wait_for_photo(handler: CallbackFunction | string, options?: WaitForInputOptions): Action;
+//# sourceMappingURL=wait_for_input.d.ts.map

package/lib/actions/wait_for_input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait_for_input.d.ts","sourceRoot":"","sources":["../../src/actions/wait_for_input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAExF;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAClC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAKR"}

package/lib/actions/wait_for_input.js

@@ -0,0 +1,54 @@
+/**
+ * Create an action that waits for text input and calls handler with result
+ */
+export function wait_for_text(handler, options) {
+    return async (context) => {
+        const result = await context.bot.wait_for_text(context.chat_id, options);
+        if (result.success && result.value !== undefined) {
+            if (typeof handler === "string") {
+                context.bot.events.emit(handler, context.chat_id, result.value);
+            }
+            else {
+                await handler(context.chat_id, result.value);
+            }
+        }
+        else if (result.cancelled && typeof handler === "string") {
+            context.bot.events.emit(`${handler}_cancelled`, context.chat_id);
+        }
+        else if (result.timed_out && typeof handler === "string") {
+            context.bot.events.emit(`${handler}_timeout`, context.chat_id);
+        }
+    };
+}
+/**
+ * Create an action that waits for file upload and calls handler with result
+ */
+export function wait_for_file(handler, options) {
+    return async (context) => {
+        const result = await context.bot.wait_for_file(context.chat_id, options);
+        if (result.success) {
+            if (typeof handler === "string") {
+                context.bot.events.emit(handler, context.chat_id, result);
+            }
+            else {
+                await handler(context.chat_id, result);
+            }
+        }
+        else if (result.cancelled && typeof handler === "string") {
+            context.bot.events.emit(`${handler}_cancelled`, context.chat_id);
+        }
+        else if (result.timed_out && typeof handler === "string") {
+            context.bot.events.emit(`${handler}_timeout`, context.chat_id);
+        }
+    };
+}
+/**
+ * Create an action that waits for photo upload
+ */
+export function wait_for_photo(handler, options) {
+    return wait_for_file(handler, {
+        ...options,
+        input_types: ["photo"],
+    });
+}
+//# sourceMappingURL=wait_for_input.js.map

package/lib/actions/wait_for_input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait_for_input.js","sourceRoot":"","sources":["../../src/actions/wait_for_input.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAkC,EAClC,OAA6B;IAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEzE,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACjD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAkC,EAClC,OAA6B;IAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEzE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAkC,EAClC,OAA6B;IAE7B,OAAO,aAAa,CAAC,OAAO,EAAE;QAC5B,GAAG,OAAO;QACV,WAAW,EAAE,CAAC,OAAO,CAAC;KACvB,CAAC,CAAC;AACL,CAAC"}

package/lib/core/bot_builder.d.ts

@@ -0,0 +1,145 @@
+import TelegramBot from "node-telegram-bot-api";
+import { EventEmitter } from "node:events";
+import type { Schema } from "../types/schema.js";
+import type { BotConfig } from "../types/config.js";
+import type { WaitForInputOptions, WaitResult, FileWaitResult } from "../types/action.js";
+import type { Dialog } from "../types/dialog.js";
+import type { Middleware } from "../types/middleware.js";
+import type { UserState } from "../types/internal.js";
+export declare class BotBuilder {
+    /** Raw telegram bot instance (for advanced usage) */
+    readonly telegram: TelegramBot;
+    /** Event emitter for custom events */
+    readonly events: EventEmitter;
+    private readonly config;
+    private readonly logger;
+    private readonly schema;
+    private readonly dialog_manager;
+    private readonly button_registry;
+    private readonly keyboard_builder;
+    private readonly middleware_chain;
+    private readonly input_manager;
+    constructor(schema: Schema, config: BotConfig);
+    /**
+     * Add middleware to the processing chain
+     */
+    use(middleware: Middleware): this;
+    /**
+     * Navigate user to a specific dialog
+     */
+    change_dialog(chat_id: number, dialog_id: string): Promise<void>;
+    /**
+     * Send a standalone message (not part of dialog system)
+     */
+    send_message(chat_id: number, text: string, options?: {
+        parse_mode?: "HTML" | "Markdown" | "MarkdownV2";
+        disable_web_page_preview?: boolean;
+        disable_notification?: boolean;
+        protect_content?: boolean;
+    }): Promise<TelegramBot.Message>;
+    /**
+     * Get current user state
+     */
+    get_user_state(chat_id: number): UserState;
+    /**
+     * Set custom data in user state
+     */
+    set_user_data(chat_id: number, key: string, value: unknown): void;
+    /**
+     * Get custom data from user state
+     */
+    get_user_data<T>(chat_id: number, key: string): T | undefined;
+    /**
+     * Reset user state to start dialog
+     */
+    reset_user(chat_id: number): Promise<void>;
+    /**
+     * Delete a message
+     */
+    delete_message(chat_id: number, message_id: number): Promise<boolean>;
+    /**
+     * Get a dialog by ID
+     */
+    get_dialog(dialog_id: string): Dialog | undefined;
+    /**
+     * Wait for user text input
+     */
+    wait_for_text(chat_id: number, options?: WaitForInputOptions): Promise<WaitResult<string>>;
+    /**
+     * Wait for user file upload
+     */
+    wait_for_file(chat_id: number, options?: WaitForInputOptions): Promise<FileWaitResult>;
+    /**
+     * Graceful shutdown
+     */
+    stop(): Promise<void>;
+    /**
+     * Set up all message handlers
+     */
+    private setup_handlers;
+    /**
+     * Handle /start command
+     */
+    private handle_start;
+    /**
+     * Handle other commands
+     */
+    private handle_command;
+    /**
+     * Handle callback queries (inline button clicks)
+     */
+    private handle_callback;
+    /**
+     * Handle regular text messages
+     */
+    private handle_message;
+    /**
+     * Handle text input when waiting
+     */
+    private handle_text_input;
+    /**
+     * Handle reply keyboard button press
+     */
+    private handle_reply_button;
+    /**
+     * Handle document upload
+     */
+    private handle_document;
+    /**
+     * Handle photo upload
+     */
+    private handle_photo;
+    /**
+     * Handle contact share
+     */
+    private handle_contact;
+    /**
+     * Handle location share
+     */
+    private handle_location;
+    /**
+     * Run middleware chain
+     */
+    private run_middleware;
+    /**
+     * Execute an action or array of actions
+     */
+    private execute_action;
+    /**
+     * Render a dialog to the user
+     */
+    private render_dialog;
+    /**
+     * Render dialog with images
+     */
+    private render_with_images;
+    /**
+     * Render text-only dialog
+     */
+    private render_text_only;
+    /**
+     * Send a new message (used as fallback)
+     */
+    private send_new_message;
+}
+//# sourceMappingURL=bot_builder.d.ts.map

package/lib/core/bot_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot_builder.d.ts","sourceRoot":"","sources":["../../src/core/bot_builder.ts"],"names":[],"mappings":"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"}