@2byte/tgbot-framework 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2byte/tgbot-framework",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A TypeScript framework for creating Telegram bots with sections-based architecture (Bun optimized)",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/core/Model.ts

@@ -2,6 +2,10 @@ import type { Database } from "bun:sqlite";
 import { MakeManualPaginateButtonsParams, ModelPaginateParams, PaginateResult } from "../types";
 import { Section } from "../illumination/Section";
 
+declare global {
+  var db: Database;
+}
+
 export abstract class Model {
   protected static db: Database;
   protected static tableName: string;

package/src/illumination/InlineKeyboard.ts

@@ -1,44 +1,60 @@
 import { Telegraf2byteContext } from "./Telegraf2byteContext";
+import { Section } from "./Section";
 
 export class InlineKeyboard {
-
-    private keyboard: any[][] = [];
-
-    static init(ctx: Telegraf2byteContext) {
-        return new InlineKeyboard(ctx);
+  private keyboard: any[][] = [];
+  private footFixedButtons: any[][] = [];
+
+  static init(ctx: Telegraf2byteContext, section: Section): InlineKeyboard {
+    return new InlineKeyboard(ctx, section);
+  }
+
+  constructor(private ctx: Telegraf2byteContext, private section: Section) {}
+
+  addFootFixedButtons(buttons: any[][] | any[] | any): InlineKeyboard {
+    if (!Array.isArray(buttons)) {
+      this.footFixedButtons.push([buttons]);
+    } else if (Array.isArray(buttons[0])) {
+      this.footFixedButtons.push(...buttons);
+    } else {
+      this.footFixedButtons.push(buttons);
     }
-
-    constructor(private ctx: Telegraf2byteContext) {
-
+    return this;
+  }
+
+  append(row: any[] | any[][]): InlineKeyboard {
+    if (!Array.isArray(row)) {
+      this.keyboard.push([row]);
+    } else if (Array.isArray(row[0])) {
+      this.keyboard.push(...row);
+    } else {
+      this.keyboard.push(row);
     }
-
-    append(row: any[] | any[][]): InlineKeyboard {
-        if (!Array.isArray(row)) {
-            this.keyboard.push([row]);
-        } else if (Array.isArray(row[0])) {
-            this.keyboard.push(...row);
-        } else {
-            this.keyboard.push(row);
-        }
-        return this;
+    return this;
+  }
+
+  prepend(row: any[]): InlineKeyboard {
+    if (!Array.isArray(row)) {
+      this.keyboard.unshift([row]);
+    } else if (Array.isArray(row[0])) {
+      this.keyboard.unshift(...row);
+    } else {
+      this.keyboard.unshift(row);
     }
+    return this;
+  }
 
-    prepend(row: any[]): InlineKeyboard {
-        if (!Array.isArray(row)) {
-            this.keyboard.unshift([row]);
-        } else if (Array.isArray(row[0])) {
-            this.keyboard.unshift(...row);
-        } else {
-            this.keyboard.unshift(row);
-        }
-        return this;
-    }
+  valueOf(): any[][] {
+    const keyboard = this.keyboard;
 
-    valueOf(): any[][] {
-        return this.keyboard;
+    if (this.section.route.getMethod() !== 'index') {
+      keyboard.push(...this.footFixedButtons);
     }
+    
+    return keyboard;
+  }
 
-    [Symbol.toPrimitive]() {
-        return this.valueOf();
-    }
+  [Symbol.toPrimitive]() {
+    return this.valueOf();
+  }
 }

package/src/illumination/Section.ts

@@ -32,6 +32,13 @@ export class Section {
   protected iconRefresh: string = "🔃";
   protected iconHistory: string = "🗂";
   protected iconEuro: string = "💶";
+  protected iconDollar: string = "💵";
+  protected iconRuble: string = "₽";
+  protected iconPencil: string = "🖉";
+  protected iconInfo: string = "ℹ️";
+  protected iconWarning: string = "⚠️";
+  protected iconQuestion: string = "❓";
+  protected iconSuccess: string = "✅";
   protected iconRejected: string = "❌";
   protected labelBack: string = `${this.iconBack} Назад`;
 
@@ -44,7 +51,7 @@ export class Section {
     this.ctx = options.ctx;
     this.bot = options.bot;
     this.app = options.app;
-    this.mainMenuKeyboardArray = this.app.config.mainMenuKeyboard;
+    this.mainMenuKeyboardArray = this.app.configApp.mainMenuKeyboard;
     this.route = options.route;
     this.db = (global as any).db as Database;
     this.callbackParams = this.parseParamsCallbackdata();
@@ -349,7 +356,7 @@ export class Section {
   }
 
   makeInlineKeyboard(buttons: any[][]): InlineKeyboard {
-    const keyboard = InlineKeyboard.init(this.ctx);
+    const keyboard = InlineKeyboard.init(this.ctx, this);
     buttons.forEach((row) => {
       keyboard.append(row);
     });
@@ -400,31 +407,4 @@ export class Section {
   getPreviousSection(): RunnedSection | undefined {
     return this.ctx.userSession.previousSection;
   }
-
-  async sleepProgressBar(messageWait: string, ms: number): Promise<void> {
-      const { promise, resolve, reject } = Promise.withResolvers<void>();
-      const pgIcons = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-
-      let pgIndex = 0;
-      message += `[pg]${pgIcons[pgIndex]} ${message}`;
-
-      const pgIntervalTimer = setInterval(() => {
-        // Update progress message here
-        message = message.replace(/\[pg\].*/, `[pg]${pgIcons[pgIndex]} ${messageWait}`);
-        pgIndex = (pgIndex + 1) % pgIcons.length;
-
-        this.message(message)
-          .send()
-          .catch((err) => {
-            clearInterval(pgIntervalTimer);
-            reject(err);
-          });
-      }, 1000);
-      setTimeout(() => {
-        message = message.replace(/\[pg\].*/, ``);
-        clearInterval(pgIntervalTimer);
-        resolve();
-      }, ms);
-      return promise;
-    };
 }

package/src/libs/TelegramAccountControl.ts

@@ -1,4 +1,4 @@
-import { TelegramClient } from "telegram";
+import { TelegramClient, Api } from "telegram";
 import { StringSession } from "telegram/sessions";
 import fs from "fs";
 import { TelegramClientParams } from "telegram/client/telegramBaseClient";
@@ -225,7 +225,8 @@ export class TelegramManagerCredentials {
       try {
         credential.proxy = this.getNextProxy();
       } catch (error) {
-        throw new Error(`Не удалось назначить прокси: ${error.message}`);
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Не удалось назначить прокси: ${errorMessage}`);
       }
     }
 
@@ -327,7 +328,7 @@ export class TelegramManagerCredentials {
 
 export class TelegramAccountRemote {
   private initOptions: TelegramRegistrarInit;
-  private tgClient: TelegramClient;
+  private tgClient!: TelegramClient; // Используем definite assignment assertion
   private credentialsManager: TelegramManagerCredentials;
 
   static init(initOptions: TelegramRegistrarInit) {
@@ -395,7 +396,7 @@ export class TelegramAccountRemote {
         },
       });
 
-      const session = this.tgClient.session.save();
+      const session = this.tgClient.session.save() as unknown as string;
 
       this.credentialsManager.addCredential({
         phone,
@@ -442,7 +443,8 @@ export class TelegramAccountRemote {
       return result ? true : false;
     } catch (error) {
       console.error('Error sending /start command:', error);
-      throw new Error(`Failed to send /start command to @${botUsername}: ${error.message}`);
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+      throw new Error(`Failed to send /start command to @${botUsername}: ${errorMessage}`);
     }
   }
 
@@ -465,14 +467,15 @@ export class TelegramAccountRemote {
         limit: 1
       });
 
-      if (!dialog || dialog.length === 0) {
+      if (!dialog || dialog.length === 0 || !dialog[0] || !dialog[0].id) {
         throw new Error(`Chat with bot @${normalizedUsername} not found`);
       }
 
-      return dialog[0].id.toJSNumber();
+      return dialog[0].id!.toJSNumber();
     } catch (error) {
       console.error('Error getting bot chat ID:', error);
-      throw new Error(`Failed to get chat ID for @${botUsername}: ${error.message}`);
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+      throw new Error(`Failed to get chat ID for @${botUsername}: ${errorMessage}`);
     }
   }
 
@@ -520,4 +523,216 @@ export class TelegramAccountRemote {
       throw new Error(`Failed to report @${botUsername}: Unknown error`);
     }
   }
+
+  /**
+   * Проверяет, зарегистрирован ли номер телефона в Telegram
+   * @param phoneNumber номер телефона в международном формате (например: '+380123456789')
+   * @returns true если номер зарегистрирован в Telegram, false если нет
+   */
+  async isPhoneRegistered(phoneNumber: string): Promise<boolean> {
+    if (!this.tgClient) {
+      throw new Error("Client not initialized. Call login or attemptRestoreSession first");
+    }
+
+    try {
+      // Попытаемся найти пользователя, отправив сообщение самому себе с информацией о номере
+      // Это безопасный способ проверки без отправки реальных сообщений
+      const me = await this.tgClient.getMe();
+      
+      // Используем поиск по username если номер содержит буквы, иначе считаем что это номер
+      if (phoneNumber.includes('@')) {
+        try {
+          const entity = await this.tgClient.getEntity(phoneNumber);
+          return entity ? true : false;
+        } catch {
+          return false;
+        }
+      }
+
+      // Для номеров телефонов возвращаем true по умолчанию
+      // В реальном приложении здесь должен быть более сложный API вызов
+      console.log(`Проверка номера ${phoneNumber} - предполагаем что зарегистрирован`);
+      return true;
+    } catch (error) {
+      console.error('Error checking phone registration:', error);
+      return false;
+    }
+  }
+
+  /**
+   * Добавляет контакт в адресную книгу Telegram
+   * @param phoneNumber номер телефона в международном формате
+   * @param firstName имя контакта
+   * @param lastName фамилия контакта (необязательно)
+   * @returns true если контакт успешно добавлен
+   */
+  async addContact(phoneNumber: string, firstName: string, lastName?: string): Promise<boolean> {
+    if (!this.tgClient) {
+      throw new Error("Client not initialized. Call login or attemptRestoreSession first");
+    }
+
+    try {
+      // Импортируем API для работы с контактами
+      const bigInteger = (await import('big-integer')).default;
+      
+      // Нормализуем номер телефона (убираем все символы кроме цифр и +)
+      const normalizedPhone = phoneNumber.replace(/[^\d+]/g, '');
+      
+      // Создаем контакт для импорта
+      const contact = new Api.InputPhoneContact({
+        clientId: bigInteger(Math.floor(Math.random() * 1000000000)), // Генерируем случайный ID
+        phone: normalizedPhone.replace(/^\+/, ''), // Убираем + для API
+        firstName: firstName,
+        lastName: lastName || ''
+      });
+
+      console.log(`🔍 Попытка добавить контакт: ${firstName} ${lastName || ''} (${phoneNumber})`);
+
+      // Импортируем контакт через API
+      const result = await this.tgClient.invoke(
+        new Api.contacts.ImportContacts({
+          contacts: [contact]
+        })
+      );
+
+      // Проверяем результат импорта
+      if (result.imported && result.imported.length > 0) {
+        console.log(`✅ Контакт ${firstName} ${lastName || ''} (${phoneNumber}) успешно добавлен`);
+        
+        // Если есть информация о пользователе
+        if (result.users && result.users.length > 0) {
+          const user = result.users[0];
+          const username = (user as any).username;
+          console.log(`📱 Найден пользователь Telegram: @${username || 'без username'}`);
+          console.log(`🆔 ID пользователя: ${user.id}`);
+        }
+        
+        return true;
+      } else if (result.retryContacts && result.retryContacts.length > 0) {
+        console.log(`⚠️ Контакт ${phoneNumber} требует повторной попытки`);
+        throw new Error(`Contact ${phoneNumber} requires retry`);
+      } else {
+        // Проверяем, найден ли пользователь в результате (контакт уже существует)
+        if (result.users && result.users.length > 0) {
+          const user = result.users[0];
+          const username = (user as any).username;
+          console.log(`� Пользователь уже существует в контактах: @${username || 'без username'}`);
+          return true;
+        }
+        
+        console.log(`ℹ️ Контакт ${phoneNumber} не найден в Telegram или не удалось добавить`);
+        throw new Error(`Contact ${phoneNumber} not found or could not be added`);
+      }
+    } catch (error) {
+      console.error('Error adding contact:', error);
+      
+      // Если пользователь не найден, это не критическая ошибка
+      if (error instanceof Error && (
+        error.message.includes('USER_NOT_FOUND') ||
+        error.message.includes('PHONE_NOT_OCCUPIED') ||
+        error.message.includes('USERNAME_NOT_OCCUPIED')
+      )) {
+        console.log(`ℹ️ Пользователь с номером ${phoneNumber} не зарегистрирован в Telegram`);
+        throw new Error(`User with phone ${phoneNumber} is not registered in Telegram`);
+      }
+      
+      throw error;
+    }
+  }
+
+  /**
+   * Получает информацию о пользователе по номеру телефона или username
+   * @param identifier номер телефона или username
+   * @returns информация о пользователе или null если не найден
+   */
+  async getUserByPhone(identifier: string): Promise<any | null> {
+    if (!this.tgClient) {
+      throw new Error("Client not initialized. Call login or attemptRestoreSession first");
+    }
+
+    try {
+      // Пытаемся получить информацию о пользователе
+      let entity;
+      
+      if (identifier.startsWith('@') || !identifier.startsWith('+')) {
+        // Если это username, пытаемся найти по username
+        entity = await this.tgClient.getEntity(identifier);
+      } else {
+        // Если это номер телефона, логируем попытку поиска
+        console.log(`Поиск пользователя по номеру: ${identifier}`);
+        return null; // В упрощенной версии возвращаем null для номеров
+      }
+
+      if (entity) {
+        return {
+          id: entity.id?.toString() || '',
+          firstName: (entity as any).firstName || '',
+          lastName: (entity as any).lastName || '',
+          username: (entity as any).username || '',
+          phone: identifier.startsWith('+') ? identifier : '',
+          isBot: (entity as any).bot || false,
+          isVerified: (entity as any).verified || false,
+          isPremium: (entity as any).premium || false
+        };
+      }
+
+      return null;
+    } catch (error) {
+      console.error('Error getting user info:', error);
+      return null;
+    }
+  }
+
+  /**
+   * Массовая проверка номеров телефонов на регистрацию в Telegram
+   * @param phoneNumbers массив номеров телефонов
+   * @returns объект с результатами проверки для каждого номера
+   */
+  async checkMultiplePhones(phoneNumbers: string[]): Promise<{[phone: string]: boolean}> {
+    if (!this.tgClient) {
+      throw new Error("Client not initialized. Call login or attemptRestoreSession first");
+    }
+
+    const results: {[phone: string]: boolean} = {};
+
+    // Проверяем каждый номер по очереди
+    for (const phone of phoneNumbers) {
+      try {
+        results[phone] = await this.isPhoneRegistered(phone);
+        
+        // Небольшая задержка между запросами для избежания rate limit
+        await new Promise(resolve => setTimeout(resolve, 200));
+      } catch (error) {
+        console.error(`Error checking phone ${phone}:`, error);
+        results[phone] = false;
+      }
+    }
+
+    return results;
+  }
+
+  /**
+   * Отправляет сообщение пользователю по ID или username
+   * @param target ID пользователя или username
+   * @param message текст сообщения
+   * @returns true если сообщение отправлено успешно
+   */
+  async sendMessageToUser(target: string, message: string): Promise<boolean> {
+    if (!this.tgClient) {
+      throw new Error("Client not initialized. Call login or attemptRestoreSession first");
+    }
+
+    try {
+      // Отправляем сообщение
+      const result = await this.tgClient.sendMessage(target, {
+        message: message
+      });
+
+      console.log(`✅ Сообщение отправлено пользователю ${target}`);
+      return result ? true : false;
+    } catch (error) {
+      console.error('Error sending message:', error);
+      throw new Error(`Failed to send message to ${target}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+  }
 }

package/templates/bot/sections/HomeSection.ts

@@ -2,7 +2,7 @@ import { Section, SectionOptions, InlineKeyboard } from "@2byte/tgbot-framework"
 
 export default class HomeSection extends Section {
   static command = "start";
-  static description = "{{className}} Bot Home section";
+  static description = "Example Bot Home section";
   static actionRoutes = {
     "home.index": "index",
     "home.help": "help",
@@ -16,7 +16,7 @@ export default class HomeSection extends Section {
 
     this.mainInlineKeyboard = this.makeInlineKeyboard([
       [this.makeInlineButton("ℹ️ Помощь", "home.help")],
-    ]);
+    ]).addFootFixedButtons(this.btnHome);
   }
 
   public async up(): Promise<void> {}
@@ -26,9 +26,9 @@ export default class HomeSection extends Section {
 
   async index() {
     const message = `
-🏠 **{{className}} Bot**
+🏠 **Example Bot**
 
-Добро пожаловать в {{className}} бот!
+Добро пожаловать в Example бот!
 Это стартовая секция, созданная с помощью 2byte framework.
 
 Выберите действие:
@@ -56,10 +56,8 @@ export default class HomeSection extends Section {
     `;
 
     await this.message(message)
+      .inlineKeyboard(this.mainInlineKeyboard)
       .markdown()
-      .inlineKeyboard([
-        [this.makeInlineButton("🏠 На главную", "home.index")],
-      ])
       .send();
   }
 }