@verse-bot/tg-core 0.1.0

package/dist/bot-factory.d.ts

@@ -0,0 +1,8 @@
+import { Bot } from 'grammy';
+import type { BotContext } from './types';
+export interface BotFactoryOptions {
+    token: string;
+    useLogger?: boolean;
+    useSession?: boolean;
+}
+export declare function createBot(options: BotFactoryOptions): Bot<BotContext>;

package/dist/bot-factory.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBot = createBot;
+const grammy_1 = require("grammy");
+const middleware_1 = require("./middleware");
+function createBot(options) {
+    const { token, useLogger = true, useSession = false } = options;
+    const bot = new grammy_1.Bot(token);
+    bot.catch(middleware_1.errorHandler);
+    if (useSession) {
+        bot.use((0, grammy_1.session)({
+            initial: () => ({}),
+        }));
+    }
+    if (useLogger) {
+        bot.use(middleware_1.loggerMiddleware);
+    }
+    return bot;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './utils';
+export * from './middleware';
+export * from './keyboards';
+export * from './bot-factory.js';
+export * from './universal-bot.js';

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./middleware"), exports);
+__exportStar(require("./keyboards"), exports);
+__exportStar(require("./bot-factory.js"), exports);
+__exportStar(require("./universal-bot.js"), exports);

package/dist/keyboards/index.d.ts

@@ -0,0 +1,3 @@
+export * from './inline.js';
+export * from './reply.js';
+export * from './reply-universal.js';

package/dist/keyboards/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./inline.js"), exports);
+__exportStar(require("./reply.js"), exports);
+__exportStar(require("./reply-universal.js"), exports);

package/dist/keyboards/inline.d.ts

@@ -0,0 +1,7 @@
+import { InlineKeyboard } from 'grammy';
+export interface InlineButton {
+    text: string;
+    data?: string;
+    url?: string;
+}
+export declare function createInlineKeyboard(rows: InlineButton[][]): InlineKeyboard;

package/dist/keyboards/inline.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInlineKeyboard = createInlineKeyboard;
+const grammy_1 = require("grammy");
+function createInlineKeyboard(rows) {
+    const keyboard = new grammy_1.InlineKeyboard();
+    for (const row of rows) {
+        for (const btn of row) {
+            if (btn.url) {
+                keyboard.url(btn.text, btn.url);
+            }
+            else if (btn.data) {
+                keyboard.text(btn.text, btn.data);
+            }
+        }
+        keyboard.row();
+    }
+    return keyboard;
+}

package/dist/keyboards/reply-universal.d.ts

@@ -0,0 +1,3 @@
+import { Keyboard } from 'grammy';
+import type { UniversalKeyboardButton } from '@verse-bot/shared';
+export declare function createTelegramKeyboard(universalKeyboard: UniversalKeyboardButton[][], resize?: boolean, oneTime?: boolean): Keyboard;

package/dist/keyboards/reply-universal.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTelegramKeyboard = createTelegramKeyboard;
+const grammy_1 = require("grammy");
+function createTelegramKeyboard(universalKeyboard, resize = true, oneTime = false) {
+    const keyboard = new grammy_1.Keyboard();
+    for (const row of universalKeyboard) {
+        for (const btn of row) {
+            keyboard.text(btn.label);
+        }
+        keyboard.row();
+    }
+    if (resize)
+        keyboard.resized();
+    if (oneTime)
+        keyboard.oneTime();
+    return keyboard;
+}

package/dist/keyboards/reply.d.ts

@@ -0,0 +1,10 @@
+import { Keyboard } from 'grammy';
+export interface ReplyButton {
+    text: string;
+    requestContact?: boolean;
+    requestLocation?: boolean;
+}
+export declare function createReplyKeyboard(rows: ReplyButton[][], options?: {
+    resize?: boolean;
+    oneTime?: boolean;
+}): Keyboard;

package/dist/keyboards/reply.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReplyKeyboard = createReplyKeyboard;
+const grammy_1 = require("grammy");
+function createReplyKeyboard(rows, options) {
+    const keyboard = new grammy_1.Keyboard();
+    for (const row of rows) {
+        for (const btn of row) {
+            if (btn.requestContact) {
+                keyboard.requestContact(btn.text);
+            }
+            else if (btn.requestLocation) {
+                keyboard.requestLocation(btn.text);
+            }
+            else {
+                keyboard.text(btn.text);
+            }
+        }
+        keyboard.row();
+    }
+    if (options?.resize)
+        keyboard.resized();
+    if (options?.oneTime)
+        keyboard.oneTime();
+    return keyboard;
+}

package/dist/middleware/db.d.ts

@@ -0,0 +1,3 @@
+import type { MiddlewareFn } from 'grammy';
+import type { BotContext } from '../types';
+export declare const dbMiddleware: MiddlewareFn<BotContext>;

package/dist/middleware/db.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dbMiddleware = void 0;
+const shared_1 = require("@verse-bot/shared");
+const dbMiddleware = async (ctx, next) => {
+    ctx.db = (0, shared_1.getPool)();
+    await next();
+};
+exports.dbMiddleware = dbMiddleware;

package/dist/middleware/error-handler.d.ts

@@ -0,0 +1,3 @@
+import type { ErrorHandler } from 'grammy';
+import type { BotContext } from '../types';
+export declare const errorHandler: ErrorHandler<BotContext>;

package/dist/middleware/error-handler.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorHandler = void 0;
+const errorHandler = (err) => {
+    const ctx = err.ctx;
+    console.error(`[Error] Update ${ctx.update.update_id}:`);
+    console.error(err.error);
+};
+exports.errorHandler = errorHandler;

package/dist/middleware/index.d.ts

@@ -0,0 +1,3 @@
+export * from './db.js';
+export * from './logger.js';
+export * from './error-handler.js';

package/dist/middleware/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./db.js"), exports);
+__exportStar(require("./logger.js"), exports);
+__exportStar(require("./error-handler.js"), exports);

package/dist/middleware/logger.d.ts

@@ -0,0 +1,3 @@
+import type { MiddlewareFn } from 'grammy';
+import type { BotContext } from '../types';
+export declare const loggerMiddleware: MiddlewareFn<BotContext>;

package/dist/middleware/logger.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loggerMiddleware = void 0;
+const loggerMiddleware = async (ctx, next) => {
+    const start = Date.now();
+    const from = ctx.from?.username ?? ctx.from?.id ?? 'unknown';
+    const text = ctx.message?.text ?? ctx.callbackQuery?.data ?? '—';
+    console.log(`[${new Date().toISOString()}] @${from}: ${text}`);
+    await next();
+    console.log(`[${new Date().toISOString()}] Handled in ${Date.now() - start}ms`);
+};
+exports.loggerMiddleware = loggerMiddleware;

package/dist/types/bot.d.ts

@@ -0,0 +1,7 @@
+import type { Context as GrammyContext, SessionFlavor } from 'grammy';
+import type { Pool } from 'pg';
+export interface SessionData {
+}
+export interface BotContext extends GrammyContext, SessionFlavor<SessionData> {
+    db: Pool;
+}

package/dist/types/bot.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1 @@
+export * from './bot.js';

package/dist/types/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./bot.js"), exports);

package/dist/universal-bot.d.ts

@@ -0,0 +1,24 @@
+import { Bot } from 'grammy';
+import { type UniversalContext } from '@verse-bot/shared';
+import type { BotContext } from './types';
+export interface TelegramBotConfig {
+    token: string;
+    adminId?: number;
+    /** Обработчики статических команд (без параметров). Ключ – имя команды (без слеша). */
+    commands: Record<string, (ctx: UniversalContext) => Promise<void>>;
+    /** Определения кнопок (берутся из phrases). Массив объектов с command и button. */
+    buttons: {
+        command: string;
+        label: string;
+    }[];
+    /** Опционально: обработчик команды /content_<N> */
+    contentCommand?: (ctx: UniversalContext, itemNumber: number) => Promise<void>;
+    /** Опционально: обработчик команды /userlog_<N> */
+    userLogCommand?: (ctx: UniversalContext, userId: number) => Promise<void>;
+    /** Опциональный кастомный обработчик отправки фото (используется в replyWithPhoto контекста).
+     *  Если не задан, используется ctx.replyWithPhoto из GrammY. */
+    onReplyWithPhoto?: (photoUrl: string, caption?: string) => Promise<void>;
+    /** Путь к папке с контентом (для резервного поиска изображений). */
+    contentDir?: string;
+}
+export declare function createUniversalTelegramBot(config: TelegramBotConfig): Bot<BotContext>;

package/dist/universal-bot.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUniversalTelegramBot = createUniversalTelegramBot;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+const grammy_1 = require("grammy");
+const shared_1 = require("@verse-bot/shared");
+const bot_factory_js_1 = require("./bot-factory.js");
+const middleware_1 = require("./middleware");
+function createUniversalTelegramBot(config) {
+    const bot = (0, bot_factory_js_1.createBot)({ token: config.token });
+    // Подключаем пул БД
+    bot.use(middleware_1.dbMiddleware);
+    // Middleware создания UniversalContext
+    bot.use(async (ctx, next) => {
+        const defaultPhotoHandler = async (photoUrl, caption) => {
+            try {
+                await ctx.replyWithPhoto(photoUrl, {
+                    caption: caption ?? undefined,
+                    parse_mode: 'MarkdownV2',
+                });
+            }
+            catch {
+                if (config.contentDir) {
+                    const filename = decodeURIComponent(photoUrl.split('/').pop() ?? '');
+                    const filepath = node_path_1.default.join(config.contentDir, 'content-images', filename);
+                    if ((0, node_fs_1.existsSync)(filepath)) {
+                        const buffer = (0, node_fs_1.readFileSync)(filepath);
+                        await ctx.replyWithPhoto(new grammy_1.InputFile(buffer, filename), {
+                            caption: caption ?? undefined,
+                            parse_mode: 'MarkdownV2',
+                        });
+                    }
+                    else {
+                        await ctx.api.sendMessage(uctx.peerId, caption ?? '');
+                    }
+                }
+                else {
+                    await ctx.api.sendMessage(uctx.peerId, caption ?? '');
+                }
+            }
+        };
+        const uctx = {
+            platform: 'telegram',
+            userId: String(ctx.from?.id ?? 0),
+            peerId: ctx.chat?.id ?? 0,
+            text: ctx.message?.text ?? '',
+            isAdmin: ctx.from?.id === config.adminId,
+            db: ctx.db,
+            firstName: ctx.from?.first_name,
+            lastName: ctx.from?.last_name,
+            username: ctx.from?.username,
+            chatType: ctx.chat?.type ?? 'unknown',
+            format: (0, shared_1.format)('telegram'),
+            replySafe: async (text, extra) => uctx.reply(text, { ...(0, shared_1.mdOpts)('telegram'), ...extra }),
+            reply: async (text, extra) => {
+                await ctx.api.sendMessage(uctx.peerId, text, {
+                    ...(extra?.parse_mode && { parse_mode: extra.parse_mode }),
+                    ...(extra?.telegramReplyMarkup && { reply_markup: extra.telegramReplyMarkup }),
+                    ...(extra?.remove_keyboard && { reply_markup: { remove_keyboard: true } }),
+                    ...(extra?.link_preview_options && {
+                        link_preview_options: extra.link_preview_options,
+                    }),
+                });
+            },
+            replyWithFile: async (buffer, filename, caption) => {
+                await ctx.replyWithDocument(new grammy_1.InputFile(buffer, filename), caption ? { caption, parse_mode: 'MarkdownV2' } : { parse_mode: 'MarkdownV2' });
+            },
+            replyWithPhoto: config.onReplyWithPhoto ?? defaultPhotoHandler,
+            tgApi: ctx.api,
+        };
+        ctx.uctx = uctx;
+        await next();
+    });
+    // Middleware проверки и логирования пользователей
+    bot.use(async (ctx, next) => {
+        const text = ctx.message?.text ?? '';
+        const isStart = text === '/start' || text.startsWith('/start ');
+        const uctx = ctx.uctx;
+        if (!uctx)
+            return next();
+        const exists = await (0, shared_1.userExists)(uctx.platform, uctx.userId);
+        if (!exists) {
+            if (isStart) {
+                const dbUser = await (0, shared_1.findOrCreateUser)(uctx.platform, uctx.userId);
+                if (!dbUser)
+                    return;
+                uctx.dbUserId = dbUser.id;
+                await (0, shared_1.logCommand)(dbUser.id, uctx.platform, '/start');
+                return next();
+            }
+            return;
+        }
+        const dbUser = await (0, shared_1.findOrCreateUser)(uctx.platform, uctx.userId);
+        uctx.dbUserId = dbUser.id;
+        if (isStart) {
+            await (0, shared_1.logCommand)(dbUser.id, uctx.platform, '/start');
+            return next();
+        }
+        const command = text.split(' ')[0];
+        const commandName = command.startsWith('/') ? command : text;
+        await (0, shared_1.logCommand)(dbUser.id, uctx.platform, commandName);
+        return next();
+    });
+    // Регистрация статических команд и кнопок
+    for (const { command, label } of config.buttons) {
+        const handler = config.commands[command];
+        if (handler) {
+            // Команда вида /start
+            bot.command(command, async (ctx) => {
+                const uctx = ctx.uctx;
+                await handler(uctx);
+            });
+            // Кнопка с текстом label
+            bot.hears(label, async (ctx) => {
+                const uctx = ctx.uctx;
+                await handler(uctx);
+            });
+        }
+    }
+    // Регистрация остальных команд, которые не имеют кнопок (например, /full, /admin)
+    for (const [command, handler] of Object.entries(config.commands)) {
+        // Проверяем, не была ли уже зарегистрирована через кнопку
+        const alreadyRegistered = config.buttons.some((b) => b.command === command);
+        if (!alreadyRegistered) {
+            bot.command(command, async (ctx) => {
+                const uctx = ctx.uctx;
+                await handler(uctx);
+            });
+        }
+    }
+    // Динамические команды
+    if (config.contentCommand) {
+        bot.hears(/^\/content_(\d+)$/i, async (ctx) => {
+            const itemNumber = parseInt(ctx.match[1], 10);
+            if (!isNaN(itemNumber) && itemNumber > 0) {
+                const uctx = ctx.uctx;
+                await config.contentCommand(uctx, itemNumber);
+            }
+            else {
+                // Сообщение об ошибке? Можно передать фразу из phrases, но пока опустим
+            }
+        });
+    }
+    if (config.userLogCommand) {
+        bot.hears(/^\/userlog_(\d+)$/i, async (ctx) => {
+            const userId = parseInt(ctx.match[1], 10);
+            if (!isNaN(userId)) {
+                const uctx = ctx.uctx;
+                await config.userLogCommand(uctx, userId);
+            }
+        });
+    }
+    return bot;
+}

package/dist/utils/command.d.ts

@@ -0,0 +1,7 @@
+import type { BotContext } from '../types';
+export interface CommandDefinition {
+    command: string;
+    description: string;
+    handler: (ctx: BotContext) => Promise<void>;
+}
+export declare function createCommand(def: CommandDefinition): CommandDefinition;

package/dist/utils/command.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCommand = createCommand;
+function createCommand(def) {
+    return def;
+}

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export * from './command.js';

package/dist/utils/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./command.js"), exports);

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@verse-bot/tg-core",
+  "version": "0.1.0",
+  "description": "Core library for building Telegram bots",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noemit"
+  },
+  "dependencies": {
+    "@verse-bot/shared": "^0.1.0",
+    "grammy": "^1.42.0"
+  }
+}

package/src/bot-factory.ts

@@ -0,0 +1,31 @@
+import { Bot, session } from 'grammy';
+import { errorHandler, loggerMiddleware } from './middleware';
+import type { BotContext, SessionData } from './types';
+
+export interface BotFactoryOptions {
+  token: string;
+  useLogger?: boolean;
+  useSession?: boolean;
+}
+
+export function createBot(options: BotFactoryOptions): Bot<BotContext> {
+  const { token, useLogger = true, useSession = false } = options;
+
+  const bot = new Bot<BotContext>(token);
+
+  bot.catch(errorHandler);
+
+  if (useSession) {
+    bot.use(
+      session<SessionData, BotContext>({
+        initial: (): SessionData => ({}),
+      }),
+    );
+  }
+
+  if (useLogger) {
+    bot.use(loggerMiddleware);
+  }
+
+  return bot;
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './utils';
+export * from './middleware';
+export * from './keyboards';
+export * from './bot-factory.js';
+export * from './universal-bot.js';

package/src/keyboards/index.ts

@@ -0,0 +1,3 @@
+export * from './inline.js';
+export * from './reply.js';
+export * from './reply-universal.js';

package/src/keyboards/inline.ts

@@ -0,0 +1,24 @@
+import { InlineKeyboard } from 'grammy';
+
+export interface InlineButton {
+  text: string;
+  data?: string; // callback_data
+  url?: string; // внешняя ссылка
+}
+
+export function createInlineKeyboard(rows: InlineButton[][]): InlineKeyboard {
+  const keyboard = new InlineKeyboard();
+
+  for (const row of rows) {
+    for (const btn of row) {
+      if (btn.url) {
+        keyboard.url(btn.text, btn.url);
+      } else if (btn.data) {
+        keyboard.text(btn.text, btn.data);
+      }
+    }
+    keyboard.row();
+  }
+
+  return keyboard;
+}

package/src/keyboards/reply-universal.ts

@@ -0,0 +1,22 @@
+import { Keyboard } from 'grammy';
+import type { UniversalKeyboardButton } from '@verse-bot/shared';
+
+export function createTelegramKeyboard(
+  universalKeyboard: UniversalKeyboardButton[][],
+  resize: boolean = true,
+  oneTime: boolean = false,
+): Keyboard {
+  const keyboard = new Keyboard();
+
+  for (const row of universalKeyboard) {
+    for (const btn of row) {
+      keyboard.text(btn.label);
+    }
+    keyboard.row();
+  }
+
+  if (resize) keyboard.resized();
+  if (oneTime) keyboard.oneTime();
+
+  return keyboard;
+}

package/src/keyboards/reply.ts

@@ -0,0 +1,32 @@
+import { Keyboard } from 'grammy';
+
+export interface ReplyButton {
+  text: string;
+  requestContact?: boolean;
+  requestLocation?: boolean;
+}
+
+export function createReplyKeyboard(
+  rows: ReplyButton[][],
+  options?: { resize?: boolean; oneTime?: boolean },
+): Keyboard {
+  const keyboard = new Keyboard();
+
+  for (const row of rows) {
+    for (const btn of row) {
+      if (btn.requestContact) {
+        keyboard.requestContact(btn.text);
+      } else if (btn.requestLocation) {
+        keyboard.requestLocation(btn.text);
+      } else {
+        keyboard.text(btn.text);
+      }
+    }
+    keyboard.row();
+  }
+
+  if (options?.resize) keyboard.resized();
+  if (options?.oneTime) keyboard.oneTime();
+
+  return keyboard;
+}

package/src/middleware/db.ts

@@ -0,0 +1,8 @@
+import type { MiddlewareFn } from 'grammy';
+import { getPool } from '@verse-bot/shared';
+import type { BotContext } from '../types';
+
+export const dbMiddleware: MiddlewareFn<BotContext> = async (ctx, next) => {
+  ctx.db = getPool();
+  await next();
+};

package/src/middleware/error-handler.ts

@@ -0,0 +1,8 @@
+import type { ErrorHandler } from 'grammy';
+import type { BotContext } from '../types';
+
+export const errorHandler: ErrorHandler<BotContext> = (err) => {
+  const ctx = err.ctx;
+  console.error(`[Error] Update ${ctx.update.update_id}:`);
+  console.error(err.error);
+};

package/src/middleware/index.ts

@@ -0,0 +1,3 @@
+export * from './db.js';
+export * from './logger.js';
+export * from './error-handler.js';

package/src/middleware/logger.ts

@@ -0,0 +1,14 @@
+import type { MiddlewareFn } from 'grammy';
+import type { BotContext } from '../types';
+
+export const loggerMiddleware: MiddlewareFn<BotContext> = async (ctx, next) => {
+  const start = Date.now();
+  const from = ctx.from?.username ?? ctx.from?.id ?? 'unknown';
+  const text = ctx.message?.text ?? ctx.callbackQuery?.data ?? '—';
+
+  console.log(`[${new Date().toISOString()}] @${from}: ${text}`);
+
+  await next();
+
+  console.log(`[${new Date().toISOString()}] Handled in ${Date.now() - start}ms`);
+};

package/src/types/bot.ts

@@ -0,0 +1,14 @@
+import type { Context as GrammyContext, SessionFlavor } from 'grammy';
+import type { Pool } from 'pg';
+
+export interface SessionData {
+  // Здесь будут общие данные сессии, например:
+  // userId: number;
+  // language: 'ru' | 'en';
+}
+
+// Расширяем контекст gramgrammy
+export interface BotContext extends GrammyContext, SessionFlavor<SessionData> {
+  // Можно добавить свои поля
+  db: Pool;
+}

package/src/types/index.ts

@@ -0,0 +1 @@
+export * from './bot.js';

package/src/universal-bot.ts

@@ -0,0 +1,188 @@
+import path from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { Bot, InputFile } from 'grammy';
+import {
+  findOrCreateUser,
+  format,
+  logCommand,
+  type UniversalContext,
+  userExists,
+  mdOpts,
+} from '@verse-bot/shared';
+import { createBot } from './bot-factory.js';
+import { dbMiddleware } from './middleware';
+import type { BotContext } from './types';
+
+export interface TelegramBotConfig {
+  token: string;
+  adminId?: number;
+  /** Обработчики статических команд (без параметров). Ключ – имя команды (без слеша). */
+  commands: Record<string, (ctx: UniversalContext) => Promise<void>>;
+  /** Определения кнопок (берутся из phrases). Массив объектов с command и button. */
+  buttons: { command: string; label: string }[];
+  /** Опционально: обработчик команды /content_<N> */
+  contentCommand?: (ctx: UniversalContext, itemNumber: number) => Promise<void>;
+  /** Опционально: обработчик команды /userlog_<N> */
+  userLogCommand?: (ctx: UniversalContext, userId: number) => Promise<void>;
+  /** Опциональный кастомный обработчик отправки фото (используется в replyWithPhoto контекста).
+   *  Если не задан, используется ctx.replyWithPhoto из GrammY. */
+  onReplyWithPhoto?: (photoUrl: string, caption?: string) => Promise<void>;
+  /** Путь к папке с контентом (для резервного поиска изображений). */
+  contentDir?: string;
+}
+
+export function createUniversalTelegramBot(config: TelegramBotConfig): Bot<BotContext> {
+  const bot = createBot({ token: config.token });
+
+  // Подключаем пул БД
+  bot.use(dbMiddleware);
+
+  // Middleware создания UniversalContext
+  bot.use(async (ctx, next) => {
+    const defaultPhotoHandler = async (photoUrl: string, caption?: string) => {
+      try {
+        await ctx.replyWithPhoto(photoUrl, {
+          caption: caption ?? undefined,
+          parse_mode: 'MarkdownV2',
+        });
+      } catch {
+        if (config.contentDir) {
+          const filename = decodeURIComponent(photoUrl.split('/').pop() ?? '');
+          const filepath = path.join(config.contentDir, 'content-images', filename);
+          if (existsSync(filepath)) {
+            const buffer = readFileSync(filepath);
+            await ctx.replyWithPhoto(new InputFile(buffer, filename), {
+              caption: caption ?? undefined,
+              parse_mode: 'MarkdownV2',
+            });
+          } else {
+            await ctx.api.sendMessage(uctx.peerId, caption ?? '');
+          }
+        } else {
+          await ctx.api.sendMessage(uctx.peerId, caption ?? '');
+        }
+      }
+    };
+
+    const uctx: UniversalContext = {
+      platform: 'telegram',
+      userId: String(ctx.from?.id ?? 0),
+      peerId: ctx.chat?.id ?? 0,
+      text: ctx.message?.text ?? '',
+      isAdmin: ctx.from?.id === config.adminId,
+      db: ctx.db,
+      firstName: ctx.from?.first_name,
+      lastName: ctx.from?.last_name,
+      username: ctx.from?.username,
+      chatType: ctx.chat?.type ?? 'unknown',
+      format: format('telegram'),
+      replySafe: async (text, extra) => uctx.reply(text, { ...mdOpts('telegram'), ...extra }),
+      reply: async (text, extra) => {
+        await ctx.api.sendMessage(uctx.peerId, text, {
+          ...(extra?.parse_mode && { parse_mode: extra.parse_mode }),
+          ...(extra?.telegramReplyMarkup && { reply_markup: extra.telegramReplyMarkup }),
+          ...(extra?.remove_keyboard && { reply_markup: { remove_keyboard: true } }),
+          ...(extra?.link_preview_options && {
+            link_preview_options: extra.link_preview_options,
+          }),
+        });
+      },
+      replyWithFile: async (buffer, filename, caption) => {
+        await ctx.replyWithDocument(
+          new InputFile(buffer, filename),
+          caption ? { caption, parse_mode: 'MarkdownV2' } : { parse_mode: 'MarkdownV2' },
+        );
+      },
+      replyWithPhoto: config.onReplyWithPhoto ?? defaultPhotoHandler,
+      tgApi: ctx.api,
+    };
+    (ctx as any).uctx = uctx;
+    await next();
+  });
+
+  // Middleware проверки и логирования пользователей
+  bot.use(async (ctx, next) => {
+    const text = ctx.message?.text ?? '';
+    const isStart = text === '/start' || text.startsWith('/start ');
+    const uctx: UniversalContext = (ctx as any).uctx;
+    if (!uctx) return next();
+
+    const exists = await userExists(uctx.platform, uctx.userId);
+    if (!exists) {
+      if (isStart) {
+        const dbUser = await findOrCreateUser(uctx.platform, uctx.userId);
+        if (!dbUser) return;
+        uctx.dbUserId = dbUser.id;
+        await logCommand(dbUser.id, uctx.platform, '/start');
+        return next();
+      }
+      return;
+    }
+
+    const dbUser = await findOrCreateUser(uctx.platform, uctx.userId);
+    uctx.dbUserId = dbUser!.id;
+    if (isStart) {
+      await logCommand(dbUser!.id, uctx.platform, '/start');
+      return next();
+    }
+
+    const command = text.split(' ')[0];
+    const commandName = command.startsWith('/') ? command : text;
+    await logCommand(dbUser!.id, uctx.platform, commandName);
+    return next();
+  });
+
+  // Регистрация статических команд и кнопок
+  for (const { command, label } of config.buttons) {
+    const handler = config.commands[command];
+    if (handler) {
+      // Команда вида /start
+      bot.command(command, async (ctx) => {
+        const uctx = (ctx as any).uctx;
+        await handler(uctx);
+      });
+      // Кнопка с текстом label
+      bot.hears(label, async (ctx) => {
+        const uctx = (ctx as any).uctx;
+        await handler(uctx);
+      });
+    }
+  }
+
+  // Регистрация остальных команд, которые не имеют кнопок (например, /full, /admin)
+  for (const [command, handler] of Object.entries(config.commands)) {
+    // Проверяем, не была ли уже зарегистрирована через кнопку
+    const alreadyRegistered = config.buttons.some((b) => b.command === command);
+    if (!alreadyRegistered) {
+      bot.command(command, async (ctx) => {
+        const uctx = (ctx as any).uctx;
+        await handler(uctx);
+      });
+    }
+  }
+
+  // Динамические команды
+  if (config.contentCommand) {
+    bot.hears(/^\/content_(\d+)$/i, async (ctx) => {
+      const itemNumber = parseInt(ctx.match[1], 10);
+      if (!isNaN(itemNumber) && itemNumber > 0) {
+        const uctx = (ctx as any).uctx;
+        await config.contentCommand!(uctx, itemNumber);
+      } else {
+        // Сообщение об ошибке? Можно передать фразу из phrases, но пока опустим
+      }
+    });
+  }
+
+  if (config.userLogCommand) {
+    bot.hears(/^\/userlog_(\d+)$/i, async (ctx) => {
+      const userId = parseInt(ctx.match[1], 10);
+      if (!isNaN(userId)) {
+        const uctx = (ctx as any).uctx;
+        await config.userLogCommand!(uctx, userId);
+      }
+    });
+  }
+
+  return bot;
+}

package/src/utils/command.ts

@@ -0,0 +1,11 @@
+import type { BotContext } from '../types';
+
+export interface CommandDefinition {
+  command: string;
+  description: string;
+  handler: (ctx: BotContext) => Promise<void>;
+}
+
+export function createCommand(def: CommandDefinition) {
+  return def;
+}

package/src/utils/index.ts

@@ -0,0 +1 @@
+export * from './command.js';

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "composite": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}