Advanced Local Session

Это удобная библиотека для локального хранения сессий и глобальных настроек в боте

📌 Особенности:

• Хранение сессий локально в JSON-файле
• Простое управление глобальными настройками
• Поддержка кэширования данных для ускорения доступа
• Интеграция методов в ctx для удобного использования

  🚀 Установка

  npm install advanced-local-session

  📌 Пример работы

  ` import { Telegraf } from'telegraf'; import { AdvancedLocalSession } from 'advanced-local-session';

const bot = new Telegraf('YOUR_BOT_TOKEN'); const session = new AdvancedLocalSession({ storagePath: './sessions.json', // Путь к файлу для хранения global: { dev_mode: false, admins: [123456789] // ID администраторов }, });

bot.use(session.middleware());

// Пример использования bot.command('ping', (ctx) => { ctx.reply('🏓 Pong!'); ctx.session.counter = (ctx.session.counter || 0) + 1; console.log(Количество запросов: ${ctx.session.counter}); });

bot.launch();

## 📂 Формат sessions.json
После первого запуска в корне проекта появится файл sessions.json:

{ "users": { "123456789": { "counter": 5 } }, "global": { "dev_mode": false, "admins": [123456789] } }

## 🔹 Методы класса AdvancedLocalSession
| Метод | Описание | Пример использования |
|----------------|:---------:|----------------:|
| middleware() | Подключает middleware в Telegraf | bot.use(session.middleware()); |
| getAllUsers() | Возвращает список всех пользователей | const users = session.getAllUsers(); |
| getUserById(id) | Получает данные пользователя по ID | const user = session.getUserById(123456789); |
| removeUser(id) | Удаляет данные пользователя | session.removeUser(123456789); |
| getGlobal(key) | Получает значение из глобальных настроек | const mode = session.getGlobal('dev_mode'); |
| setGlobal(key, v) | Устанавливает значение в глобальные настройки | session.setGlobal('dev_mode', true); |
## 🔹 Методы из контекста (ctx)
Благодаря middleware, в ctx автоматически добавляются удобные методы:
### ➡️ ctx.getGlobal(key)
Получает значение из глобальных настроек.

bot.command('checkmode', (ctx) => { const mode = ctx.getGlobal('dev_mode'); ctx.reply(🛠 Dev Mode: ${mode ? 'Включен' : 'Выключен'}); });

### ➡️ ctx.setGlobal(key, value)
Устанавливает значение в глобальных настройках.

bot.command('togglemode', (ctx) => { const currentMode = ctx.getGlobal('dev_mode'); ctx.setGlobal('dev_mode', !currentMode); ctx.reply(🔄 Dev Mode переключён на: ${!currentMode}); });

### ➡️ ctx.session
Работа с сессией пользователя через ctx.session.

bot.on('text', (ctx) => { ctx.session.messageCount = (ctx.session.messageCount || 0) + 1; ctx.reply(💬 Вы отправили ${ctx.session.messageCount} сообщений.); }); `