neogram 9.3.1 → 9.3.2

package/README.md

@@ -2,12 +2,35 @@
 
 **Neogram** is a lightweight JavaScript module for working with the Telegram Bot API and AI. This is a port of the original Python library by SiriLV. It combines simple Telegram workflows with powerful features like text and image generation, translation, and more.
 
-## Installation
+## ✨ Features
+
+- **Full Telegram Bot API Coverage** - All 281+ Telegram API types and methods
+- **AI Integration** - Built-in support for OnlySQ, ChatGPT, and Deef AI services
+- **TypeScript Ready** - Complete type definitions for all Telegram objects
+- **ES Modules** - Native ES module support (modern JavaScript)
+- **Lightweight** - Minimal dependencies (axios, cheerio, form-data)
+- **Flexible** - Support for both polling and webhook modes
+- **File Uploads** - Easy handling of photos, documents, videos, and other media
+- **Error Handling** - Comprehensive error handling with Telegram API error codes
+- **Customizable** - Configurable API keys and endpoints for AI services
+
+## 📦 Installation
 
 ```bash
 npm install neogram
 ```
 
+### Getting a Bot Token
+
+1. Open Telegram and search for [@BotFather](https://t.me/botfather)
+2. Send `/newbot` and follow the instructions
+3. Copy the token provided by BotFather
+4. Set it as environment variable or use directly in your code:
+
+```bash
+export BOT_TOKEN="your_token_here"
+```
+
 ## Dependencies
 
 - `axios` (^1.7.7) - HTTP client for API requests
@@ -38,6 +61,51 @@ const me = await bot.getMe();
 console.log(`Bot username: @${me.username}`);
 ```
 
+## Quick Start
+
+Here's a complete example of a bot that responds to messages and uses AI:
+
+```javascript
+import { Bot, OnlySQ } from 'neogram';
+
+const bot = new Bot('YOUR_BOT_TOKEN');
+const ai = new OnlySQ(); // Uses default 'openai' key
+
+// Simple polling loop
+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?.text) {
+      const { chat, text } = update.message;
+      
+      // Echo with AI enhancement
+      if (text.startsWith('/ask ')) {
+        const question = text.substring(5);
+        const answer = await ai.generateAnswer('gpt-5.2-chat', [
+          { role: 'user', content: question }
+        ]);
+        
+        await bot.sendMessage({
+          chat_id: chat.id,
+          text: `🤖 AI says: ${answer}`
+        });
+      } else {
+        await bot.sendMessage({
+          chat_id: chat.id,
+          text: `You said: ${text}`
+        });
+      }
+    }
+  }
+}
+```
+
+For more examples, see the `examples/` directory.
+
 ## Core API Methods
 
 The `Bot` class provides comprehensive access to the Telegram Bot API. Here are the main categories of methods:
@@ -104,10 +172,7 @@ The `Bot` class provides comprehensive access to the Telegram Bot API. Here are
 
 ### Updates and Polling
 
-- `getUpdates(options)` - Get bot updates
-- `setWebhook(options)` - Set webhook
-- `deleteWebhook(options)` - Delete webhook
-- `getWebhookInfo()` - Get webhook info
+- `getUpdates(options)` - Get bot updates (polling mode)
 
 ### User and File Management
 
@@ -238,11 +303,15 @@ const translation = await chatgpt.generateTranslation(file, 'whisper-1');
 
 ### OnlySQ Class
 
-Provides access to OnlySQ AI services:
+Provides access to OnlySQ AI services with customizable API key support:
 
 ```javascript
+// Default constructor uses 'openai' key (backward compatible)
 const onlysq = new OnlySQ();
 
+// Or provide your own API key
+const onlysqWithKey = new OnlySQ({ apiKey: 'your-onlysq-api-key' });
+
 // Get available models
 const models = await onlysq.getModels({
   modality: 'text', // Filter by modality
@@ -263,6 +332,7 @@ await onlysq.generateImage('flux', 'A futuristic city', '16:9', 'output.png');
 ```
 
 **Methods:**
+- `constructor(options?)` - Create instance with optional `{ apiKey }` (defaults to 'openai')
 - `getModels(options)` - Get filtered list of available models
 - `generateAnswer(model, messages)` - Generate text responses
 - `generateImage(model, prompt, ratio, filename)` - Generate and save images
@@ -319,13 +389,77 @@ import {
 } from 'neogram';
 ```
 
+### TelegramObject Base Class
+
+All Telegram API types extend the `TelegramObject` base class, which provides:
+
+- **Automatic field mapping**: `from` ↔ `from_user`, `type` ↔ `type_val`, `filter` ↔ `filter_val`
+- **Serialization**: `toJSON()` method for converting to plain objects
+- **Deserialization**: Static `fromJSON(data)` method for creating instances
+- **Constructor**: Accepts plain objects and automatically maps properties
+
+Example:
+```javascript
+import { User } from 'neogram';
+
+// Create User instance from Telegram API response
+const userData = { id: 123, is_bot: false, first_name: 'John' };
+const user = new User(userData);
+
+// Convert back to plain object
+const json = user.toJSON();
+```
+
 ## Examples
 
-See the `examples/` directory for complete usage examples:
+See the `examples/` directory for complete, runnable examples:
+
+| File | Description | Key Features |
+|------|-------------|--------------|
+| `simple-bot.js` | Minimal bot with polling | `getUpdates`, `sendMessage`, error handling |
+| `test-bot.js` | Feature-rich test bot | Commands, photos, polls, dice, locations, keyboards |
+| `test-bot-full.js` | Complete bot with inline buttons | Callback query handling, answerCallbackQuery |
+| `test-bot-debug.js` | Debug and connectivity test | Error inspection, token validation |
+| `ai-bot.js` | AI-powered bot with OnlySQ | GPT-4o-mini integration, conversation history |
 
-- `simple-bot.js` - Basic bot setup
-- `test-bot.js` - Comprehensive bot testing
-- `ai-bot.js` - AI-integrated bot example
+Run any example:
+```bash
+BOT_TOKEN="your_token_here" node examples/simple-bot.js
+```
+
+### Webhook Example
+
+```javascript
+import { Bot } from 'neogram';
+import express from 'express';
+
+const bot = new Bot('YOUR_BOT_TOKEN');
+const app = express();
+
+app.use(express.json());
+
+// Set webhook (run once)
+await bot.setWebhook({
+  url: 'https://yourdomain.com/webhook',
+  secret_token: 'your_secret_token'
+});
+
+// Handle incoming updates
+app.post('/webhook', async (req, res) => {
+  const update = req.body;
+  
+  if (update.message?.text === '/start') {
+    await bot.sendMessage({
+      chat_id: update.message.chat.id,
+      text: 'Hello from webhook!'
+    });
+  }
+  
+  res.sendStatus(200);
+});
+
+app.listen(3000, () => console.log('Webhook server running on port 3000'));
+```
 
 ### Function Examples
 
@@ -713,7 +847,9 @@ src/
 
 ## Contributing
 
-Contributions are welcome! Please see the [GitHub repository](https://github.com/AndrewImm-OP/neogram) for issues and pull requests.
+Join our Telegram channel: https://t.me/neogram_js
+
+
 
 ## License
 
@@ -721,5 +857,5 @@ MIT License - see LICENSE file for details.
 
 ## Credits
 
-- Original Python library by [SiriLV](https://github.com/SiriLV)
-- JavaScript port by [AndrewImm-OP](https://github.com/AndrewImm-OP)
+- Original Python library by SiriLV
+- JavaScript port by AndrewImm-OP

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);
+});

package/package.json

@@ -8,15 +8,11 @@
   "contributors": [
     {
       "name": "AndrewImm-OP",
-      "email": "bessmertnyja89@gmail.com",
-      "url": "https://github.com/AndrewImm-OP"
+      "email": "bessmertnyja89@gmail.com"
     }
   ],
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/AndrewImm-OP/neogram.git"
-  },
+
   "keywords": [
     "telegram",
     "bot",
@@ -30,6 +26,7 @@
   "files": [
     "src",
     "types",
+    "examples",
     "README.md",
     "LICENSE"
   ],
@@ -48,9 +45,7 @@
     "cheerio": "^1.0.0",
     "form-data": "^4.0.0"
   },
-  "version": "9.3.1",
-  "bugs": {
-    "url": "https://github.com/AndrewImm-OP/neogram/issues"
-  },
-  "homepage": "https://github.com/AndrewImm-OP/neogram#readme"
+  "version": "9.3.2"
+
+
 }

package/src/ai/OnlySQ.js

@@ -2,6 +2,10 @@ import axios from 'axios';
 import fs from 'fs';
 
 export class OnlySQ {
+  constructor(options = {}) {
+    this.apiKey = options.apiKey || 'openai';
+  }
+
   async getModels({
     modality = null,
     can_tools = null,
@@ -70,7 +74,7 @@ export class OnlySQ {
       const { data } = await axios.post('https://api.onlysq.ru/ai/v2', payload, {
         timeout: 30000,
         headers: {
-          'Authorization': 'Bearer openai',
+          'Authorization': `Bearer ${this.apiKey}`,
           'Content-Type': 'application/json',
           'User-Agent': 'Mozilla/5.0 (compatible; OnlySQ/1.0)',
         },
@@ -103,7 +107,7 @@ export class OnlySQ {
         {
           timeout: 60000, // Image generation can take longer
           headers: {
-            'Authorization': 'Bearer openai',
+            'Authorization': `Bearer ${this.apiKey}`,
             'Content-Type': 'application/json',
             'User-Agent': 'Mozilla/5.0 (compatible; OnlySQ/1.0)',
           },

package/types/index.d.ts

@@ -764,6 +764,8 @@ export declare class Bot {
 
 // AI Classes
 export declare class OnlySQ {
+  constructor(options?: { apiKey?: string });
+
   getModels(options?: {
     modality?: string | string[];
     can_tools?: boolean;