grambot 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dortanes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+<table>
+<tr>
+<td>
+
+## Grambot
+
+[![NPM Version](https://img.shields.io/npm/v/grambot)](https://www.npmjs.com/package/grambot) [![License](https://img.shields.io/npm/l/grambot)](LICENSE)
+
+</td>
+</tr>
+</table>
+
+A declarative framework for building menu-driven Telegram bots. No boilerplate — just menus, buttons, and conversations.
+
+[Install](#-install) • [Quick Start](#-quick-start) • [Documentation](#-documentation) • [Releases](https://github.com/dortanes/grambot/releases)
+
+---
+
+## 📦 Install
+
+```bash
+npm install grambot grammy
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { Grambot } from "grambot";
+
+const greetAction = Grambot.action(async ({ conversation }) => {
+  const name = await conversation.ask("What is your name?");
+  await conversation.say(`Hello, ${name}!`);
+});
+
+const mainMenu = Grambot.menu((layout) => {
+  layout.text("Welcome! Choose an option:");
+  layout.button("👋 Say Hello").primary().action(greetAction);
+  layout.button("🌐 Website").url("https://github.com/dortanes/grambot");
+});
+
+const bot = Grambot.create({
+  token: process.env.BOT_TOKEN!,
+  menu: mainMenu,
+});
+
+bot.start();
+```
+
+## ✨ Features
+
+|     | Feature                 | Description                                              |
+| --- | ----------------------- | -------------------------------------------------------- |
+| 🏗️  | **Declarative Menus**   | Define layouts with a fluent builder API                 |
+| 🔄  | **Auto Navigation**     | Nested menus with built-in "Back" buttons                |
+| 💬  | **Conversations**       | Collect input with `ask()` and `form()`                  |
+| 📝  | **Single-Message Flow** | Edits one message for a clean chat history               |
+| 🎨  | **Button Styling**      | Colors (danger, success, primary) and custom emoji icons |
+| 🛡️  | **Error Handling**      | Built-in error boundary — no crashes                     |
+| 🌐  | **i18n Support**        | Localization hooks for all internal strings              |
+| 🔡  | **Type-Safe**           | Full TypeScript with JSDoc                               |
+
+## 🎨 Button Styling
+
+Color your buttons and add custom emoji icons (Bot API 9.4+):
+
+```typescript
+layout.button("Delete").danger(); // 🔴 Red
+layout.button("Confirm").success(); // 🟢 Green
+layout.button("Highlight").primary(); // 🔵 Blue
+
+layout.button("VIP").icon("custom_emoji_id");
+```
+
+## ⚙️ Configuration
+
+```typescript
+const bot = Grambot.create({
+  token: "BOT_TOKEN",
+  menu: mainMenu,
+
+  // Resolve user data from DB on every update
+  resolveUser: async (ctx) => {
+    return await db.users.find(ctx.from.id);
+  },
+
+  // Localize internal strings
+  translator: (key, ctx) => i18n.t(ctx.from.language_code, key),
+
+  // Custom error handler (default: console.error)
+  onError: (error, ctx) => {
+    logger.error("Bot error", { error, chatId: ctx.chat?.id });
+  },
+});
+```
+
+## 📖 Documentation
+
+| Guide                                            | Description                                 |
+| ------------------------------------------------ | ------------------------------------------- |
+| [Menus and Navigation](docs/menus.md)            | Layouts, rows, buttons, styling, pagination |
+| [Conversations and Forms](docs/conversations.md) | User input, validation, multi-step forms    |
+| [Actions and Triggers](docs/actions.md)          | Commands, regex, inline handlers            |
+| [State Management](docs/state.md)                | Sessions, storage adapters, user resolution |
+| [Advanced Patterns](docs/advanced.md)            | i18n, webhooks, manual rendering            |
+
+## Development
+
+```bash
+git clone https://github.com/dortanes/grambot.git
+cd grambot
+
+npm install
+
+npm run build
+
+BOT_TOKEN=your_token npm run start:example
+```
+
+## License
+
+[MIT](LICENSE)
+
+<p align="center" style="margin-top: 40px">
+  Made with ❤️ by <a href="https://github.com/dortanes">dortanes</a><br/>
+  (pls star this repo if you find it useful)
+</p>

package/dist/action/action.d.ts

@@ -0,0 +1,17 @@
+import type { ActionRef, ActionHandler } from "../types.js";
+/**
+ * Returns all actions created via createAction().
+ * @internal
+ */
+export declare function getGlobalActions(): ActionRef<any>[];
+/**
+ * Creates a typed action reference.
+ *
+ * Use `Grambot.action<PayloadType>(handler)` to define reusable handlers
+ * that can be attached to buttons.
+ *
+ * @param handler - The function that handles the action logic.
+ * @returns An {@link ActionRef} object.
+ */
+export declare function createAction<P = undefined>(handler: ActionHandler<P>): ActionRef<P>;
+//# sourceMappingURL=action.d.ts.map

package/dist/action/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/action/action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5D;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,SAAS,EACxC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,SAAS,CAAC,CAAC,CAAC,CAqCd"}

package/dist/action/action.js

@@ -0,0 +1,59 @@
+import { randomUUID } from "node:crypto";
+const globalActions = new Set();
+/**
+ * Returns all actions created via createAction().
+ * @internal
+ */
+export function getGlobalActions() {
+    return Array.from(globalActions);
+}
+/**
+ * Creates a typed action reference.
+ *
+ * Use `Grambot.action<PayloadType>(handler)` to define reusable handlers
+ * that can be attached to buttons.
+ *
+ * @param handler - The function that handles the action logic.
+ * @returns An {@link ActionRef} object.
+ */
+export function createAction(handler) {
+    const ref = {
+        __Grambot_action: true,
+        id: `a${randomUUID().slice(0, 6)}`,
+        handler,
+        triggers: {},
+        /**
+         * Set a command trigger for this action.
+         * @param name - The command name (e.g., "help").
+         */
+        command(name) {
+            if (!this.triggers)
+                this.triggers = {};
+            this.triggers.commands = [...(this.triggers.commands || []), name];
+            return this;
+        },
+        /**
+         * Set a word/phrase trigger for this action.
+         * @param text - The exact text to match.
+         */
+        word(text) {
+            if (!this.triggers)
+                this.triggers = {};
+            this.triggers.words = [...(this.triggers.words || []), text];
+            return this;
+        },
+        /**
+         * Set a regex trigger for this action.
+         * @param pattern - The regular expression to match.
+         */
+        regexp(pattern) {
+            if (!this.triggers)
+                this.triggers = {};
+            this.triggers.regexps = [...(this.triggers.regexps || []), pattern];
+            return this;
+        },
+    };
+    globalActions.add(ref);
+    return ref;
+}
+//# sourceMappingURL=action.js.map

package/dist/action/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/action/action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAyB;IAEzB,MAAM,GAAG,GAAiB;QACxB,gBAAgB,EAAE,IAAI;QACtB,EAAE,EAAE,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAClC,OAAO;QACP,QAAQ,EAAE,EAAE;QACZ;;;WAGG;QACH,OAAO,CAAC,IAAY;YAClB,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC;QACD;;;WAGG;QACH,IAAI,CAAC,IAAY;YACf,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QACD;;;WAGG;QACH,MAAM,CAAC,OAAe;YACpB,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;IAEF,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/conversation/conversation.d.ts

@@ -0,0 +1,15 @@
+import type { GrambotContext, GrambotConversation, ConversationHelper, Translator } from "../types.js";
+/**
+ * Creates a ConversationHelper bound to a Grammy Conversation instance.
+ *
+ * This is the runtime adapter providing `ask()` and `form()` helpers.
+ * It manages message editing, input validation, and cancellation.
+ *
+ * @param conversation - The grammy conversation instance.
+ * @param ctx - The initial Grambot context.
+ * @param translator - Optional function for localizing internal strings.
+ * @returns A {@link ConversationHelper} object.
+ * @internal
+ */
+export declare function createConversationHelper(conversation: GrambotConversation, ctx: GrambotContext, translator?: Translator, navigate?: (menu?: any) => Promise<void>): ConversationHelper;
+//# sourceMappingURL=conversation.d.ts.map

package/dist/conversation/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAOlB,UAAU,EAMX,MAAM,aAAa,CAAC;AAoFrB;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,mBAAmB,EACjC,GAAG,EAAE,cAAc,EACnB,UAAU,CAAC,EAAE,UAAU,EACvB,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GACvC,kBAAkB,CA+RpB"}

package/dist/conversation/conversation.js

@@ -0,0 +1,346 @@
+import { InlineKeyboard } from "grammy";
+// ─── Ask keyboard builder (for button-based ask) ──────────────────────────────
+/**
+ * Internal implementation of the button in an `ask` prompt.
+ * @internal
+ */
+class AskKeyboardButtonImpl {
+    text;
+    _id;
+    _url;
+    _action;
+    _menu;
+    _payload;
+    _forceRow = false;
+    constructor(text) {
+        this.text = text;
+    }
+    /** Set the button ID (stored in callback data) */
+    id(value) {
+        this._id = value;
+        return this;
+    }
+    url(value) {
+        this._url = value;
+        return this;
+    }
+    action(handler) {
+        this._action = handler;
+        return this;
+    }
+    menu(ref) {
+        this._menu = ref;
+        return this;
+    }
+    navigate(ref) {
+        this._menu = ref;
+        return this;
+    }
+    payload(data) {
+        this._payload = data;
+        return this;
+    }
+    row() {
+        this._forceRow = true;
+        return this;
+    }
+}
+/**
+ * Internal implementation of the keyboard builder in an `ask` prompt.
+ * @internal
+ */
+class AskKeyboardImpl {
+    buttons = [];
+    _maxPerRow;
+    /** Add a button to the prompt keyboard */
+    button(text) {
+        const btn = new AskKeyboardButtonImpl(text);
+        this.buttons.push(btn);
+        return btn;
+    }
+    /** Set maximum number of buttons per row */
+    maxPerRow(count) {
+        this._maxPerRow = count;
+    }
+}
+/** @internal */
+function isFunction(value) {
+    return typeof value === "function";
+}
+/**
+ * Creates a ConversationHelper bound to a Grammy Conversation instance.
+ *
+ * This is the runtime adapter providing `ask()` and `form()` helpers.
+ * It manages message editing, input validation, and cancellation.
+ *
+ * @param conversation - The grammy conversation instance.
+ * @param ctx - The initial Grambot context.
+ * @param translator - Optional function for localizing internal strings.
+ * @returns A {@link ConversationHelper} object.
+ * @internal
+ */
+export function createConversationHelper(conversation, ctx, translator, navigate) {
+    const tr = (key, defaultText, options) => translator ? translator(key, ctx, options) : defaultText;
+    // Track the last bot message ID to edit it
+    let lastMessageId = conversation.session?.__Grambot_last_msg_id ?? ctx.callbackQuery?.message?.message_id;
+    const chatId = ctx.chat?.id;
+    /**
+     * Helper to edit the previous prompt or send a new message.
+     * Manages the "single message" conversation flow.
+     */
+    async function editOrReply(text, keyboard, parseMode) {
+        if (lastMessageId && chatId) {
+            try {
+                await ctx.api.editMessageText(chatId, lastMessageId, text, { reply_markup: keyboard, parse_mode: parseMode });
+                return;
+            }
+            catch (e) {
+                // If message is not modified, we are fine
+                if (e.description?.includes("message is not modified")) {
+                    return;
+                }
+                // If edit fails (e.g., transition from photo to text), we try to delete and send new
+                try {
+                    await ctx.api.deleteMessage(chatId, lastMessageId);
+                }
+                catch { }
+            }
+        }
+        const msg = await ctx.reply(text, { reply_markup: keyboard, parse_mode: parseMode });
+        lastMessageId = msg.message_id;
+        const conv = conversation;
+        if (!conv.session)
+            conv.session = {};
+        conv.session.__Grambot_last_msg_id = lastMessageId;
+    }
+    /**
+     * Universal `ask` helper.
+     * - If a builder function is passed, displays a keyboard of choices.
+     * - Otherwise, waits for text/number/photo input.
+     */
+    async function ask(question, optionsOrBuilder, maybeBuilder) {
+        // Normalize arguments
+        let opts = {};
+        let builder;
+        if (isFunction(optionsOrBuilder)) {
+            builder = optionsOrBuilder;
+        }
+        else if (optionsOrBuilder) {
+            opts = optionsOrBuilder;
+            builder = maybeBuilder;
+        }
+        const translatedQuestion = tr(question, question, opts.replace);
+        // Branch 1: inline-keyboard selection
+        if (builder) {
+            const kb = new AskKeyboardImpl();
+            builder(kb);
+            const inlineKb = new InlineKeyboard();
+            let currentInRow = 0;
+            for (const btn of kb.buttons) {
+                if (btn._forceRow || (kb._maxPerRow && currentInRow >= kb._maxPerRow)) {
+                    inlineKb.row();
+                    currentInRow = 0;
+                }
+                const btnId = btn._id ?? btn.text;
+                const btnLabel = tr(btn.text, btn.text, opts.replace);
+                inlineKb.text(btnLabel, `ask:${btnId}`);
+                currentInRow++;
+            }
+            const cancelText = tr("Grambot.cancel", "🚫 Cancel");
+            inlineKb.row().text(cancelText, "ask:__cancel__");
+            await editOrReply(translatedQuestion, inlineKb, opts.parseMode);
+            const cbCtx = await conversation.waitForCallbackQuery(/^ask:/, {
+                otherwise: async (c) => {
+                    try {
+                        await c.deleteMessage();
+                    }
+                    catch { }
+                    await c.answerCallbackQuery(tr("Grambot.conversation.use_buttons", "Please use the buttons above."));
+                },
+            });
+            await cbCtx.answerCallbackQuery();
+            const data = cbCtx.callbackQuery.data.replace(/^ask:/, "");
+            if (data === "__cancel__") {
+                await navigateTo();
+                return undefined;
+            }
+            return data;
+        }
+        // Branch 2: text / number / photo input
+        const fieldType = opts.type ?? "text";
+        const cancelText = tr("Grambot.cancel", "🚫 Cancel");
+        const cancelKb = new InlineKeyboard().text(cancelText, "cancel_conversation");
+        let currentPrompt = translatedQuestion;
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        let isError = false;
+        // Loop until valid input
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            await editOrReply(currentPrompt, cancelKb, opts.parseMode);
+            if (fieldType === "photo") {
+                const updateCtx = await conversation.waitFor(["message:photo", "callback_query:data"]);
+                if (updateCtx.callbackQuery?.data === "cancel_conversation") {
+                    await updateCtx.answerCallbackQuery();
+                    await navigateTo();
+                    return undefined;
+                }
+                if (!updateCtx.message?.photo) {
+                    try {
+                        await updateCtx.deleteMessage();
+                    }
+                    catch { }
+                    const err = opts.errorMessage ? tr(opts.errorMessage, opts.errorMessage, opts.replace) : tr("Grambot.conversation.photo_error", "Please send a photo.");
+                    currentPrompt = `${err}\n\n${translatedQuestion}`;
+                    isError = true;
+                    continue;
+                }
+                try {
+                    await updateCtx.deleteMessage();
+                }
+                catch { }
+                const photos = updateCtx.message.photo;
+                if (photos && photos.length > 0) {
+                    const val = photos[photos.length - 1].file_id;
+                    if (opts.validate && !(await opts.validate(val))) {
+                        const err = opts.errorMessage ? tr(opts.errorMessage, opts.errorMessage, opts.replace) : tr("Grambot.conversation.invalid_error", "Invalid input. Try again.");
+                        currentPrompt = `${err}\n\n${translatedQuestion}`;
+                        isError = true;
+                        continue;
+                    }
+                    return val;
+                }
+            }
+            // text / number
+            const updateCtx = await conversation.waitFor(["message:text", "callback_query:data"]);
+            if (updateCtx.callbackQuery?.data === "cancel_conversation") {
+                await updateCtx.answerCallbackQuery();
+                await navigateTo();
+                return undefined;
+            }
+            if (!updateCtx.message?.text) {
+                try {
+                    await updateCtx.deleteMessage();
+                }
+                catch { }
+                const err = opts.errorMessage ? tr(opts.errorMessage, opts.errorMessage, opts.replace) : tr("Grambot.conversation.text_error", "Please send a text message.");
+                currentPrompt = `${err}\n\n${translatedQuestion}`;
+                isError = true;
+                continue;
+            }
+            try {
+                await updateCtx.deleteMessage();
+            }
+            catch { }
+            const raw = updateCtx.message.text;
+            if (fieldType === "number") {
+                const n = Number(raw);
+                if (Number.isNaN(n)) {
+                    const err = opts.errorMessage ? tr(opts.errorMessage, opts.errorMessage, opts.replace) : tr("Grambot.conversation.number_error", "Please send a valid number.");
+                    currentPrompt = `${err}\n\n${translatedQuestion}`;
+                    isError = true;
+                    continue;
+                }
+                if (opts.validate && !(await opts.validate(n))) {
+                    const err = opts.errorMessage ? tr(opts.errorMessage, opts.errorMessage, opts.replace) : tr("Grambot.conversation.invalid_error", "Invalid input. Try again.");
+                    currentPrompt = `${err}\n\n${translatedQuestion}`;
+                    isError = true;
+                    continue;
+                }
+                return n;
+            }
+            if (opts.validate && !(await opts.validate(raw))) {
+                const err = opts.errorMessage ? tr(opts.errorMessage, opts.errorMessage, opts.replace) : tr("Grambot.conversation.invalid_error", "Invalid input. Try again.");
+                currentPrompt = `${err}\n\n${translatedQuestion}`;
+                isError = true;
+                continue;
+            }
+            return raw;
+        }
+    }
+    /**
+     * Collected a multi-field form.
+     */
+    async function form(fields) {
+        const result = {};
+        for (const field of fields) {
+            const val = await ask(field.question, {
+                type: field.type,
+            });
+            if (val === undefined)
+                return undefined;
+            result[field.name] = val;
+        }
+        return result;
+    }
+    async function say(text, optionsOrBuilder, maybeBuilder) {
+        let opts = {};
+        let builder;
+        if (isFunction(optionsOrBuilder)) {
+            builder = optionsOrBuilder;
+        }
+        else if (optionsOrBuilder) {
+            opts = optionsOrBuilder;
+            builder = maybeBuilder;
+        }
+        const translated = tr(text, text, opts.replace);
+        let kb;
+        if (builder) {
+            const askKb = new AskKeyboardImpl();
+            builder(askKb);
+            kb = new InlineKeyboard();
+            let currentInRow = 0;
+            for (const btn of askKb.buttons) {
+                if (btn._forceRow || (askKb._maxPerRow && currentInRow >= askKb._maxPerRow)) {
+                    kb.row();
+                    currentInRow = 0;
+                }
+                const label = tr(btn.text, btn.text, opts.replace);
+                if (btn._url) {
+                    kb.url(label, btn._url);
+                }
+                else if (btn._menu) {
+                    kb.text(label, `n:${btn._menu.id}`);
+                }
+                else if (btn._action) {
+                    if (typeof btn._action === "function") {
+                        // In say(), inline functions don't have a stable way to be triggered 
+                        // because there's no loop. 
+                        kb.text(label, `ask_fn_say:${btn._id ?? btn.text}`);
+                    }
+                    else {
+                        const p = btn._payload;
+                        const pStr = p && Object.keys(p).length === 1 && "id" in p ? String(p.id) : (p ? JSON.stringify(p) : "");
+                        kb.text(label, `a:${btn._action.id}/:${pStr}`);
+                    }
+                }
+                else {
+                    kb.text(label, `ask:${btn._id ?? btn.text}`);
+                }
+                currentInRow++;
+            }
+        }
+        await editOrReply(translated, kb, opts.parseMode);
+    }
+    async function deletePrompt() {
+        if (lastMessageId && chatId) {
+            try {
+                await ctx.api.deleteMessage(chatId, lastMessageId);
+            }
+            catch (e) {
+                // ignore errors if already deleted
+            }
+            lastMessageId = undefined;
+            const conv = conversation;
+            if (conv.session) {
+                conv.session.__Grambot_last_msg_id = undefined;
+            }
+        }
+    }
+    async function navigateTo(menu) {
+        if (navigate) {
+            await navigate(menu);
+        }
+    }
+    return { ask, form, say, delete: deletePrompt, navigate: navigateTo };
+}
+//# sourceMappingURL=conversation.js.map

package/dist/conversation/conversation.js.map

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

package/dist/engine/engine.d.ts

@@ -0,0 +1,24 @@
+import { Bot } from "grammy";
+import type { GrambotContext, GrambotConfig, MenuRef, Translator } from "../types.js";
+/**
+ * Installs the Grambot engine onto a Grammy bot.
+ *
+ * - Registers session and conversation plugins.
+ * - Resolves and registers all menus and actions.
+ * - Sets up text and callback query handlers.
+ *
+ * @param bot - The grammy bot instance.
+ * @param rootRef - The root menu of the bot.
+ * @param config - Framework configuration.
+ */
+export declare function installMenu(bot: Bot<GrambotContext>, rootRef: MenuRef, config: GrambotConfig): Promise<void>;
+/**
+ * Sends a specific menu to a chat programmatically.
+ *
+ * @param bot - The grammy bot instance.
+ * @param chatId - Target chat ID.
+ * @param menuRef - The menu to send.
+ * @param ctx - Current Grambot context.
+ */
+export declare function sendMenu(bot: Bot<GrambotContext>, chatId: number, menuRef: MenuRef, ctx: GrambotContext, translator?: Translator): Promise<void>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAA2B,MAAM,QAAQ,CAAC;AAEtD,OAAO,KAAK,EAEV,cAAc,EAEd,aAAa,EACb,OAAO,EAMP,UAAU,EACX,MAAM,aAAa,CAAC;AAkVrB;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,EACxB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAgnBf;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,cAAc,EACnB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,IAAI,CAAC,CASf"}