feat: implement dynamic configuration, user rate limiting, and Gemini AI integration

Author: parthsali

.env.example

@@ -0,0 +1,22 @@
+# Server Configuration
+PORT=3001
+NODE_ENV=development
+
+# MongoDB
+MONGO_URI=mongodb://localhost:27017/learnverse-telegram-bot
+
+# Telegram Bot
+TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
+BOT_USERNAME=your_bot_username
+TELEGRAM_BOT_BASE_URL=http://localhost:3001
+
+# Learnverse API
+# The API base URL is used for:
+# - Fetching study materials
+# - Feature flags configuration (GET /api/v1/config/telegram)
+LEARNVERSE_BASE_URL=https://learnverse.example.com
+LEARNVERSE_API_BASE_URL=https://api.learnverse.example.com
+
+# Google Gemini AI (for query detection)
+# Get your API key from: https://makersuite.google.com/app/apikey
+GEMINI_API_KEY=your_gemini_api_key_here

package.json

@@ -16,11 +16,14 @@
     "nodemon": "^3.1.11"
   },
   "dependencies": {
+    "@google/generative-ai": "^0.21.0",
     "axios": "^1.13.2",
+    "bottleneck": "^2.19.5",
     "cors": "^2.8.5",
     "dotenv": "^17.2.3",
     "express": "^5.2.1",
     "mongoose": "^9.0.1",
+    "node-cache": "^5.1.2",
     "pino": "^10.1.0",
     "pino-pretty": "^13.1.3",
     "telegraf": "^4.16.3"

pnpm-lock.yaml

@@ -11,6 +11,7 @@ const LEARNVERSE_BASE_URL = process.env.LEARNVERSE_BASE_URL;
 const LEARNVERSE_API_BASE_URL = process.env.LEARNVERSE_API_BASE_URL;
 const NODE_ENV = process.env.NODE_ENV || "development";
 const TELEGRAM_BOT_BASE_URL = process.env.TELEGRAM_BOT_BASE_URL;
+const GEMINI_API_KEY = process.env.GEMINI_API_KEY;
 
 export {
   PORT,
@@ -21,4 +22,5 @@ export {
   LEARNVERSE_API_BASE_URL,
   NODE_ENV,
   TELEGRAM_BOT_BASE_URL,
+  GEMINI_API_KEY,
 };

src/config/config.js

@@ -7,18 +7,16 @@ export const startCommandHandler = async (ctx) => {
   console.log("User:", ctx.from.username || ctx.from.id);
 
   const welcomeMessage =
-    `🎓 *Welcome to Learnverse Bot!*\n\n` +
-    `I can help you access:\n` +
-    `• 📁 Files & Study Materials\n` +
-    `• 📚 Syllabuses & PDFs\n` +
-    `• 📝 Notes & Resources\n\n` +
-    `Use /search to find links to files, syllabuses & notes!\n` +
-    `Use /help to see all available commands.`;
+    `Meow! I'm Luna 🐱\n\n` +
+    `I help students find study materials - notes, PYQs, syllabuses, you name it.\n` +
+    `Everything's organized and ready for you.\n\n` +
+    `Try /search to get started, or /help if you need guidance.\n\n` +
+    `Happy studying!`;
 
   await ctx.reply(welcomeMessage, {
     parse_mode: "Markdown",
     ...Markup.inlineKeyboard([
-      [Markup.button.url("📢 Join Telegram Group", TELEGRAM_GROUP_LINK)],
+      [Markup.button.url("Join Study Group", TELEGRAM_GROUP_LINK)],
     ]),
   });
   console.log("Start command executed successfully");
@@ -29,18 +27,18 @@ export const helpCommandHandler = async (ctx) => {
   console.log("User:", ctx.from.username || ctx.from.id);
 
   const helpMessage =
-    `🤖 *Learnverse Bot Help*\n\n` +
-    `I am here to help you access study materials, notes, and syllabuses easily.\n\n` +
-    `*Available Commands:*\n` +
-    `/search - 🔍 Find file, syllabus & notes links\n` +
-    `/help - ℹ️ Show this help message\n` +
-    `/start - 🔄 Restart the bot session\n\n` +
-    `_Select /search to browse materials by Branch > Year > Subject_`;
+    `Luna here! 🐱\n\n` +
+    `I've organized all your study materials - just tell me what you need.\n\n` +
+    `*Commands:*\n` +
+    `/search - Browse materials by branch, year, and subject\n` +
+    `/help - Show this message\n` +
+    `/start - Start over\n\n` +
+    `Pro tip: Use /search and I'll guide you through everything step by step. `;
 
   await ctx.reply(helpMessage, {
     parse_mode: "Markdown",
     ...Markup.inlineKeyboard([
-      [Markup.button.url("📢 Join Telegram Group", TELEGRAM_GROUP_LINK)],
+      [Markup.button.url("Join Study Group", TELEGRAM_GROUP_LINK)],
     ]),
   });
   console.log("Help command executed successfully");