# Telegram UserBot

Модульный Telegram UserBot на JavaScript с поддержкой динамической загрузки команд.

## Установка

1. Получите API ключи на https://my.telegram.org
2. Установите зависимости:
\`\`\`bash
npm install
\`\`\`
3. Замените в `telegram-userbot.js`:
   - `YOUR_API_ID` на ваш API ID
   - `YOUR_API_HASH` на ваш API Hash
   - `YOUR_PHONE_NUMBER` на ваш номер телефона

## Запуск

\`\`\`bash
node telegram-userbot.js
\`\`\`

## Встроенные команды

- `!help` - Список всех команд
- `!info` - Информация о системе и аптайме
- `!ping` - Пинг до DC2 Telegram
- `!calc <выражение>` - Калькулятор
- `!time` - Текущее время
- `!docs` - Документация
- `.lm <имя_модуля>` - Загрузить новый модуль

## Создание модулей

### Структура модуля

Создайте файл в папке `modules/` с расширением `.js`:

\`\`\`javascript
export default {
    name: 'имя_команды',
    description: 'Описание команды',
    usage: '!команда [параметры]',
    async execute(client, message, args) {
        // Ваш код здесь
        await client.sendMessage(message.chatId, {
            message: 'Ответ команды'
        });
    }
};
\`\`\`

### Параметры функции execute

- `client` - Экземпляр GramJS клиента
- `message` - Объект сообщения с полями:
  - `chatId` - ID чата
  - `text` - Текст сообщения
  - `senderId` - ID отправителя
- `args` - Массив аргументов команды (без самой команды)

### Пример простого модуля

\`\`\`javascript
export default {
    name: 'hello',
    description: 'Приветствие пользователя',
    usage: '!hello [имя]',
    async execute(client, message, args) {
        const name = args.length > 0 ? args.join(' ') : 'Мир';
        await client.sendMessage(message.chatId, {
            message: `Привет, ${name}!`
        });
    }
};
\`\`\`

### Пример модуля с API запросом

\`\`\`javascript
export default {
    name: 'weather',
    description: 'Получить погоду',
    usage: '!weather <город>',
    async execute(client, message, args) {
        if (args.length === 0) {
            await client.sendMessage(message.chatId, {
                message: 'Укажите название города'
            });
            return;
        }
        
        try {
            const city = args.join(' ');
            const response = await fetch(`https://api.openweathermap.org/data/2.5/weather?q=${city}&appid=YOUR_API_KEY&units=metric&lang=ru`);
            const data = await response.json();
            
            if (data.cod === 200) {
                const weather = `🌤 Погода в ${data.name}:\n` +
                              `🌡 Температура: ${data.main.temp}°C\n` +
                              `💨 Ветер: ${data.wind.speed} м/с\n` +
                              `💧 Влажность: ${data.main.humidity}%`;
                
                await client.sendMessage(message.chatId, {
                    message: weather
                });
            } else {
                await client.sendMessage(message.chatId, {
                    message: 'Город не найден'
                });
            }
        } catch (error) {
            await client.sendMessage(message.chatId, {
                message: 'Ошибка получения данных о погоде'
            });
        }
    }
};
\`\`\`

### Загрузка модулей

1. **Автоматическая загрузка**: Поместите файл в папку `modules/` и перезапустите бота
2. **Динамическая загрузка**: Используйте команду `.lm имя_модуля` для загрузки без перезапуска

### Рекомендации

- Используйте async/await для асинхронных операций
- Обрабатывайте ошибки с помощью try/catch
- Проверяйте наличие аргументов перед их использованием
- Используйте описательные имена команд
- Добавляйте проверки входных данных
- Не забывайте про обработку edge cases

### Отладка

Для отладки используйте `console.log()` в коде модуля. Логи будут отображаться в консоли бота.

### Безопасность

- Не используйте `eval()` или подобные функции
- Валидируйте пользовательский ввод
- Не храните чувствительные данные в коде
- Используйте переменные окружения для API ключей