fix(app): made changes for deploying to vercel

.gitignore

@@ -135,4 +135,7 @@ data/
 
 # Ignore SQLite database
 *.db
-*.db-journal
+*.db-journal
+
+# Vercel project configuration
+.vercel

.vercelignore

@@ -0,0 +1 @@
+.env*

README.md

@@ -54,20 +54,56 @@ Follow these steps to set up and run your bot using this template:
     npm run dev
     ```
 
-   **Production Mode:**
+    **Production Mode:**
 
-    Install only production dependencies:
+    Install Vercel CLI:
     ```bash
-    npm install --only=prod
+    npm i -g vercel
     ```
 
-    Set `DEBUG` environment variable to `false` in your `.env` file.
+    Create a project:
+    ```bash
+    vercel link
+    ```
+    ### ---------- !! Do not use sensitive flag for variables !! ----------
+
+    Set `NODEJS_HELPERS` environment variable to `0`:
+    ```bash
+    vercel env add NODEJS_HELPERS
+    ```
+
+    Set `BOT_MODE` environment variable to `webhook`:
+    ```bash
+    vercel env add BOT_MODE
+    ```
 
-    Start the bot in production mode:
+    Set `BOT_TOKEN` environment variable:
+    ```bash
+    vercel env add BOT_TOKEN
+    ```
+
+    Set `BOT_WEBHOOK_SECRET` environment variable to a random secret token:
+    ```bash
+    # Generate and set secret token using Node
+    node -e "console.log(crypto.randomBytes(256*0.75).toString('base64url'))" | vercel env add BOT_WEBHOOK_SECRET
+    ```
+    ```bash
+    # OR using Python
+    python3 -c "import secrets; print(secrets.token_urlsafe(256))" | vercel env add BOT_WEBHOOK_SECRET
+    ```
     ```bash
-    npm run start:force # skip type checking and start
-    # or
-    npm start # with type checking (requires development dependencies)
+    # OR set manually:
+    vercel env add BOT_WEBHOOK_SECRET
+    ```
+
+    Deploy your bot:
+    ```bash
+    vercel
+    ```
+
+    After successful deployment, set up a webhook to connect your Vercel app with Telegram, modify the below URL to your credentials and visit it from your browser:
+    ```
+    https://APP_NAME.vercel.app/BOT_TOKEN
     ```
 
 ### List of Available Commands
@@ -302,16 +338,6 @@ bun add -d @types/bun
       Enables debug mode. You may use <code>config.isDebug</code> flag to enable debugging functions.
     </td>
   </tr>
-  <tr>
-    <td>BOT_WEBHOOK</td>
-    <td>
-        String
-    </td>
-    <td>
-        <i>Optional in <code>polling</code> mode.</i>
-        Webhook endpoint URL, used to configure webhook.
-    </td>
-  </tr>
   <tr>
     <td>BOT_WEBHOOK_SECRET</td>
     <td>

api/index.ts

@@ -0,0 +1,21 @@
+import { createBot } from '#root/bot/index.js';
+import { convertKeysToCamelCase, createConfig } from "#root/config.js";
+import { logger } from '#root/logger.js';
+import { createServer } from '#root/server/index.js';
+import { handle } from '@hono/node-server/vercel';
+import process from 'node:process';
+
+// @ts-expect-error create config from environment variables
+const config = createConfig(convertKeysToCamelCase(process.env))
+
+const bot = createBot(config.botToken, {
+  config,
+  logger,
+})
+const server = createServer({
+  bot,
+  config,
+  logger,
+})
+
+export default handle(server)

locales/en.ftl

@@ -3,6 +3,7 @@
 start-command-description = Start the bot
 language-command-description = Change language
 setcommands-command-description = Set bot commands
+ping-pong-command-description = Test bot work. Ping-Pong
 
 ## Welcome Feature
 

locales/uk.ftl

@@ -0,0 +1,22 @@
+## Commands
+
+start-command-description = Запустити бота
+language-command-description = Змінити мову
+setcommands-command-description = Встановити команди бота
+ping-pong-command-description = Тест бота. Ping-Pong
+## Welcome Feature
+
+welcome = Ласкаво просимо!
+
+## Language Feature
+
+language-select = Будь ласка, оберіть мову
+language-changed = Мову успішно змінено!
+
+## Admin Feature
+
+admin-commands-updated = Команди оновлено.
+
+## Unhandled Feature
+
+unhandled = Невідома команда. Спробуйте /start

package.json

@@ -32,6 +32,7 @@
     "@grammyjs/types": "3.11.1",
     "@hono/node-server": "1.12.0",
     "callback-data": "1.1.1",
+    "dotenv": "^16.4.7",
     "grammy": "1.27.0",
     "grammy-guard": "0.5.0",
     "hono": "4.5.2",

src/bot/features/ping.ts

@@ -0,0 +1,17 @@
+import type { Context } from '#root/bot/context.js'
+import { logHandle } from '#root/bot/helpers/logging.js'
+import { Composer } from 'grammy'
+
+const composer = new Composer<Context>()
+
+const feature = composer.chatType('private')
+
+feature.command('ping', logHandle('command-ping-pong'), (ctx) => {
+  return ctx.reply('pong')
+})
+
+feature.filter((ctx) => ctx.msg?.text?.toLocaleLowerCase() === 'ping').on('msg:text', logHandle('msg-ping-pong'), (ctx) => {
+  return ctx.reply('pong')
+})
+
+export { composer as PingFeature }

src/bot/features/welcome.ts

@@ -1,13 +1,15 @@
-import { Composer } from 'grammy'
 import type { Context } from '#root/bot/context.js'
 import { logHandle } from '#root/bot/helpers/logging.js'
+import { Composer, Keyboard } from 'grammy'
 
 const composer = new Composer<Context>()
 
 const feature = composer.chatType('private')
 
-feature.command('start', logHandle('command-start'), (ctx) => {
-  return ctx.reply(ctx.t('welcome'))
+feature.command('start', logHandle('command-start'), async (ctx) => {
+  return ctx.reply(ctx.t('welcome'), {
+    reply_markup: new Keyboard().text('ping').resized(),
+  })
 })
 
 export { composer as welcomeFeature }

src/bot/handlers/commands/command-definitions.ts

@@ -0,0 +1,34 @@
+import { i18n } from "#root/bot/i18n.js";
+
+export interface Command {
+  command: string;
+  description: (lang: string) => string;
+  isAdmin?: true;
+  scope?: "private" | "group" | "all";
+}
+
+export const commands: Command[] = [
+  {
+    command: "start",
+    description: (lang) => i18n.t(lang, "start-command-description"),
+    scope: "private",
+  },
+  {
+    command: "ping",
+    description: (lang) => i18n.t(lang, "ping-pong-command-description"),
+    scope: "private",
+  },
+  {
+    command: "setcommands",
+    description: (lang) => i18n.t(lang, "setcommands-command-description"),
+    isAdmin: true,
+    scope: "private",
+  },
+];
+
+export const languageCommand = {
+  command: "language",
+  description: (localeCode: string) => 
+    i18n.t(localeCode, "language-command-description"),
+  scope: "private",
+} as const;