telemeister 0.1.21 → 0.2.8

package/dist/templates/templates/handler.ts.ejs

@@ -17,7 +17,23 @@ appBuilder
     // Called when user enters this state
     // Can optionally return a state name to immediately transition
 
-    await context.send("Hello from <%= stateName %> state!");
+    // Access Grammy context via context.ctx
+    // See Grammy docs: https://grammy.dev/guide/context
+    await context.ctx.reply("Hello from <%= stateName %> state!");
+
+    // === INLINE KEYBOARD EXAMPLE ===
+    // import { InlineKeyboard } from 'grammy';
+    // const keyboard = new InlineKeyboard()
+    //   .text('Button 1', 'btn1')
+    //   .text('Button 2', 'btn2');
+    // await context.ctx.reply('Choose:', { reply_markup: keyboard });
+
+    // === POLL EXAMPLE ===
+    // await context.ctx.replyWithPoll(
+    //   'Question?',
+    //   ['Option A', 'Option B', 'Option C'],
+    //   { is_anonymous: false }
+    // );
 
     // Database helpers (see src/lib/database.ts):
     // import { getUserByTelegramId, createOrUpdateUser } from '../../lib/database.js';
@@ -30,20 +46,66 @@ appBuilder
 <% } %>
   })
 <% if (transitionStates.length > 0) { %>
-  .onResponse(async (context: AppContext, response): <%= pascalCase(stateName) %>Transitions => {
+  .onResponse(async (context: AppContext): <%= pascalCase(stateName) %>Transitions => {
 <% } else { %>
-  .onResponse(async (context: AppContext, response) => {
+  .onResponse(async (context: AppContext) => {
 <% } %>
-    // Called when user sends a message in this state
+    // Called when user sends any update in this state (message, callback, poll, etc.)
     // Return a state name to transition, or nothing to stay
 
-    const text = response.trim();
+    // Handle different update types via Grammy context (context.ctx):
+    // - context.ctx.message?.text - text messages
+    // - context.ctx.callbackQuery?.data - inline button callbacks
+    // - context.ctx.message?.photo - photo messages
+    // - context.ctx.pollAnswer - poll responses
+    // See Grammy docs: https://grammy.dev/guide/context
+
+    // === INLINE KEYBOARD CALLBACK EXAMPLE ===
+    // if (context.ctx.callbackQuery?.data) {
+    //   await context.ctx.answerCallbackQuery();
+    //   const data = context.ctx.callbackQuery.data;
+    //   switch (data) {
+    //     case 'btn1':
+    //       await context.ctx.reply('You clicked Button 1!');
+    //       break;
+    //     case 'btn2':
+    //       return 'otherState'; // Transition to another state
+    //   }
+    //   return;
+    // }
+
+    // === POLL ANSWER EXAMPLE ===
+    // if (context.ctx.pollAnswer) {
+    //   const optionIds = context.ctx.pollAnswer.option_ids;
+    //   const options = ['Option A', 'Option B', 'Option C'];
+    //   const selected = optionIds.map(id => options[id]).join(', ');
+    //   await context.ctx.reply(`You voted for: ${selected}`);
+    //   return;
+    // }
+
+    // === COMMAND HANDLING EXAMPLE ===
+    // const text = context.ctx.message?.text?.trim();
+    // if (text?.startsWith('/')) {
+    //   const command = text.split(' ')[0].toLowerCase();
+    //   switch (command) {
+    //     case '/start':
+    //       await context.ctx.reply('Welcome!');
+    //       return 'welcome';
+    //     case '/menu':
+    //       return 'menu';
+    //     default:
+    //       await context.ctx.reply(`Unknown command: ${command}`);
+    //   }
+    //   return;
+    // }
+
+    const text = context.ctx.message?.text?.trim();
+    if (text) {
+      await context.ctx.reply(`You said: ${text}`);
+    }
 <% if (transitionStates.length > 0) { %>
     // Available transitions: <%= transitionStates.join(', ') %>
 <% } %>
-    // Handle user response
-    await context.send(`You said: ${text}`);
-
     // Database helpers (see src/lib/database.ts):
     // import { updateUserState } from '../../lib/database.js';
     // await updateUserState(String(context.telegramId), 'nextState', { lastMessage: text });

package/dist/templates/templates/package.json.ejs

@@ -4,11 +4,18 @@
   "type": "module",
   "scripts": {
     "dev": "tsx watch src/index.ts",
+    "dev:webhook": "BOT_MODE=webhook tsx watch src/index.ts",
     "build": "tsc",
     "start": "node dist/index.js",
+    "start:webhook": "BOT_MODE=webhook node dist/index.js",
     "db:generate": "prisma generate",
     "db:migrate": "prisma migrate dev",
+    "db:deploy": "prisma migrate deploy",
+    "db:push": "prisma db push",
     "db:studio": "prisma studio",
+    "webhook:set": "tsx scripts/set-webhook.ts",
+    "webhook:delete": "tsx scripts/delete-webhook.ts",
+    "webhook:info": "tsx scripts/webhook-info.ts",
     "state:add": "telemeister state:add",
     "state:delete": "telemeister state:delete",
     "state:sync": "telemeister state:sync",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telemeister",
-  "version": "0.1.21",
+  "version": "0.2.8",
   "description": "TypeScript Telegram Bot Boilerplate with XState",
   "type": "module",
   "main": "./dist/core/index.js",
@@ -33,40 +33,9 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsc && cp -r src/templates dist/templates",
-    "dev": "tsx src/index.ts",
-    "dev:watch": "tsx watch src/index.ts",
-    "dev:webhook": "BOT_MODE=webhook tsx src/index.ts",
-    "dev:webhook:watch": "BOT_MODE=webhook tsx watch src/index.ts",
-    "start": "node dist/index.js",
-    "start:webhook": "BOT_MODE=webhook node dist/index.js",
-    "db:generate": "prisma generate",
-    "db:migrate": "prisma migrate dev",
-    "db:deploy": "prisma migrate deploy",
-    "db:push": "prisma db push",
-    "db:studio": "prisma studio",
-    "webhook:set": "tsx scripts/set-webhook.ts",
-    "webhook:delete": "tsx scripts/delete-webhook.ts",
-    "webhook:info": "tsx scripts/webhook-info.ts",
-    "telemeister:state:add": "tsx src/cli/cli.ts state:add",
-    "telemeister:state:delete": "tsx src/cli/cli.ts state:delete",
-    "telemeister:state:sync": "tsx src/cli/cli.ts state:sync",
-    "telemeister:state:transition:add": "tsx src/cli/cli.ts state:transition:add",
-    "telemeister:state:transition:delete": "tsx src/cli/cli.ts state:transition:delete",
-    "telemeister:create-bot": "tsx src/cli/cli.ts create-bot",
-    "state:add": "telemeister state:add",
-    "state:delete": "telemeister state:delete",
-    "state:sync": "telemeister state:sync",
-    "state:transition:add": "telemeister state:transition:add",
-    "state:transition:delete": "telemeister state:transition:delete",
-    "prepublishOnly": "npm run build",
-    "prepare": "husky",
-    "lint": "eslint src/ scripts/",
-    "lint:fix": "eslint src/ scripts/ --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check ."
-  },
+  "workspaces": [
+    "examples/*"
+  ],
   "lint-staged": {
     "*.{ts,tsx}": [
       "eslint --fix",
@@ -87,8 +56,7 @@
   ],
   "author": "George Khromchenko",
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   },
   "license": "GPL-3.0-only",
   "dependencies": {
@@ -110,6 +78,7 @@
     "@types/ejs": "^3.1.5",
     "@types/express": "^5.0.0",
     "@types/node": "^25.0.6",
+    "esbuild": "^0.27.3",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "husky": "^9.1.7",
@@ -119,5 +88,15 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.39.0"
+  },
+  "scripts": {
+    "build": "tsc && cp -r src/templates dist/templates && pnpm run build:cli",
+    "build:cli": "esbuild dist/cli/cli.js --bundle --platform=node --format=esm --outfile=bin/telemeister-cli.js --external:typescript --external:tsx --external:prisma",
+    "example:recreate": "rm -rf examples/demo-bot && tsx src/cli/cli.ts create-bot demo-bot && mv demo-bot examples/demo-bot && npm pkg set --prefix examples/demo-bot dependencies.telemeister='workspace:*' && rm -rf examples/demo-bot/node_modules examples/demo-bot/pnpm-lock.yaml examples/demo-bot/dev.db examples/demo-bot/.env",
+    "lint": "eslint src/ scripts/",
+    "lint:fix": "eslint src/ scripts/ --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "release": "./scripts/release.sh"
   }
-}
+}

package/src/templates/README.md.ejs

@@ -143,9 +143,9 @@ export async function createOrder(
   const user = await prisma.user.findUnique({
     where: { telegramId },
   });
-  
+
   if (!user) throw new Error('User not found');
-  
+
   return await prisma.order.create({
     data: {
       userId: user.id,
@@ -163,11 +163,11 @@ export async function getUserOrderStats(telegramId: string) {
       orders: true,
     },
   });
-  
+
   if (!user) return { count: 0, total: 0 };
-  
+
   const total = user.orders.reduce((sum, order) => sum + order.amount, 0);
-  
+
   return {
     count: user.orders.length,
     total,
@@ -181,6 +181,7 @@ Use in handlers:
 
 ```typescript
 import { appBuilder, type AppContext } from 'telemeister/core';
+import type { Context } from 'grammy';
 import type { MenuTransitions } from '../../bot-state-types.js';
 import { getUserWithOrders, createOrder } from '../../lib/database.js';
 
@@ -188,17 +189,17 @@ appBuilder
   .forState('menu')
   .onEnter(async (context: AppContext): MenuTransitions => {
     const user = await getUserWithOrders(String(context.telegramId));
-    
+
     if (user?.orders.length) {
-      await context.send(`You have ${user.orders.length} orders!`);
+      await context.ctx.reply(`You have ${user.orders.length} orders!`);
     } else {
-      await context.send('Welcome! You have no orders yet.');
+      await context.ctx.reply('Welcome! You have no orders yet.');
     }
   })
-  .onResponse(async (context: AppContext, response): MenuTransitions => {
-    if (response === 'order') {
+  .onResponse(async (context: AppContext, ctx: Context): MenuTransitions => {
+    if (ctx.message?.text === 'order') {
       await createOrder(String(context.telegramId), 'Product A', 99.99);
-      await context.send('Order created!');
+      await ctx.reply('Order created!');
     }
   });
 

package/src/templates/handler.ts.ejs

@@ -17,7 +17,23 @@ appBuilder
     // Called when user enters this state
     // Can optionally return a state name to immediately transition
 
-    await context.send("Hello from <%= stateName %> state!");
+    // Access Grammy context via context.ctx
+    // See Grammy docs: https://grammy.dev/guide/context
+    await context.ctx.reply("Hello from <%= stateName %> state!");
+
+    // === INLINE KEYBOARD EXAMPLE ===
+    // import { InlineKeyboard } from 'grammy';
+    // const keyboard = new InlineKeyboard()
+    //   .text('Button 1', 'btn1')
+    //   .text('Button 2', 'btn2');
+    // await context.ctx.reply('Choose:', { reply_markup: keyboard });
+
+    // === POLL EXAMPLE ===
+    // await context.ctx.replyWithPoll(
+    //   'Question?',
+    //   ['Option A', 'Option B', 'Option C'],
+    //   { is_anonymous: false }
+    // );
 
     // Database helpers (see src/lib/database.ts):
     // import { getUserByTelegramId, createOrUpdateUser } from '../../lib/database.js';
@@ -30,20 +46,66 @@ appBuilder
 <% } %>
   })
 <% if (transitionStates.length > 0) { %>
-  .onResponse(async (context: AppContext, response): <%= pascalCase(stateName) %>Transitions => {
+  .onResponse(async (context: AppContext): <%= pascalCase(stateName) %>Transitions => {
 <% } else { %>
-  .onResponse(async (context: AppContext, response) => {
+  .onResponse(async (context: AppContext) => {
 <% } %>
-    // Called when user sends a message in this state
+    // Called when user sends any update in this state (message, callback, poll, etc.)
     // Return a state name to transition, or nothing to stay
 
-    const text = response.trim();
+    // Handle different update types via Grammy context (context.ctx):
+    // - context.ctx.message?.text - text messages
+    // - context.ctx.callbackQuery?.data - inline button callbacks
+    // - context.ctx.message?.photo - photo messages
+    // - context.ctx.pollAnswer - poll responses
+    // See Grammy docs: https://grammy.dev/guide/context
+
+    // === INLINE KEYBOARD CALLBACK EXAMPLE ===
+    // if (context.ctx.callbackQuery?.data) {
+    //   await context.ctx.answerCallbackQuery();
+    //   const data = context.ctx.callbackQuery.data;
+    //   switch (data) {
+    //     case 'btn1':
+    //       await context.ctx.reply('You clicked Button 1!');
+    //       break;
+    //     case 'btn2':
+    //       return 'otherState'; // Transition to another state
+    //   }
+    //   return;
+    // }
+
+    // === POLL ANSWER EXAMPLE ===
+    // if (context.ctx.pollAnswer) {
+    //   const optionIds = context.ctx.pollAnswer.option_ids;
+    //   const options = ['Option A', 'Option B', 'Option C'];
+    //   const selected = optionIds.map(id => options[id]).join(', ');
+    //   await context.ctx.reply(`You voted for: ${selected}`);
+    //   return;
+    // }
+
+    // === COMMAND HANDLING EXAMPLE ===
+    // const text = context.ctx.message?.text?.trim();
+    // if (text?.startsWith('/')) {
+    //   const command = text.split(' ')[0].toLowerCase();
+    //   switch (command) {
+    //     case '/start':
+    //       await context.ctx.reply('Welcome!');
+    //       return 'welcome';
+    //     case '/menu':
+    //       return 'menu';
+    //     default:
+    //       await context.ctx.reply(`Unknown command: ${command}`);
+    //   }
+    //   return;
+    // }
+
+    const text = context.ctx.message?.text?.trim();
+    if (text) {
+      await context.ctx.reply(`You said: ${text}`);
+    }
 <% if (transitionStates.length > 0) { %>
     // Available transitions: <%= transitionStates.join(', ') %>
 <% } %>
-    // Handle user response
-    await context.send(`You said: ${text}`);
-
     // Database helpers (see src/lib/database.ts):
     // import { updateUserState } from '../../lib/database.js';
     // await updateUserState(String(context.telegramId), 'nextState', { lastMessage: text });

package/src/templates/package.json.ejs

@@ -4,11 +4,18 @@
   "type": "module",
   "scripts": {
     "dev": "tsx watch src/index.ts",
+    "dev:webhook": "BOT_MODE=webhook tsx watch src/index.ts",
     "build": "tsc",
     "start": "node dist/index.js",
+    "start:webhook": "BOT_MODE=webhook node dist/index.js",
     "db:generate": "prisma generate",
     "db:migrate": "prisma migrate dev",
+    "db:deploy": "prisma migrate deploy",
+    "db:push": "prisma db push",
     "db:studio": "prisma studio",
+    "webhook:set": "tsx scripts/set-webhook.ts",
+    "webhook:delete": "tsx scripts/delete-webhook.ts",
+    "webhook:info": "tsx scripts/webhook-info.ts",
     "state:add": "telemeister state:add",
     "state:delete": "telemeister state:delete",
     "state:sync": "telemeister state:sync",