neogram 9.3.0 → 9.3.2

package/examples/README.md

@@ -0,0 +1,47 @@
+# Примеры использования neogram-js
+
+## Запуск тестового бота
+
+1. Создай бота через [@BotFather](https://t.me/botfather)
+2. Получи токен
+3. Экспортируй токен:
+
+\`\`\`bash
+export BOT_TOKEN="your_bot_token_here"
+\`\`\`
+
+4. Запусти бота:
+
+\`\`\`bash
+node examples/test-bot.js
+\`\`\`
+
+## Простой эхо-бот
+
+\`\`\`bash
+export BOT_TOKEN="your_token"
+node examples/simple-bot.js
+\`\`\`
+
+## Доступные команды в test-bot
+
+- \`/start\` - Приветствие и список команд
+- \`/test\` - Тест основных функций
+- \`/photo\` - Отправка фото
+- \`/poll\` - Создание опроса
+- \`/dice\` - Бросить кубик
+- \`/location\` - Отправить локацию
+- \`/keyboard\` - Показать клавиатуру
+- \`/inline\` - Inline кнопки
+- \`/help\` - Помощь
+
+## Что тестируется
+
+- ✅ Long polling (getUpdates)
+- ✅ Отправка сообщений
+- ✅ Отправка медиа (фото)
+- ✅ Опросы
+- ✅ Действия (typing, dice)
+- ✅ Локации
+- ✅ Клавиатуры (reply & inline)
+- ✅ Обработка команд

package/examples/ai-bot.js

@@ -0,0 +1,155 @@
+import { Bot } from '../src/Bot.js';
+import axios from 'axios';
+
+const BOT_TOKEN = process.env.BOT_TOKEN;
+const ONLYSQ_API_KEY = process.env.ONLYSQ_API_KEY || 'openai';
+const ONLYSQ_API_URL = 'https://api.onlysq.ru/ai/openai/chat/completions';
+
+if (!BOT_TOKEN) {
+  console.error('❌ Установи BOT_TOKEN');
+  process.exit(1);
+}
+
+const bot = new Bot(BOT_TOKEN);
+const conversations = new Map();
+
+console.log('🤖 AI Бот запускается...');
+
+async function callOnlySQ(messages) {
+  try {
+    const response = await axios.post(ONLYSQ_API_URL, {
+      model: 'gpt-4o-mini',
+      messages: messages,
+      temperature: 0.7,
+      max_tokens: 1000
+    }, {
+      headers: {
+        'Authorization': `Bearer ${ONLYSQ_API_KEY}`,
+        'Content-Type': 'application/json'
+      },
+      proxy: false
+    });
+    
+    return response.data.choices[0].message.content;
+  } catch (error) {
+    console.error('❌ Ошибка OnlySQ:', error.message);
+    throw error;
+  }
+}
+
+async function start() {
+  try {
+    const me = await bot.getMe();
+    console.log('✅ Бот запущен:', '@' + me.username);
+    console.log('🧠 OnlySQ API: GPT-4o-mini');
+    console.log('🔄 Ожидаю сообщения...\n');
+    
+    let offset = 0;
+    
+    while (true) {
+      try {
+        const updates = await bot.getUpdates({ offset, timeout: 30 });
+        
+        for (const update of updates) {
+          offset = update.update_id + 1;
+          
+          if (update.message) {
+            await handleMessage(update.message);
+          }
+        }
+      } catch (error) {
+        console.error('❌ Ошибка получения обновлений:', error.message);
+        await new Promise(r => setTimeout(r, 3000));
+      }
+    }
+  } catch (error) {
+    console.error('❌ Ошибка запуска:', error.message);
+    process.exit(1);
+  }
+}
+
+async function handleMessage(message) {
+  const chatId = message.chat.id;
+  const text = message.text;
+  const username = message.from.username || message.from.first_name;
+  
+  if (!text) return;
+  
+  console.log(`📨 @${username}: ${text}`);
+  
+  if (text === '/start') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '👋 Привет! Я AI бот на базе OnlySQ!\n\n' +
+            '🧠 Модель: GPT-4o-mini\n' +
+            '📚 Построен на neogram-js\n\n' +
+            'Просто напиши мне что-нибудь!\n\n' +
+            '/clear - очистить историю\n' +
+            '/help - помощь'
+    });
+    return;
+  }
+  
+  if (text === '/clear') {
+    conversations.delete(chatId);
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '🗑️ История диалога очищена!'
+    });
+    return;
+  }
+  
+  if (text === '/help') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '📚 AI Бот на neogram-js\n\n' +
+            '🧠 Модель: GPT-4o-mini (OnlySQ)\n' +
+            '🔥 Framework: neogram-js\n' +
+            '💬 Long Polling\n\n' +
+            'Задавай любые вопросы!'
+    });
+    return;
+  }
+  
+  await bot.sendChatAction({ chat_id: chatId, action: 'typing' });
+  
+  try {
+    if (!conversations.has(chatId)) {
+      conversations.set(chatId, [
+        { role: 'system', content: 'Ты полезный AI ассистент. Отвечай кратко и по делу на русском языке.' }
+      ]);
+    }
+    
+    const history = conversations.get(chatId);
+    history.push({ role: 'user', content: text });
+    
+    // Ограничиваем историю (последние 10 пар сообщений)
+    if (history.length > 21) {
+      history.splice(1, 2);
+    }
+    
+    const aiResponse = await callOnlySQ(history);
+    history.push({ role: 'assistant', content: aiResponse });
+    
+    console.log(`🤖 AI: ${aiResponse.substring(0, 80)}${aiResponse.length > 80 ? '...' : ''}`);
+    
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: aiResponse
+    });
+    
+  } catch (error) {
+    console.error('❌ Ошибка AI:', error.message);
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '❌ Ошибка при обработке запроса. Попробуй позже или напиши /clear'
+    });
+  }
+}
+
+start().catch(console.error);
+
+process.on('SIGINT', () => {
+  console.log('\n👋 Бот остановлен');
+  process.exit(0);
+});

package/examples/simple-bot.js

@@ -0,0 +1,30 @@
+import { Bot } from '../src/Bot.js';
+
+const bot = new Bot(process.env.BOT_TOKEN);
+
+async function main() {
+  const me = await bot.getMe();
+  console.log('Бот запущен:', me.username);
+
+  let offset = 0;
+
+  while (true) {
+    const updates = await bot.getUpdates({ offset, timeout: 30 });
+
+    for (const update of updates) {
+      offset = update.update_id + 1;
+
+      if (update.message) {
+        const { chat, text } = update.message;
+        console.log('Получено:', text);
+
+        await bot.sendMessage({
+          chat_id: chat.id,
+          text: 'Ты написал: ' + text
+        });
+      }
+    }
+  }
+}
+
+main().catch(console.error);

package/examples/test-bot-debug.js

@@ -0,0 +1,26 @@
+import { Bot } from '../src/Bot.js';
+
+const TOKEN = process.env.BOT_TOKEN;
+const bot = new Bot(TOKEN);
+
+console.log('🤖 Тестирую бота...');
+console.log('🔑 Токен:', TOKEN.substring(0, 10) + '...');
+console.log('🌐 Base URL:', bot.http.defaults.baseURL);
+
+async function start() {
+  try {
+    console.log('📡 Отправляю getMe...');
+    const me = await bot.getMe();
+    console.log('✅ Успех!');
+    console.log('👤 @' + me.username);
+    console.log('🆔 ID:', me.id);
+    console.log('📝 Имя:', me.first_name);
+  } catch (error) {
+    console.error('❌ Ошибка:', error.message);
+    console.error('📊 Код:', error.code);
+    console.error('🔧 Config:', error.config?.url);
+    console.error('📄 Response:', error.response?.data);
+  }
+}
+
+start();

package/examples/test-bot-full.js

@@ -0,0 +1,221 @@
+import { Bot } from '../src/Bot.js';
+
+const TOKEN = process.env.BOT_TOKEN;
+if (!TOKEN) {
+  console.error('❌ Ошибка: установи переменную BOT_TOKEN');
+  process.exit(1);
+}
+
+const bot = new Bot(TOKEN);
+
+console.log('🤖 Бот запускается...');
+
+async function start() {
+  try {
+    const me = await bot.getMe();
+    console.log('✅ Бот успешно запущен!');
+    console.log('👤 Username:', '@' + me.username);
+    console.log('🆔 Bot ID:', me.id);
+    console.log('📝 Name:', me.first_name);
+    console.log('');
+    console.log('🔄 Ожидаю сообщения...');
+    
+    let offset = 0;
+    
+    while (true) {
+      try {
+        const updates = await bot.getUpdates({ 
+          offset, 
+          timeout: 30,
+          limit: 100 
+        });
+        
+        for (const update of updates) {
+          offset = update.update_id + 1;
+          
+          // Обрабатываем сообщения
+          if (update.message) {
+            await handleMessage(update.message);
+          }
+          
+          // Обрабатываем нажатия на inline кнопки
+          if (update.callback_query) {
+            await handleCallback(update.callback_query);
+          }
+        }
+      } catch (error) {
+        console.error('❌ Ошибка при получении обновлений:', error.message);
+        await new Promise(resolve => setTimeout(resolve, 3000));
+      }
+    }
+  } catch (error) {
+    console.error('❌ Ошибка при запуске:', error.message);
+    process.exit(1);
+  }
+}
+
+async function handleMessage(message) {
+  const chatId = message.chat.id;
+  const text = message.text;
+  const username = message.from.username || message.from.first_name;
+  
+  console.log('📨 Сообщение от @' + username + ':', text);
+  
+  if (text === '/start') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '👋 Привет! Я тестовый бот для neogram-js!\n\n' +
+            'Доступные команды:\n' +
+            '/test - Тест основных функций\n' +
+            '/photo - Отправить фото\n' +
+            '/poll - Создать опрос\n' +
+            '/dice - Бросить кубик\n' +
+            '/location - Отправить локацию\n' +
+            '/keyboard - Показать клавиатуру\n' +
+            '/inline - Inline кнопки\n' +
+            '/help - Помощь'
+    });
+  }
+  
+  else if (text === '/test') {
+    await bot.sendChatAction({ chat_id: chatId, action: 'typing' });
+    
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '✅ Тест основных функций:\n\n' +
+            '✓ sendMessage работает\n' +
+            '✓ getUpdates работает\n' +
+            '✓ sendChatAction работает\n\n' +
+            '🎉 Всё отлично!'
+    });
+  }
+  
+  else if (text === '/photo') {
+    await bot.sendPhoto({
+      chat_id: chatId,
+      photo: 'https://picsum.photos/800/600',
+      caption: '📸 Случайное фото с picsum.photos'
+    });
+  }
+  
+  else if (text === '/poll') {
+    await bot.sendPoll({
+      chat_id: chatId,
+      question: 'Как тебе neogram-js?',
+      pollOptions: ['🔥 Отлично!', '👍 Хорошо', '👌 Норм', '🤔 Так себе']
+    });
+  }
+  
+  else if (text === '/dice') {
+    await bot.sendDice({ chat_id: chatId, emoji: '🎲' });
+  }
+  
+  else if (text === '/location') {
+    await bot.sendLocation({
+      chat_id: chatId,
+      latitude: 55.7558,
+      longitude: 37.6173
+    });
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '📍 Красная площадь, Москва'
+    });
+  }
+  
+  else if (text === '/keyboard') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '⌨️ Клавиатура:',
+      reply_markup: {
+        keyboard: [
+          [{ text: '🔥 Кнопка 1' }, { text: '⚡ Кнопка 2' }],
+          [{ text: '💎 Кнопка 3' }],
+          [{ text: '❌ Убрать клавиатуру' }]
+        ],
+        resize_keyboard: true
+      }
+    });
+  }
+  
+  else if (text === '/inline') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '🔘 Inline кнопки (нажми на них!):',
+      reply_markup: {
+        inline_keyboard: [
+          [
+            { text: '✅ Кнопка 1', callback_data: 'btn1' },
+            { text: '❌ Кнопка 2', callback_data: 'btn2' }
+          ],
+          [
+            { text: '🔥 Кнопка 3', callback_data: 'btn3' }
+          ],
+          [
+            { text: '🌐 Google', url: 'https://google.com' }
+          ]
+        ]
+      }
+    });
+  }
+  
+  else if (text === '❌ Убрать клавиатуру') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '✅ Клавиатура убрана',
+      reply_markup: { remove_keyboard: true }
+    });
+  }
+  
+  else if (text === '/help') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '📚 Помощь:\n\n' +
+            'Этот бот тестирует функциональность neogram-js\n' +
+            'Используй /start чтобы увидеть все команды'
+    });
+  }
+  
+  else {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '🤔 Неизвестная команда. Используй /help'
+    });
+  }
+}
+
+// Обработка callback_query (нажатия на inline кнопки)
+async function handleCallback(callbackQuery) {
+  const chatId = callbackQuery.message.chat.id;
+  const messageId = callbackQuery.message.message_id;
+  const data = callbackQuery.data;
+  const username = callbackQuery.from.username || callbackQuery.from.first_name;
+  
+  console.log('🔘 Callback от @' + username + ':', data);
+  
+  // Отвечаем на callback (убирает "часики" у пользователя)
+  await bot.answerCallbackQuery({ callback_query_id: callbackQuery.id });
+  
+  if (data === 'btn1') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '✅ Ты нажал на Кнопку 1!'
+    });
+  } else if (data === 'btn2') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '❌ Ты нажал на Кнопку 2!'
+    });
+  } else if (data === 'btn3') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '🔥 Ты нажал на Кнопку 3!'
+    });
+  }
+}
+
+start().catch(console.error);
+
+process.on('SIGINT', () => {
+  console.log('\n👋 Бот остановлен');
+  process.exit(0);
+});

package/examples/test-bot.js

@@ -0,0 +1,196 @@
+import { Bot } from '../src/Bot.js';
+
+// Получаем токен из переменной окружения
+const TOKEN = process.env.BOT_TOKEN;
+
+if (!TOKEN) {
+  console.error('❌ Ошибка: установи переменную BOT_TOKEN');
+  console.error('Пример: export BOT_TOKEN="your_token_here"');
+  process.exit(1);
+}
+
+const bot = new Bot(TOKEN);
+
+console.log('🤖 Бот запускается...');
+
+// Получаем информацию о боте
+async function start() {
+  try {
+    const me = await bot.getMe();
+    console.log('✅ Бот успешно запущен!');
+    console.log('👤 Username:', '@' + me.username);
+    console.log('🆔 Bot ID:', me.id);
+    console.log('📝 Name:', me.first_name);
+    console.log('');
+    console.log('🔄 Ожидаю сообщения...');
+
+    let offset = 0;
+
+    // Polling loop
+    while (true) {
+      try {
+        const updates = await bot.getUpdates({ 
+          offset, 
+          timeout: 30,
+          limit: 100 
+        });
+
+        for (const update of updates) {
+          offset = update.update_id + 1;
+          await handleUpdate(update);
+        }
+      } catch (error) {
+        console.error('❌ Ошибка при получении обновлений:', error.message);
+        await new Promise(resolve => setTimeout(resolve, 3000));
+      }
+    }
+  } catch (error) {
+    console.error('❌ Ошибка при запуске:', error.message);
+    process.exit(1);
+  }
+}
+
+// Обработка обновлений
+async function handleUpdate(update) {
+  const message = update.message;
+  if (!message) return;
+
+  const chatId = message.chat.id;
+  const text = message.text;
+  const username = message.from.username || message.from.first_name;
+
+  console.log('📨 Сообщение от @' + username + ':', text);
+
+  // Команды
+  if (text === '/start') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '👋 Привет! Я тестовый бот для neogram-js!\n\n' +
+            'Доступные команды:\n' +
+            '/test - Тест основных функций\n' +
+            '/photo - Отправить фото\n' +
+            '/poll - Создать опрос\n' +
+            '/dice - Бросить кубик\n' +
+            '/location - Отправить локацию\n' +
+            '/keyboard - Показать клавиатуру\n' +
+            '/inline - Inline кнопки\n' +
+            '/help - Помощь'
+    });
+  }
+
+  else if (text === '/test') {
+    await bot.sendChatAction({ chat_id: chatId, action: 'typing' });
+
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '✅ Тест основных функций:\n\n' +
+            '✓ sendMessage работает\n' +
+            '✓ getUpdates работает\n' +
+            '✓ sendChatAction работает\n\n' +
+            '🎉 Всё отлично!'
+    });
+  }
+
+  else if (text === '/photo') {
+    await bot.sendPhoto({
+      chat_id: chatId,
+      photo: 'https://picsum.photos/800/600',
+      caption: '📸 Случайное фото с picsum.photos'
+    });
+  }
+
+  else if (text === '/poll') {
+    await bot.sendPoll({
+      chat_id: chatId,
+      question: 'Как тебе neogram-js?',
+      pollOptions: ['🔥 Отлично!', '👍 Хорошо', '👌 Норм', '🤔 Так себе']
+    });
+  }
+
+  else if (text === '/dice') {
+    await bot.sendDice({ chat_id: chatId, emoji: '🎲' });
+  }
+
+  else if (text === '/location') {
+    await bot.sendLocation({
+      chat_id: chatId,
+      latitude: 55.7558,
+      longitude: 37.6173
+    });
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '📍 Красная площадь, Москва'
+    });
+  }
+
+  else if (text === '/keyboard') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '⌨️ Клавиатура:',
+      reply_markup: {
+        keyboard: [
+          [{ text: '🔥 Кнопка 1' }, { text: '⚡ Кнопка 2' }],
+          [{ text: '💎 Кнопка 3' }],
+          [{ text: '❌ Убрать клавиатуру' }]
+        ],
+        resize_keyboard: true
+      }
+    });
+  }
+
+  else if (text === '/inline') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '🔘 Inline кнопки:',
+      reply_markup: {
+        inline_keyboard: [
+          [
+            { text: '✅ Кнопка 1', callback_data: 'btn1' },
+            { text: '❌ Кнопка 2', callback_data: 'btn2' }
+          ],
+          [
+            { text: '🌐 Google', url: 'https://google.com' }
+          ]
+        ]
+      }
+    });
+  }
+
+  else if (text === '❌ Убрать клавиатуру') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '✅ Клавиатура убрана',
+      reply_markup: { remove_keyboard: true }
+    });
+  }
+
+  else if (text === '/help') {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '📚 Помощь:\n\n' +
+            'Этот бот тестирует функциональность neogram-js\n' +
+            'Используй /start чтобы увидеть все команды'
+    });
+  }
+
+  else {
+    await bot.sendMessage({
+      chat_id: chatId,
+      text: '🤔 Неизвестная команда. Используй /help'
+    });
+  }
+}
+
+// Обработка callback запросов (inline кнопки)
+bot.on = (event, handler) => {
+  // TODO: implement event system
+};
+
+// Запуск
+start().catch(console.error);
+
+// Graceful shutdown
+process.on('SIGINT', () => {
+  console.log('\n👋 Бот остановлен');
+  process.exit(0);
+});