Class mmApp

constructor

• new mmApp(): mmApp

  Returns mmApp

StaticuserDbController

StaticisSaveDb

false
Copy

StaticappType

Staticconfig

Staticparams

Staticcommands

StaticisDevMode

• get isDevMode(): boolean

  Возвращает текущий режим работы приложения

  Returns boolean

  true, если включен режим разработки

StaticsetDevMode

• setDevMode(isDevMode?: boolean): void

  Устанавливает режим разработки

  Parameters

  • isDevMode: boolean = false

    Флаг включения режима разработки

  Returns void

  Remarks

  В режиме разработки в консоль выводятся все ошибки и предупреждения

StaticarrayMerge

• arrayMerge(array1: object[], array2?: object[]): object

  Объединяет два массива объектов

  Parameters

  • array1: object[]

    Основной массив
  • Optionalarray2: object[]

    Массив для объединения

  Returns object

  Объединенный массив

StaticsetConfig

• setConfig(config: IAppConfig): void

  Устанавливает конфигурацию приложения

  Parameters

  • config: IAppConfig

    Пользовательская конфигурация

  Returns void

StaticsetParams

• setParams(params: IAppParam): void

  Устанавливает параметры приложения

  Parameters

  • params: IAppParam

    Пользовательские параметры

  Returns void

StaticaddCommand

• addCommand<
      TBotController extends
          BotController<IUserData> = BotController<IUserData>,
  >(
      commandName: string,
      slots: string[],
      cb?: (userCommand: string, botController: TBotController) => string | void,
      isPattern?: boolean,
  ): void

  Добавляет команду для обработки пользовательских запросов

  Type Parameters

  • TBotController extends BotController<IUserData> = BotController<IUserData>

  Parameters

  • commandName: string

    Уникальный идентификатор команды
  • slots: string[]

    Триггеры для активации команды
  • Optionalcb: (userCommand: string, botController: TBotController) => string | void

    Функция-обработчик команды
  • isPattern: boolean = false

    Использовать регулярные выражения (по умолчанию false)

  Returns void

  Example

  Простая команда со словами:

  mmApp.addCommand(
    'greeting',
    ['привет', 'здравствуй'],
    (cmd, ctrl) => {
      if (ctrl) ctrl.text = 'Здравствуйте!';
    }
  );
  Copy

  Example

  Команда с регулярными выражениями:

  // Обработка чисел от 1 до 999
  mmApp.addCommand(
    'number',
    ['\\b([1-9]|[1-9][0-9]|[1-9][0-9][0-9])\\b'],
    (cmd, ctrl) => {
      if (ctrl) ctrl.text = `Вы ввели число: ${cmd}`;
    },
    true  // включаем поддержку регулярных выражений
  );
  Copy

  Example

  Команда с доступом к состоянию:

  mmApp.addCommand(
    'stats',
    ['статистика'],
    async (cmd, ctrl) => {
      if (ctrl) {
        // Доступ к пользовательским данным
        const visits = ctrl.userData?.visits || 0;
        ctrl.text = `Вы использовали бота ${visits} раз`;
  
        // Доступ к кнопкам и другим UI элементам
        ctrl.buttons
          .addBtn('Сбросить статистику')
          .addBtn('Закрыть');
      }
    }
  );
  Copy

  Remarks

  • Команды обрабатываются в порядке добавления
  • При isPattern=true используются регулярные выражения JavaScript
  • В callback доступен весь функционал BotController
  • Можно использовать async функции в callback

StaticremoveCommand

• removeCommand(commandName: string): void

  Удаляет команду

  Parameters

  • commandName: string

    Имя команды

  Returns void

StaticsetIsSaveDb

• setIsSaveDb(isSaveDb?: boolean): void

  Устанавливает способ хранения пользовательских данных

  Parameters

  • isSaveDb: boolean = false

    true для сохранения в БД, false для сохранения в файл

  Returns void

StaticsaveData

• saveData(dir: IDir, data: string, mode?: string): boolean

  Сохраняет данные в файл

  Parameters

  • dir: IDir

    Объект с путем и названием файла
  • data: string

    Сохраняемые данные
  • Optionalmode: string

    Режим записи

  Returns boolean

  true в случае успешного сохранения

StaticsaveJson

• saveJson(fileName: string, data: any): boolean

  Сохраняет данные в JSON файл

  Parameters

  • fileName: string

    Имя файла
  • data: any

    Данные для сохранения

  Returns boolean

  true в случае успешного сохранения

StaticsaveLog

• saveLog(fileName: string, errorText?: null | string): boolean

  Сохраняет лог ошибки

  Parameters

  • fileName: string

    Имя файла лога
  • errorText: null | string = ''

    Текст ошибки

  Returns boolean

  true в случае успешного сохранения