telegram-botbuilder 1.6.5 → 2.0.0

package/README.md

@@ -0,0 +1,403 @@
+# telegram-botbuilder
+
+> 🤖 Declarative dialog-based Telegram bot framework for Node.js
+
+[![npm version](https://img.shields.io/npm/v/telegram-botbuilder.svg)](https://www.npmjs.com/package/telegram-botbuilder)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/telegram-botbuilder.svg)](https://nodejs.org)
+
+Build Telegram bots with a simple, declarative dialog-based approach. Define your bot's conversation flow as a schema of dialogs and let the framework handle the rest.
+
+## ✨ Features
+
+- 📝 **Declarative Schema** - Define dialogs, buttons, and commands in a clear structure
+- 🔀 **Dialog Navigation** - Seamless transitions between conversation states
+- ⌨️ **Dual Keyboard Support** - Both inline and reply keyboards
+- 🔗 **Action Chaining** - Compose complex behaviors from simple actions
+- 🛡️ **Type-Safe** - Full TypeScript support with strict types
+- 🔌 **Middleware System** - Extend functionality with custom middleware
+- ✅ **Schema Validation** - Catch configuration errors early with Zod validation
+- 📊 **Configurable Logging** - Built-in logger with custom logger support
+- 🎯 **Input Handling** - Wait for text, files, photos with validation and timeouts
+
+## 📦 Installation
+
+```bash
+npm install telegram-botbuilder
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { BotBuilder, go_to, notify, type Schema } from "telegram-botbuilder";
+
+const schema: Schema = {
+  start_dialog: "welcome",
+  
+  dialogs: [
+    {
+      id: "welcome",
+      text: "👋 Welcome! Choose an option:",
+      inline_buttons: [
+        [
+          { text: "📖 About", action: go_to("about") },
+          { text: "⚙️ Settings", action: go_to("settings") },
+        ],
+        [
+          { text: "❓ Help", action: notify("This is a help message!") },
+        ],
+      ],
+    },
+    {
+      id: "about",
+      text: "ℹ️ This is a demo bot built with telegram-botbuilder.",
+      inline_buttons: [
+        [{ text: "⬅️ Back", action: go_to("welcome") }],
+      ],
+    },
+    {
+      id: "settings",
+      text: "⚙️ Settings menu",
+      inline_buttons: [
+        [{ text: "⬅️ Back", action: go_to("welcome") }],
+      ],
+    },
+  ],
+  
+  commands: [
+    { name: "help", action: notify("Use /start to begin!") },
+  ],
+};
+
+const bot = new BotBuilder(schema, {
+  token: process.env.BOT_TOKEN!,
+  telegram_options: { polling: true },
+});
+
+console.log("Bot is running...");
+```
+
+## 📚 Core Concepts
+
+### Schema
+
+The schema defines your entire bot structure:
+
+```typescript
+interface Schema {
+  start_dialog: string;           // Initial dialog ID
+  dialogs: Dialog[];              // All dialogs
+  commands?: Command[];           // Bot commands
+  error_dialog?: string;          // Shown on errors
+  fallback_action?: Action;       // Unmatched messages
+}
+```
+
+### Dialogs
+
+Dialogs are conversation states with text and buttons:
+
+```typescript
+interface Dialog {
+  id: string;                     // Unique identifier
+  text?: TextSource;              // Message text (string or function)
+  inline_buttons?: ButtonSource;  // Inline keyboard
+  reply_buttons?: ButtonSource;   // Reply keyboard
+  images?: ImageSource;           // Photos to display
+  on_enter?: DialogAction;        // Called when entering
+  on_leave?: DialogAction;        // Called when leaving
+}
+```
+
+### Dynamic Content
+
+Text, buttons, and images can be static or dynamic:
+
+```typescript
+// Static
+text: "Hello, world!"
+
+// Dynamic (sync)
+text: (chat_id) => `Hello, user ${chat_id}!`
+
+// Dynamic (async)
+text: async (chat_id) => {
+  const user = await db.getUser(chat_id);
+  return `Hello, ${user.name}!`;
+}
+```
+
+### Buttons
+
+#### Inline Buttons (under messages)
+
+```typescript
+inline_buttons: [
+  [
+    { text: "Click me", action: go_to("other_dialog") },
+    { text: "Open link", url: "https://example.com" },
+  ],
+  [
+    { text: "Web App", web_app: "https://webapp.example.com" },
+  ],
+]
+```
+
+#### Reply Buttons (main keyboard)
+
+```typescript
+reply_buttons: [
+  [
+    { text: "📞 Share Contact", request_contact: true },
+    { text: "📍 Share Location", request_location: true },
+  ],
+  [
+    { text: "Option A", action: go_to("option_a") },
+    { text: "Option B", action: go_to("option_b") },
+  ],
+],
+reply_keyboard_options: {
+  resize_keyboard: true,
+  one_time_keyboard: false,
+}
+```
+
+## 🎬 Actions
+
+Actions are functions that execute when buttons are clicked or commands are received.
+
+### Navigation
+
+```typescript
+import { go_to, go_to_start } from "telegram-botbuilder";
+
+// Navigate to specific dialog
+go_to("dialog_id")
+
+// Reset to start dialog
+go_to_start()
+```
+
+### Messaging
+
+```typescript
+import { notify, notify_dynamic } from "telegram-botbuilder";
+
+// Send static message
+notify("Hello!")
+
+// Auto-delete after 5 seconds
+notify("Temporary message", { auto_delete_ms: 5000 })
+
+// Dynamic message
+notify_dynamic((chat_id) => `Your ID: ${chat_id}`)
+```
+
+### Event Emission
+
+```typescript
+import { emit, call } from "telegram-botbuilder";
+
+// Emit event
+emit("button_clicked", "extra_data")
+
+// Listen for event
+bot.events.on("button_clicked", (chat_id, data) => {
+  console.log(`User ${chat_id} clicked, data: ${data}`);
+});
+
+// Call function directly
+call(async (chat_id, ...args) => {
+  await someAsyncOperation(chat_id);
+}, arg1, arg2)
+```
+
+### Input Waiting
+
+```typescript
+import { wait_for_text, wait_for_file, wait_for_photo } from "telegram-botbuilder";
+
+// Wait for text input
+wait_for_text(async (chat_id, text) => {
+  console.log(`User ${chat_id} entered: ${text}`);
+}, {
+  timeout: 60000,              // 1 minute timeout
+  validator: (input) => {      // Validation
+    if (input.length < 3) return "Too short!";
+    return true;
+  },
+  cancel_keywords: ["/cancel", "cancel"],
+})
+
+// Wait for file
+wait_for_file("file_received", {
+  input_types: ["document", "photo"],
+})
+
+// Wait for photo specifically
+wait_for_photo((chat_id, result) => {
+  console.log(`Photo file_id: ${result.file_id}`);
+})
+```
+
+### Control Flow
+
+```typescript
+import { sequence, when, delay, when_data, set_data } from "telegram-botbuilder";
+
+// Execute multiple actions
+sequence(
+  notify("Step 1"),
+  delay(1000, notify("Step 2")),
+  go_to("next_dialog")
+)
+
+// Conditional execution
+when(
+  (ctx) => ctx.bot.get_user_data(ctx.chat_id, "is_admin"),
+  go_to("admin_panel"),
+  notify("Access denied")
+)
+
+// Check user data
+when_data<boolean>("premium", 
+  (value) => value === true,
+  go_to("premium_features"),
+  notify("Upgrade to premium!")
+)
+
+// Set/modify user data
+set_data("counter", (chat_id) => {
+  const current = bot.get_user_data<number>(chat_id, "counter") ?? 0;
+  return current + 1;
+})
+```
+
+## 🔌 Middleware
+
+Add custom logic to process all updates:
+
+```typescript
+// Logging middleware
+bot.use(async (ctx, next) => {
+  console.log(`[${ctx.update_type}] User ${ctx.chat_id}`);
+  await next(); // Continue to next middleware/handler
+});
+
+// Auth middleware
+bot.use(async (ctx, next) => {
+  const allowed = await checkUserAllowed(ctx.user_id);
+  if (!allowed) {
+    await ctx.bot.send_message(ctx.chat_id, "Access denied");
+    return; // Don't call next() - stops processing
+  }
+  await next();
+});
+
+// Rate limiting
+const requests = new Map<number, number>();
+bot.use(async (ctx, next) => {
+  const count = requests.get(ctx.chat_id) ?? 0;
+  if (count > 10) {
+    await ctx.bot.send_message(ctx.chat_id, "Too many requests!");
+    return;
+  }
+  requests.set(ctx.chat_id, count + 1);
+  setTimeout(() => requests.delete(ctx.chat_id), 60000);
+  await next();
+});
+```
+
+## 🎛️ Configuration
+
+```typescript
+const bot = new BotBuilder(schema, {
+  token: "YOUR_BOT_TOKEN",
+  
+  // Telegram API options
+  telegram_options: {
+    polling: true,
+    // or webhook configuration
+  },
+  
+  // Enable /start command (default: true)
+  enable_start_command: true,
+  
+  // Parse mode for messages (default: "HTML")
+  default_parse_mode: "HTML",
+  
+  // Schema validation (default: true)
+  validate_schema: true,
+  
+  // Auto-delete user messages (default: true)
+  auto_delete_user_messages: true,
+  
+  // Default input timeout (default: 5 minutes)
+  default_input_timeout: 300000,
+  
+  // Logging
+  logger: {
+    level: "info", // "debug" | "info" | "warn" | "error" | "silent"
+    
+    // Custom logger (optional)
+    custom_logger: {
+      debug: (msg, ...args) => myLogger.debug(msg, ...args),
+      info: (msg, ...args) => myLogger.info(msg, ...args),
+      warn: (msg, ...args) => myLogger.warn(msg, ...args),
+      error: (msg, ...args) => myLogger.error(msg, ...args),
+    },
+  },
+});
+```
+
+## 📖 API Reference
+
+### BotBuilder
+
+```typescript
+class BotBuilder {
+  // Properties
+  telegram: TelegramBot;           // Raw telegram bot instance
+  events: EventEmitter;            // Event emitter
+  
+  // Methods
+  use(middleware: Middleware): this;
+  change_dialog(chat_id: number, dialog_id: string): Promise<void>;
+  send_message(chat_id: number, text: string, options?): Promise<Message>;
+  get_user_state(chat_id: number): UserState;
+  set_user_data(chat_id: number, key: string, value: unknown): void;
+  get_user_data<T>(chat_id: number, key: string): T | undefined;
+  reset_user(chat_id: number): Promise<void>;
+  delete_message(chat_id: number, message_id: number): Promise<boolean>;
+  get_dialog(dialog_id: string): Dialog | undefined;
+  wait_for_text(chat_id: number, options?): Promise<WaitResult<string>>;
+  wait_for_file(chat_id: number, options?): Promise<FileWaitResult>;
+  stop(): Promise<void>;
+}
+```
+
+### Types
+
+See [types documentation](./docs/types.md) for complete type definitions.
+
+## 🔄 Migration from v1.x
+
+See [MIGRATION.md](./MIGRATION.md) for detailed migration guide.
+
+### Quick Changes
+
+| v1.x | v2.0 |
+|------|------|
+| `new BotBuilder(schema, token, options)` | `new BotBuilder(schema, { token, ...options })` |
+| `schema.start` | `schema.start_dialog` |
+| `schema.content` | `schema.dialogs` |
+| `dialog.buttons` | `dialog.inline_buttons` |
+| `ChangeDialog(id)` | `go_to(id)` |
+| `CallbackAction(desc)` | `emit(desc)` |
+| `WaitForData(desc)` | `wait_for_text(handler)` |
+| `_bot` | `telegram` |
+| `ActionSystem` | `events` |
+
+## 📄 License
+
+MIT © [zxcpadik](https://github.com/zxcpadik)

package/lib/actions/callback_action.d.ts

@@ -0,0 +1,14 @@
+import type { Action, CallbackFunction } from "../types/action.js";
+/**
+ * Create an action that emits an event
+ */
+export declare function emit(event_name: string, ...args: unknown[]): Action;
+/**
+ * Create an action that calls a function directly
+ */
+export declare function call(fn: CallbackFunction, ...args: unknown[]): Action;
+/**
+ * Create an action that calls a function with the full context
+ */
+export declare function call_with_context(fn: (context: import("../types/action.js").ActionContext) => void | Promise<void>): Action;
+//# sourceMappingURL=callback_action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback_action.d.ts","sourceRoot":"","sources":["../../src/actions/callback_action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAInE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAIrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,oBAAoB,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAI3H"}

package/lib/actions/callback_action.js

@@ -0,0 +1,25 @@
+/**
+ * Create an action that emits an event
+ */
+export function emit(event_name, ...args) {
+    return (context) => {
+        context.bot.events.emit(event_name, context.chat_id, ...args);
+    };
+}
+/**
+ * Create an action that calls a function directly
+ */
+export function call(fn, ...args) {
+    return async (context) => {
+        await fn(context.chat_id, ...args);
+    };
+}
+/**
+ * Create an action that calls a function with the full context
+ */
+export function call_with_context(fn) {
+    return async (context) => {
+        await fn(context);
+    };
+}
+//# sourceMappingURL=callback_action.js.map

package/lib/actions/callback_action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback_action.js","sourceRoot":"","sources":["../../src/actions/callback_action.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,UAAkB,EAAE,GAAG,IAAe;IACzD,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,EAAoB,EAAE,GAAG,IAAe;IAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAiF;IACjH,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/lib/actions/change_dialog.d.ts

@@ -0,0 +1,10 @@
+import type { Action } from "../types/action.js";
+/**
+ * Create an action that navigates to a specific dialog
+ */
+export declare function go_to(dialog_id: string): Action;
+/**
+ * Create an action that navigates back to start dialog
+ */
+export declare function go_to_start(): Action;
+//# sourceMappingURL=change_dialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"change_dialog.d.ts","sourceRoot":"","sources":["../../src/actions/change_dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAIpC"}

package/lib/actions/change_dialog.js

@@ -0,0 +1,17 @@
+/**
+ * Create an action that navigates to a specific dialog
+ */
+export function go_to(dialog_id) {
+    return async (context) => {
+        await context.bot.change_dialog(context.chat_id, dialog_id);
+    };
+}
+/**
+ * Create an action that navigates back to start dialog
+ */
+export function go_to_start() {
+    return async (context) => {
+        await context.bot.reset_user(context.chat_id);
+    };
+}
+//# sourceMappingURL=change_dialog.js.map

package/lib/actions/change_dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change_dialog.js","sourceRoot":"","sources":["../../src/actions/change_dialog.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,SAAiB;IACrC,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC"}

package/lib/actions/control_flow.d.ts

@@ -0,0 +1,26 @@
+import type { Action, ActionContext } from "../types/action.js";
+/**
+ * Execute multiple actions in sequence
+ */
+export declare function sequence(...actions: Action[]): Action;
+/**
+ * Execute action conditionally
+ */
+export declare function when(condition: (context: ActionContext) => boolean | Promise<boolean>, then_action: Action, else_action?: Action): Action;
+/**
+ * Execute action with delay
+ */
+export declare function delay(ms: number, action: Action): Action;
+/**
+ * Execute action only if user data matches
+ */
+export declare function when_data<T>(key: string, predicate: (value: T | undefined) => boolean, then_action: Action, else_action?: Action): Action;
+/**
+ * Set user data
+ */
+export declare function set_data(key: string, value: unknown | ((chat_id: number) => unknown)): Action;
+/**
+ * Delete user data
+ */
+export declare function delete_data(key: string): Action;
+//# sourceMappingURL=control_flow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control_flow.d.ts","sourceRoot":"","sources":["../../src/actions/control_flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAMrD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAClB,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACjE,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,EAC5C,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,MAAM,CAK7F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C"}

package/lib/actions/control_flow.js

@@ -0,0 +1,61 @@
+/**
+ * Execute multiple actions in sequence
+ */
+export function sequence(...actions) {
+    return async (context) => {
+        for (const action of actions) {
+            await action(context);
+        }
+    };
+}
+/**
+ * Execute action conditionally
+ */
+export function when(condition, then_action, else_action) {
+    return async (context) => {
+        const result = await condition(context);
+        if (result) {
+            await then_action(context);
+        }
+        else if (else_action) {
+            await else_action(context);
+        }
+    };
+}
+/**
+ * Execute action with delay
+ */
+export function delay(ms, action) {
+    return async (context) => {
+        await new Promise((resolve) => setTimeout(resolve, ms));
+        await action(context);
+    };
+}
+/**
+ * Execute action only if user data matches
+ */
+export function when_data(key, predicate, then_action, else_action) {
+    return when((context) => {
+        const value = context.bot.get_user_data(context.chat_id, key);
+        return predicate(value);
+    }, then_action, else_action);
+}
+/**
+ * Set user data
+ */
+export function set_data(key, value) {
+    return (context) => {
+        const resolved = typeof value === "function" ? value(context.chat_id) : value;
+        context.bot.set_user_data(context.chat_id, key, resolved);
+    };
+}
+/**
+ * Delete user data
+ */
+export function delete_data(key) {
+    return (context) => {
+        const state = context.bot.get_user_state(context.chat_id);
+        delete state.custom_data[key];
+    };
+}
+//# sourceMappingURL=control_flow.js.map

package/lib/actions/control_flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control_flow.js","sourceRoot":"","sources":["../../src/actions/control_flow.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAG,OAAiB;IAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAClB,SAAiE,EACjE,WAAmB,EACnB,WAAoB;IAEpB,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAExC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,WAAW,EAAE,CAAC;YACvB,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,MAAc;IAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACxD,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,SAA4C,EAC5C,WAAmB,EACnB,WAAoB;IAEpB,OAAO,IAAI,CACT,CAAC,OAAO,EAAE,EAAE;QACV,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAI,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACjE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,EACD,WAAW,EACX,WAAW,CACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,KAA+C;IACnF,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC"}

package/lib/actions/index.d.ts

@@ -0,0 +1,6 @@
+export { go_to, go_to_start } from "./change_dialog.js";
+export { emit, call, call_with_context } from "./callback_action.js";
+export { wait_for_text, wait_for_file, wait_for_photo } from "./wait_for_input.js";
+export { notify, notify_dynamic } from "./send_message.js";
+export { sequence, when, delay, when_data, set_data, delete_data, } from "./control_flow.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGnF,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,SAAS,EACT,QAAQ,EACR,WAAW,GACZ,MAAM,mBAAmB,CAAC"}

package/lib/actions/index.js

@@ -0,0 +1,11 @@
+// Navigation
+export { go_to, go_to_start } from "./change_dialog.js";
+// Callbacks
+export { emit, call, call_with_context } from "./callback_action.js";
+// Input waiting
+export { wait_for_text, wait_for_file, wait_for_photo } from "./wait_for_input.js";
+// Messaging
+export { notify, notify_dynamic } from "./send_message.js";
+// Control flow
+export { sequence, when, delay, when_data, set_data, delete_data, } from "./control_flow.js";
+//# sourceMappingURL=index.js.map

package/lib/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAExD,YAAY;AACZ,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAErE,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEnF,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE3D,eAAe;AACf,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,SAAS,EACT,QAAQ,EACR,WAAW,GACZ,MAAM,mBAAmB,CAAC"}

package/lib/actions/send_message.d.ts

@@ -0,0 +1,16 @@
+import type { Action } from "../types/action.js";
+/**
+ * Create an action that sends a standalone message
+ */
+export declare function notify(text: string, options?: {
+    parse_mode?: "HTML" | "Markdown" | "MarkdownV2";
+    auto_delete_ms?: number;
+}): Action;
+/**
+ * Create an action that sends a message with text resolved at runtime
+ */
+export declare function notify_dynamic(text_fn: (chat_id: number) => string | Promise<string>, options?: {
+    parse_mode?: "HTML" | "Markdown" | "MarkdownV2";
+    auto_delete_ms?: number;
+}): Action;
+//# sourceMappingURL=send_message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send_message.d.ts","sourceRoot":"","sources":["../../src/actions/send_message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EACtD,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,MAAM,CAaR"}

package/lib/actions/send_message.js

@@ -0,0 +1,32 @@
+/**
+ * Create an action that sends a standalone message
+ */
+export function notify(text, options) {
+    return async (context) => {
+        const msg = await context.bot.send_message(context.chat_id, text, {
+            parse_mode: options?.parse_mode,
+        });
+        if (options?.auto_delete_ms) {
+            setTimeout(async () => {
+                await context.bot.delete_message(context.chat_id, msg.message_id);
+            }, options.auto_delete_ms);
+        }
+    };
+}
+/**
+ * Create an action that sends a message with text resolved at runtime
+ */
+export function notify_dynamic(text_fn, options) {
+    return async (context) => {
+        const text = await text_fn(context.chat_id);
+        const msg = await context.bot.send_message(context.chat_id, text, {
+            parse_mode: options?.parse_mode,
+        });
+        if (options?.auto_delete_ms) {
+            setTimeout(async () => {
+                await context.bot.delete_message(context.chat_id, msg.message_id);
+            }, options.auto_delete_ms);
+        }
+    };
+}
+//# sourceMappingURL=send_message.js.map

package/lib/actions/send_message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send_message.js","sourceRoot":"","sources":["../../src/actions/send_message.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,MAAM,CACpB,IAAY,EACZ,OAGC;IAED,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE;YAChE,UAAU,EAAE,OAAO,EAAE,UAAU;SAChC,CAAC,CAAC;QAEH,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC5B,UAAU,CAAC,KAAK,IAAI,EAAE;gBACpB,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;YACpE,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAsD,EACtD,OAGC;IAED,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE;YAChE,UAAU,EAAE,OAAO,EAAE,UAAU;SAChC,CAAC,CAAC;QAEH,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC5B,UAAU,CAAC,KAAK,IAAI,EAAE;gBACpB,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;YACpE,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}