Gramora

TypeScript Telegram bot framework focused on practical APIs, strong typing, and production-safe runtime controls.

Installation

npm install @mra1k3r0/gramora@latest

Quick Start

import { Gramora } from "@mra1k3r0/gramora";

const bot = new Gramora({ token: process.env.TELEGRAM_BOT_TOKEN! });

bot.command("start", async (gram) => {
  await gram.send("Hello from Gramora");
});

bot.onText(async (gram) => {
  await gram.send(`Echo: ${gram.text ?? ""}`);
});

void bot.launch();

Why Gramora

• Clean API for common bots (command, onText, onCallback)
• Advanced mode with decorators, modules, and scenes
• Koa-style middleware pipeline (ctx, next)
• Polling and webhook transports with security defaults
• Runtime controls for debug, retries, timeout, webhook validation

Documentation

Full documentation lives in DOCS.md.

Development

npm install
npm run verify

Examples

• examples/echo_bot.ts
• examples/scene_bot.ts
• examples/config_bot.ts
• examples/callback_menu_bot.ts
• examples/media_advanced_bot.ts
• examples/middleware_auth_bot.ts
• examples/module_bot.ts
• examples/lazy_module_bot.ts
• examples/rich_text_bot.ts

Project Notes

Gramora is an evolving framework project inspired by Telegraf. It is not a drop-in replacement, and APIs may evolve with breaking changes.