telegram-botbuilder 1.6.6 → 2.0.1

package/lib/types/action.d.ts

@@ -0,0 +1,58 @@
+import type TelegramBot from "node-telegram-bot-api";
+import type { BotBuilder } from "../core/bot_builder.js";
+export interface ActionContext {
+    /** Chat ID */
+    chat_id: number;
+    /** Bot instance */
+    bot: BotBuilder;
+    /** Additional arguments passed to action */
+    args?: unknown[];
+    /** Raw message (if available) */
+    message?: TelegramBot.Message;
+    /** Raw callback query (if available) */
+    callback_query?: TelegramBot.CallbackQuery;
+    /** Matched command arguments (for command actions) */
+    command_args?: string;
+}
+export interface DialogActionContext extends ActionContext {
+    /** Previous dialog ID (for on_enter) or new dialog ID (for on_leave) */
+    other_dialog_id: string | undefined;
+}
+export type Action = (context: ActionContext) => void | Promise<void>;
+export type DialogAction = (context: DialogActionContext) => void | Promise<void>;
+export type CallbackFunction = (chat_id: number, ...args: unknown[]) => void | Promise<void>;
+export type InputType = "text" | "document" | "photo" | "video" | "audio" | "voice" | "contact" | "location";
+export interface WaitForInputOptions {
+    /** Timeout in milliseconds (default: from config) */
+    timeout?: number;
+    /** Allowed input types (default: depends on wait function) */
+    input_types?: InputType[];
+    /** Validation function - return true if valid, string for error message */
+    validator?: (input: string) => boolean | string | Promise<boolean | string>;
+    /** Message to show on validation failure */
+    validation_error_message?: string;
+    /** Message to show on timeout */
+    timeout_message?: string;
+    /** Cancel keywords (default: ["/cancel"]) */
+    cancel_keywords?: string[];
+    /** Message to show on cancel */
+    cancel_message?: string;
+}
+export interface WaitResult<T = string> {
+    success: boolean;
+    value?: T;
+    cancelled?: boolean;
+    timed_out?: boolean;
+    error?: string;
+}
+export interface FileWaitResult {
+    success: boolean;
+    file_id?: string;
+    file_content?: string;
+    file_name?: string;
+    mime_type?: string;
+    cancelled?: boolean;
+    timed_out?: boolean;
+    error?: string;
+}
+//# sourceMappingURL=action.d.ts.map

package/lib/types/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/types/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,mBAAmB;IACnB,GAAG,EAAE,UAAU,CAAC;IAEhB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IAEjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAE9B,wCAAwC;IACxC,cAAc,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC;IAE3C,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,wEAAwE;IACxE,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7F,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7G,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAE1B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAE5E,4CAA4C;IAC5C,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/lib/types/action.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=action.js.map

package/lib/types/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/types/action.ts"],"names":[],"mappings":""}

package/lib/types/config.d.ts

@@ -0,0 +1,36 @@
+import type TelegramBot from "node-telegram-bot-api";
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export interface CustomLogger {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+}
+export interface LoggerConfig {
+    /** Log level (default: "info") */
+    level?: LogLevel;
+    /** Custom logger implementation */
+    custom_logger?: CustomLogger;
+}
+export interface BotConfig {
+    /** Telegram bot token */
+    token: string;
+    /** node-telegram-bot-api options */
+    telegram_options?: TelegramBot.ConstructorOptions;
+    /** Enable /start command handling (default: true) */
+    enable_start_command?: boolean;
+    /** Parse mode for messages (default: "HTML") */
+    default_parse_mode?: "HTML" | "Markdown" | "MarkdownV2";
+    /** Logger configuration */
+    logger?: LoggerConfig;
+    /** Enable schema validation on startup (default: true) */
+    validate_schema?: boolean;
+    /** Auto-delete user messages in dialogs (default: true) */
+    auto_delete_user_messages?: boolean;
+    /** Timeout for waiting input in ms (default: 300000 = 5 min) */
+    default_input_timeout?: number;
+}
+export declare const DEFAULT_CONFIG: Required<Omit<BotConfig, "token" | "telegram_options" | "logger">> & {
+    logger: Required<LoggerConfig>;
+};
+//# sourceMappingURL=config.d.ts.map

package/lib/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,mCAAmC;IACnC,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC;IAElD,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAExD,2BAA2B;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,2DAA2D;IAC3D,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAEpC,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,kBAAkB,GAAG,QAAQ,CAAC,CAAC,GAAG;IAChG,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;CAWhC,CAAC"}

package/lib/types/config.js

@@ -0,0 +1,12 @@
+export const DEFAULT_CONFIG = {
+    enable_start_command: true,
+    default_parse_mode: "HTML",
+    validate_schema: true,
+    auto_delete_user_messages: true,
+    default_input_timeout: 300000,
+    logger: {
+        level: "info",
+        custom_logger: undefined,
+    },
+};
+//# sourceMappingURL=config.js.map

package/lib/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,cAAc,GAEvB;IACF,oBAAoB,EAAE,IAAI;IAC1B,kBAAkB,EAAE,MAAM;IAC1B,eAAe,EAAE,IAAI;IACrB,yBAAyB,EAAE,IAAI;IAC/B,qBAAqB,EAAE,MAAM;IAC7B,MAAM,EAAE;QACN,KAAK,EAAE,MAAM;QACb,aAAa,EAAE,SAAU;KAC1B;CACF,CAAC"}

package/lib/types/dialog.d.ts

@@ -0,0 +1,39 @@
+import type { Action, DialogAction } from "./action.js";
+import type { InlineButton, ReplyButton, ButtonSource, ReplyKeyboardOptions } from "./keyboard.js";
+export type TextSource = string | ((chat_id: number) => string | Promise<string>);
+export type ImageSource = string | string[] | ((chat_id: number) => string | string[] | undefined | Promise<string | string[] | undefined>);
+export interface Dialog {
+    /** Unique dialog identifier */
+    id: string;
+    /** Dialog text content (supports HTML by default) */
+    text?: TextSource;
+    /** Inline keyboard buttons (under the message) */
+    inline_buttons?: ButtonSource<InlineButton>;
+    /** Reply keyboard buttons (main keyboard) */
+    reply_buttons?: ButtonSource<ReplyButton>;
+    /** Reply keyboard options */
+    reply_keyboard_options?: ReplyKeyboardOptions;
+    /** Remove reply keyboard when entering this dialog */
+    remove_reply_keyboard?: boolean;
+    /** Images/photos to display */
+    images?: ImageSource;
+    /** Called when user enters this dialog */
+    on_enter?: DialogAction;
+    /** Called when user leaves this dialog */
+    on_leave?: DialogAction;
+    /** Disable web page preview for links (default: false) */
+    disable_web_page_preview?: boolean;
+    /** Protect content from forwarding/saving (default: false) */
+    protect_content?: boolean;
+}
+export interface Command {
+    /** Command name without slash (e.g., "help", "settings") */
+    name: string;
+    /** Command description for BotFather */
+    description?: string;
+    /** Action(s) to execute */
+    action?: Action | Action[];
+}
+export type { InlineButton, ReplyButton, ButtonSource, ReplyKeyboardOptions } from "./keyboard.js";
+export type { Action, DialogAction, ActionContext, DialogActionContext } from "./action.js";
+//# sourceMappingURL=dialog.d.ts.map

package/lib/types/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/types/dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEnG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAElF,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,MAAM,EAAE,GACR,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;AAElG,MAAM,WAAW,MAAM;IACrB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,qDAAqD;IACrD,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,kDAAkD;IAClD,cAAc,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;IAE5C,6CAA6C;IAC7C,aAAa,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IAE1C,6BAA6B;IAC7B,sBAAsB,CAAC,EAAE,oBAAoB,CAAC;IAE9C,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB,0DAA0D;IAC1D,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B;AAGD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACnG,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/lib/types/dialog.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dialog.js.map

package/lib/types/dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.js","sourceRoot":"","sources":["../../src/types/dialog.ts"],"names":[],"mappings":""}

package/lib/types/index.d.ts

@@ -0,0 +1,10 @@
+export type { LogLevel, CustomLogger, LoggerConfig, BotConfig, } from "./config.js";
+export { DEFAULT_CONFIG } from "./config.js";
+export type { Action, ActionContext, DialogAction, DialogActionContext, CallbackFunction, InputType, WaitForInputOptions, WaitResult, FileWaitResult, } from "./action.js";
+export type { InlineButton, ReplyButton, ReplyKeyboardOptions, ButtonSource, } from "./keyboard.js";
+export type { TextSource, ImageSource, Dialog, Command, } from "./dialog.js";
+export type { Schema } from "./schema.js";
+export type { UpdateType, MiddlewareContext, MiddlewareNext, Middleware, } from "./middleware.js";
+export type { MessageType, UserState, RegisteredInlineButton, RegisteredReplyButton, InternalDialog, InternalSchema, PendingInput, } from "./internal.js";
+export { DEFAULT_USER_STATE } from "./internal.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EACV,MAAM,EACN,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,UAAU,EACV,WAAW,EACX,MAAM,EACN,OAAO,GACR,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,WAAW,EACX,SAAS,EACT,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/lib/types/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_CONFIG } from "./config.js";
+export { DEFAULT_USER_STATE } from "./internal.js";
+//# sourceMappingURL=index.js.map

package/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAoD7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/lib/types/internal.d.ts

@@ -0,0 +1,58 @@
+import type { Dialog, InlineButton, ReplyButton } from "./dialog.js";
+export type MessageType = "text" | "photo" | "media_group";
+export interface UserState {
+    /** Current dialog ID */
+    current_dialog_id: string;
+    /** Last bot message ID (for editing) */
+    last_bot_message_id: number;
+    /** Type of last message sent */
+    last_message_type: MessageType;
+    /** Whether bot is waiting for user input */
+    waiting_for_input: boolean;
+    /** Unique ID for current input wait */
+    input_wait_id: string;
+    /** Types of input being waited for */
+    input_wait_types: string[];
+    /** Whether reply keyboard is currently shown */
+    reply_keyboard_active: boolean;
+    /** Custom user data storage */
+    custom_data: Record<string, unknown>;
+    /** Last activity timestamp */
+    last_activity: number;
+}
+export interface RegisteredInlineButton {
+    hash: string;
+    dialog_id: string;
+    button: InlineButton;
+}
+export interface RegisteredReplyButton {
+    text: string;
+    dialog_id: string;
+    button: ReplyButton;
+}
+export interface InternalDialog extends Dialog {
+    _compiled_inline_buttons?: RegisteredInlineButton[][];
+    _compiled_reply_buttons?: RegisteredReplyButton[][];
+}
+export interface InternalSchema {
+    start_dialog: string;
+    dialogs: Map<string, InternalDialog>;
+    commands: Map<string, import("./dialog.js").Command>;
+    inline_buttons: Map<string, RegisteredInlineButton>;
+    reply_buttons: Map<string, RegisteredReplyButton[]>;
+    error_dialog?: string;
+    fallback_action?: import("./action.js").Action;
+    reply_fallback_action?: import("./action.js").Action;
+}
+export interface PendingInput {
+    wait_id: string;
+    chat_id: number;
+    resolve: (result: unknown) => void;
+    reject: (error: Error) => void;
+    timeout_handle?: ReturnType<typeof setTimeout>;
+    input_types: string[];
+    validator?: (input: string) => boolean | string | Promise<boolean | string>;
+    cancel_keywords: string[];
+}
+export declare const DEFAULT_USER_STATE: Omit<UserState, "current_dialog_id">;
+//# sourceMappingURL=internal.d.ts.map

package/lib/types/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/types/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,wCAAwC;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,gCAAgC;IAChC,iBAAiB,EAAE,WAAW,CAAC;IAE/B,4CAA4C;IAC5C,iBAAiB,EAAE,OAAO,CAAC;IAE3B,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IAEtB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,gDAAgD;IAChD,qBAAqB,EAAE,OAAO,CAAC;IAE/B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,wBAAwB,CAAC,EAAE,sBAAsB,EAAE,EAAE,CAAC;IACtD,uBAAuB,CAAC,EAAE,qBAAqB,EAAE,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,OAAO,CAAC,CAAC;IACrD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACpD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,aAAa,EAAE,MAAM,CAAC;IAC/C,qBAAqB,CAAC,EAAE,OAAO,aAAa,EAAE,MAAM,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAC5E,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,eAAO,MAAM,kBAAkB,EAAE,IAAI,CAAC,SAAS,EAAE,mBAAmB,CASnE,CAAC"}

package/lib/types/internal.js

@@ -0,0 +1,11 @@
+export const DEFAULT_USER_STATE = {
+    last_bot_message_id: -1,
+    last_message_type: "text",
+    waiting_for_input: false,
+    input_wait_id: "",
+    input_wait_types: [],
+    reply_keyboard_active: false,
+    custom_data: {},
+    last_activity: Date.now(),
+};
+//# sourceMappingURL=internal.js.map

package/lib/types/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/types/internal.ts"],"names":[],"mappings":"AAwEA,MAAM,CAAC,MAAM,kBAAkB,GAAyC;IACtE,mBAAmB,EAAE,CAAC,CAAC;IACvB,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,KAAK;IACxB,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,EAAE;IACpB,qBAAqB,EAAE,KAAK;IAC5B,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE;CAC1B,CAAC"}

package/lib/types/keyboard.d.ts

@@ -0,0 +1,41 @@
+import type { Action, TextSource } from "./dialog.js";
+export interface InlineButton {
+    /** Button label */
+    text: TextSource;
+    /** Action(s) to execute on click */
+    action?: Action | Action[];
+    /** URL to open (mutually exclusive with action) */
+    url?: TextSource;
+    /** Mini app / Web app URL */
+    web_app?: TextSource;
+    /** Callback data override (auto-generated if not set) */
+    callback_data?: string;
+}
+export interface ReplyButton {
+    /** Button label */
+    text: TextSource;
+    /** Action(s) to execute when this text is received */
+    action?: Action | Action[];
+    /** Request contact from user */
+    request_contact?: boolean;
+    /** Request location from user */
+    request_location?: boolean;
+    /** Request poll from user */
+    request_poll?: {
+        type?: "quiz" | "regular";
+    };
+}
+export interface ReplyKeyboardOptions {
+    /** Resize keyboard to fit buttons (default: true) */
+    resize_keyboard?: boolean;
+    /** Hide keyboard after button press (default: false) */
+    one_time_keyboard?: boolean;
+    /** Placeholder text in input field */
+    input_field_placeholder?: string;
+    /** Show only to specific users in groups (default: false) */
+    selective?: boolean;
+    /** Keep keyboard persistent (default: false) */
+    is_persistent?: boolean;
+}
+export type ButtonSource<T> = T[][] | ((chat_id: number) => T[][] | Promise<T[][]>);
+//# sourceMappingURL=keyboard.d.ts.map

package/lib/types/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/types/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,IAAI,EAAE,UAAU,CAAC;IAEjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B,mDAAmD;IACnD,GAAG,CAAC,EAAE,UAAU,CAAC;IAEjB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,UAAU,CAAC;IAErB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,UAAU,CAAC;IAEjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B,gCAAgC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,6BAA6B;IAC7B,YAAY,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,sCAAsC;IACtC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC"}

package/lib/types/keyboard.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=keyboard.js.map

package/lib/types/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../src/types/keyboard.ts"],"names":[],"mappings":""}

package/lib/types/middleware.d.ts

@@ -0,0 +1,24 @@
+import type TelegramBot from "node-telegram-bot-api";
+import type { BotBuilder } from "../core/bot_builder.js";
+export type UpdateType = "message" | "callback_query" | "command" | "document" | "photo" | "contact" | "location";
+export interface MiddlewareContext {
+    /** Chat ID */
+    chat_id: number;
+    /** Bot instance */
+    bot: BotBuilder;
+    /** Original message (if applicable) */
+    message?: TelegramBot.Message;
+    /** Callback query (if applicable) */
+    callback_query?: TelegramBot.CallbackQuery;
+    /** Type of update being processed */
+    update_type: UpdateType;
+    /** User ID */
+    user_id: number;
+    /** Username (if available) */
+    username?: string;
+    /** Raw update timestamp */
+    timestamp: number;
+}
+export type MiddlewareNext = () => Promise<void>;
+export type Middleware = (context: MiddlewareContext, next: MiddlewareNext) => void | Promise<void>;
+//# sourceMappingURL=middleware.d.ts.map

package/lib/types/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/types/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAElH,MAAM,WAAW,iBAAiB;IAChC,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,mBAAmB;IACnB,GAAG,EAAE,UAAU,CAAC;IAEhB,uCAAuC;IACvC,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAE9B,qCAAqC;IACrC,cAAc,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC;IAE3C,qCAAqC;IACrC,WAAW,EAAE,UAAU,CAAC;IAExB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,cAAc,KACjB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/lib/types/middleware.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=middleware.js.map

package/lib/types/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/types/middleware.ts"],"names":[],"mappings":""}

package/lib/types/schema.d.ts

@@ -0,0 +1,17 @@
+import type { Action } from "./action.js";
+import type { Dialog, Command } from "./dialog.js";
+export interface Schema {
+    /** Starting dialog ID */
+    start_dialog: string;
+    /** All dialogs */
+    dialogs: Dialog[];
+    /** Bot commands (will be registered with BotFather format) */
+    commands?: Command[];
+    /** Global error dialog ID (shown on unhandled errors) */
+    error_dialog?: string;
+    /** Global fallback handler for unmatched messages */
+    fallback_action?: Action;
+    /** Fallback for unmatched reply keyboard buttons */
+    reply_fallback_action?: Action;
+}
+//# sourceMappingURL=schema.d.ts.map

package/lib/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,MAAM;IACrB,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IAErB,kBAAkB;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAErB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,oDAAoD;IACpD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/lib/types/schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.js.map

package/lib/types/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":""}

package/lib/utils/constants.d.ts

@@ -0,0 +1,33 @@
+/** Error messages for consistent messaging */
+export declare const ERROR_MESSAGES: {
+    readonly DIALOG_NOT_FOUND: (id: string) => string;
+    readonly BUTTON_NOT_FOUND: (hash: string) => string;
+    readonly SCHEMA_INVALID: "Invalid schema provided";
+    readonly START_DIALOG_MISSING: "start_dialog must reference an existing dialog";
+    readonly NO_DIALOGS: "Schema must contain at least one dialog";
+    readonly DUPLICATE_DIALOG_ID: (id: string) => string;
+    readonly DUPLICATE_COMMAND: (name: string) => string;
+    readonly INPUT_TIMEOUT: "Input timeout - operation cancelled";
+    readonly INPUT_CANCELLED: "Operation cancelled";
+    readonly VALIDATION_FAILED: (reason: string) => string;
+};
+/** Telegram API error substrings for detection */
+export declare const TELEGRAM_ERRORS: {
+    readonly MESSAGE_NOT_MODIFIED: "message is not modified";
+    readonly MESSAGE_NOT_FOUND: "message to edit not found";
+    readonly MESSAGE_DELETE_NOT_FOUND: "message to delete not found";
+    readonly BOT_BLOCKED: "bot was blocked by the user";
+    readonly USER_DEACTIVATED: "user is deactivated";
+    readonly CHAT_NOT_FOUND: "chat not found";
+    readonly QUERY_TOO_OLD: "query is too old";
+};
+/** Default values */
+export declare const DEFAULTS: {
+    readonly PARSE_MODE: "HTML";
+    readonly INPUT_TIMEOUT_MS: 300000;
+    readonly CANCEL_KEYWORDS: readonly ["/cancel"];
+    readonly MAX_CALLBACK_DATA_LENGTH: 64;
+    readonly MAX_MESSAGE_LENGTH: 4096;
+    readonly MAX_CAPTION_LENGTH: 1024;
+};
+//# sourceMappingURL=constants.d.ts.map

package/lib/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,cAAc;oCACF,MAAM;sCACJ,MAAM;;;;uCAIL,MAAM;uCACN,MAAM;;;yCAGJ,MAAM;CAC1B,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,eAAe;;;;;;;;CAQlB,CAAC;AAEX,qBAAqB;AACrB,eAAO,MAAM,QAAQ;;;;;;;CAOX,CAAC"}

package/lib/utils/constants.js

@@ -0,0 +1,33 @@
+/** Error messages for consistent messaging */
+export const ERROR_MESSAGES = {
+    DIALOG_NOT_FOUND: (id) => `Dialog "${id}" not found`,
+    BUTTON_NOT_FOUND: (hash) => `Button with hash "${hash}" not found`,
+    SCHEMA_INVALID: "Invalid schema provided",
+    START_DIALOG_MISSING: "start_dialog must reference an existing dialog",
+    NO_DIALOGS: "Schema must contain at least one dialog",
+    DUPLICATE_DIALOG_ID: (id) => `Duplicate dialog ID: "${id}"`,
+    DUPLICATE_COMMAND: (name) => `Duplicate command: "/${name}"`,
+    INPUT_TIMEOUT: "Input timeout - operation cancelled",
+    INPUT_CANCELLED: "Operation cancelled",
+    VALIDATION_FAILED: (reason) => `Validation failed: ${reason}`,
+};
+/** Telegram API error substrings for detection */
+export const TELEGRAM_ERRORS = {
+    MESSAGE_NOT_MODIFIED: "message is not modified",
+    MESSAGE_NOT_FOUND: "message to edit not found",
+    MESSAGE_DELETE_NOT_FOUND: "message to delete not found",
+    BOT_BLOCKED: "bot was blocked by the user",
+    USER_DEACTIVATED: "user is deactivated",
+    CHAT_NOT_FOUND: "chat not found",
+    QUERY_TOO_OLD: "query is too old",
+};
+/** Default values */
+export const DEFAULTS = {
+    PARSE_MODE: "HTML",
+    INPUT_TIMEOUT_MS: 300000, // 5 minutes
+    CANCEL_KEYWORDS: ["/cancel"],
+    MAX_CALLBACK_DATA_LENGTH: 64,
+    MAX_MESSAGE_LENGTH: 4096,
+    MAX_CAPTION_LENGTH: 1024,
+};
+//# sourceMappingURL=constants.js.map

package/lib/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,gBAAgB,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,EAAE,aAAa;IAC5D,gBAAgB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,qBAAqB,IAAI,aAAa;IAC1E,cAAc,EAAE,yBAAyB;IACzC,oBAAoB,EAAE,gDAAgD;IACtE,UAAU,EAAE,yCAAyC;IACrD,mBAAmB,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,yBAAyB,EAAE,GAAG;IACnE,iBAAiB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,wBAAwB,IAAI,GAAG;IACpE,aAAa,EAAE,qCAAqC;IACpD,eAAe,EAAE,qBAAqB;IACtC,iBAAiB,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,sBAAsB,MAAM,EAAE;CAC7D,CAAC;AAEX,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,oBAAoB,EAAE,yBAAyB;IAC/C,iBAAiB,EAAE,2BAA2B;IAC9C,wBAAwB,EAAE,6BAA6B;IACvD,WAAW,EAAE,6BAA6B;IAC1C,gBAAgB,EAAE,qBAAqB;IACvC,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,kBAAkB;CACzB,CAAC;AAEX,qBAAqB;AACrB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,UAAU,EAAE,MAAe;IAC3B,gBAAgB,EAAE,MAAM,EAAE,YAAY;IACtC,eAAe,EAAE,CAAC,SAAS,CAAC;IAC5B,wBAAwB,EAAE,EAAE;IAC5B,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;CAChB,CAAC"}

package/lib/utils/deep_copy.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Deep copy an object, preserving functions by reference.
+ * Functions cannot be cloned, so they remain as references.
+ */
+export declare function deep_copy<T>(obj: T): T;
+//# sourceMappingURL=deep_copy.d.ts.map

package/lib/utils/deep_copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep_copy.d.ts","sourceRoot":"","sources":["../../src/utils/deep_copy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CA+CtC"}

package/lib/utils/deep_copy.js

@@ -0,0 +1,45 @@
+/**
+ * Deep copy an object, preserving functions by reference.
+ * Functions cannot be cloned, so they remain as references.
+ */
+export function deep_copy(obj) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (typeof obj === "function") {
+        return obj; // Functions cannot be cloned
+    }
+    if (typeof obj !== "object") {
+        return obj; // Primitives
+    }
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    if (obj instanceof RegExp) {
+        return new RegExp(obj.source, obj.flags);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => deep_copy(item));
+    }
+    if (obj instanceof Map) {
+        const copy = new Map();
+        obj.forEach((value, key) => {
+            copy.set(deep_copy(key), deep_copy(value));
+        });
+        return copy;
+    }
+    if (obj instanceof Set) {
+        const copy = new Set();
+        obj.forEach((value) => {
+            copy.add(deep_copy(value));
+        });
+        return copy;
+    }
+    // Plain object
+    const copy = {};
+    for (const key of Object.keys(obj)) {
+        copy[key] = deep_copy(obj[key]);
+    }
+    return copy;
+}
+//# sourceMappingURL=deep_copy.js.map

package/lib/utils/deep_copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep_copy.js","sourceRoot":"","sources":["../../src/utils/deep_copy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,GAAM;IACjC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,CAAC,6BAA6B;IAC3C,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,CAAC,aAAa;IAC3B,CAAC;IAED,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAM,CAAC;IACtC,CAAC;IAED,IAAI,GAAG,YAAY,MAAM,EAAE,CAAC;QAC1B,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAM,CAAC;IAChD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAM,CAAC;IACjD,CAAC;IAED,IAAI,GAAG,YAAY,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACzB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,IAAI,GAAG,YAAY,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,eAAe;IACf,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAS,CAAC;AACnB,CAAC"}

package/lib/utils/hash.d.ts

@@ -0,0 +1,17 @@
+export interface HashableButton {
+    text?: string | ((...args: unknown[]) => unknown);
+    action?: unknown;
+    url?: string | ((...args: unknown[]) => unknown);
+    web_app?: string | ((...args: unknown[]) => unknown);
+    callback_data?: string;
+}
+/**
+ * Generate a deterministic hash for a button based on its properties.
+ * Used for matching callback_data to buttons.
+ */
+export declare function hash_button(dialog_id: string, button: HashableButton, index?: number): string;
+/**
+ * Generate a unique ID for input waiting
+ */
+export declare function generate_wait_id(): string;
+//# sourceMappingURL=hash.d.ts.map

package/lib/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CA4C7F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/lib/utils/hash.js

@@ -0,0 +1,50 @@
+import { createHash } from "node:crypto";
+/**
+ * Generate a deterministic hash for a button based on its properties.
+ * Used for matching callback_data to buttons.
+ */
+export function hash_button(dialog_id, button, index) {
+    // If callback_data is explicitly set, use it
+    if (button.callback_data) {
+        return button.callback_data;
+    }
+    const hash_input = {
+        dialog_id,
+    };
+    // Include text if it's a string
+    if (typeof button.text === "string") {
+        hash_input.text = button.text;
+    }
+    // Include url if it's a string
+    if (typeof button.url === "string") {
+        hash_input.url = button.url;
+    }
+    // Include web_app if it's a string
+    if (typeof button.web_app === "string") {
+        hash_input.web_app = button.web_app;
+    }
+    // Include index for uniqueness when other properties are dynamic
+    if (index !== undefined) {
+        hash_input.index = index;
+    }
+    // Include action reference for uniqueness
+    if (button.action) {
+        if (typeof button.action === "function") {
+            hash_input.action_name = button.action.name || "anonymous";
+        }
+        else if (Array.isArray(button.action)) {
+            hash_input.action_count = button.action.length;
+        }
+    }
+    const json = JSON.stringify(hash_input, Object.keys(hash_input).sort());
+    const hash = createHash("sha256").update(json).digest("hex");
+    // Return first 16 chars - enough for uniqueness, fits callback_data limit
+    return hash.substring(0, 16);
+}
+/**
+ * Generate a unique ID for input waiting
+ */
+export function generate_wait_id() {
+    return crypto.randomUUID();
+}
+//# sourceMappingURL=hash.js.map