@skroz/telegram-bot 1.0.2 → 1.0.4

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-import { TG_Update, TG_User } from '@skroz/telegram-api/dist/TelegramTypes';
+import { TG_CallbackQuery, TG_Message, TG_SendMessageResponse, TG_SendPhotoInput, TG_Update } from '@skroz/telegram-api/dist/TelegramTypes';
+export declare const createCallbackData: (telegramId: number | string, data: string[]) => string;
+export declare const getCallbackData: (data: string) => string[];
 declare class TelegramBot {
     private readonly botToken;
     constructor(botToken: string);
     setWebhook(webhookUrl: string): Promise<import("@skroz/telegram-api/dist/ResultAndDescription").default>;
-    handleUpdate(update: TG_Update, handleCallback: (callbackParams: string[]) => void, handleMessage: (incomingText: string) => void): Promise<{
-        from: TG_User;
-    } | undefined>;
+    handleUpdate(update: TG_Update, handleCallback: (callbackQuery: TG_CallbackQuery, callbackDataParams: string[]) => Promise<void>, handleMessage: (message: TG_Message) => void): Promise<void>;
+    sendPhoto(input: TG_SendPhotoInput, message?: TG_Message): Promise<TG_SendMessageResponse>;
     deleteWebhook(): Promise<void>;
 }
 export default TelegramBot;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAS5E,cAAM,WAAW;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,UAAU,CAAC,UAAU,EAAE,MAAM;IAI7B,YAAY,CAChB,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,IAAI,EAClD,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,GAC5C,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAwDnC,aAAa;CAGpB;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,SAAS,EACV,MAAM,wCAAwC,CAAC;AAUhD,eAAO,MAAM,kBAAkB,eACjB,MAAM,GAAG,MAAM,QACrB,MAAM,EAAE,KACb,MAC0E,CAAC;AAG9E,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,MAAM,EACxB,CAAC;AAE9B,cAAM,WAAW;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,UAAU,CAAC,UAAU,EAAE,MAAM;IAI7B,YAAY,CAChB,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,CACd,aAAa,EAAE,gBAAgB,EAC/B,kBAAkB,EAAE,MAAM,EAAE,KACzB,OAAO,CAAC,IAAI,CAAC,EAClB,aAAa,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAC3C,OAAO,CAAC,IAAI,CAAC;IAmCV,SAAS,CACb,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,sBAAsB,CAAC;IA2C5B,aAAa;CAGpB;AAED,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -3,13 +3,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCallbackData = exports.createCallbackData = void 0;
 const telegram_api_1 = __importDefault(require("@skroz/telegram-api"));
+/* eslint-disable @typescript-eslint/naming-convention */
 /* хранит уникальные колбэки, чтобы исключить повторное нажатие */
 const processedCallbacks = new Set();
-/* разделитель для отслеживания повторных колбэков */
-const uniqueCallbackFilter = '&&';
 /* разделитель для параметров колбэка */
-const callbackParamDivider = ':^:^:';
+const callbackDivider = '^:^:^';
+/* не больше 64 символов по документации, внутри защита от повторных кликов */
+const createCallbackData = (telegramId, data) => [`${Date.now()}_${telegramId}`, ...data].join(callbackDivider).slice(0, 64);
+exports.createCallbackData = createCallbackData;
+/* не больше 64 символов по документации, внутри защита от повторных кликов */
+const getCallbackData = (data) => data.split(callbackDivider);
+exports.getCallbackData = getCallbackData;
 class TelegramBot {
     constructor(botToken) {
         this.botToken = botToken;
@@ -20,49 +26,64 @@ class TelegramBot {
     async handleUpdate(update, handleCallback, handleMessage) {
         const callbackQuery = update.callback_query;
         if (callbackQuery) {
-            /* Обработаем этот callback */
-            /* Получаем Телеграм Юзера = from: TG_User */
-            const { from } = callbackQuery;
-            // В этом случае callbackQuery.message - это сообщение. На нём была кнопка, которую нажали
-            const telegramId = from.id;
-            if (!telegramId)
-                return undefined;
-            /* Найдем Callback */
-            const callback = callbackQuery.data;
-            if (!callback)
-                return undefined;
-            // const { message } = callbackQuery;
-            if (callback.includes(uniqueCallbackFilter)) {
-                if (processedCallbacks.has(callback)) {
-                    return undefined; // Уже обработан
-                }
-                processedCallbacks.add(callback);
-                // Удаляем из памяти через 60 секунд
-                setTimeout(() => {
-                    processedCallbacks.delete(callback);
-                }, 60 * 1000);
+            const { data } = callbackQuery;
+            if (!data) {
+                // 1. Коллбэк пришел от WebApp
+                // 2. Игровая кнопка
+                // 3. Кнопка с удаленным сообщением
+                return; // todo sendError
             }
-            const params = callback.split(callbackParamDivider);
-            handleCallback(params);
-            return { from };
+            // data - всегда уникален, потому что в начале стоит текущий Date.now()
+            if (processedCallbacks.has(data)) {
+                // чтобы избежать дублирования нажатия на кнопку
+                return; // Уже обработан
+            }
+            processedCallbacks.add(data);
+            // Удаляем из памяти через 60 секунд
+            setTimeout(() => {
+                processedCallbacks.delete(data);
+            }, 60 * 1000);
+            await handleCallback(callbackQuery, (0, exports.getCallbackData)(data));
         }
         /* обработаем сообщение */
         const { message } = update; // его нет, если это нажатие на кнопку callback_query или при редактировании предыдущего сообщения
         if (!callbackQuery && message) {
-            /* точно не кнопка */
-            const { from } = message;
-            if (from) {
-                /* Есть пользователь, значит это сообщение от пользователя, либо сообщения боту, либо в группе, либо в канале */
-                const telegramId = from.id;
-                if (!telegramId)
-                    return undefined;
-                /* Есть сообщение для бота */
-                const incomingText = message.text ?? '';
-                handleMessage(incomingText);
-                return { from };
+            /* разбираем входящий текст */
+            await handleMessage(message);
+        }
+    }
+    async sendPhoto(input, message) {
+        const { chat_id, reply_markup, caption, photo } = input;
+        let sendResult;
+        const sendPhotoFunction = () => telegram_api_1.default.sendPhoto({
+            chat_id,
+            caption,
+            photo,
+            parse_mode: 'HTML',
+            reply_markup,
+        }, this.botToken);
+        if (message) {
+            try {
+                sendResult = await telegram_api_1.default.editMessageMedia({
+                    media: {
+                        type: 'photo',
+                        media: photo,
+                        caption,
+                        parse_mode: 'HTML',
+                    },
+                    message_id: message.message_id,
+                    reply_markup,
+                    chat_id,
+                }, this.botToken);
             }
+            catch (e) {
+                sendResult = await sendPhotoFunction();
+            }
+        }
+        else {
+            sendResult = await sendPhotoFunction();
         }
-        return undefined;
+        return sendResult;
     }
     async deleteWebhook() {
         return telegram_api_1.default.deleteWebhook(this.botToken);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAAA,uEAA8C;AAG9C,kEAAkE;AAClE,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAE,CAAC;AACrC,qDAAqD;AACrD,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,wCAAwC;AACxC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAErC,MAAM,WAAW;IACf,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,KAAK,CAAC,UAAU,CAAC,UAAkB;QACjC,OAAO,sBAAW,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAiB,EACjB,cAAkD,EAClD,aAA6C;QAE7C,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,aAAa,EAAE,CAAC;YAClB,8BAA8B;YAC9B,6CAA6C;YAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC;YAC/B,0FAA0F;YAC1F,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU;gBAAE,OAAO,SAAS,CAAC;YAElC,qBAAqB;YACrB,MAAM,QAAQ,GAAuB,aAAa,CAAC,IAAI,CAAC;YACxD,IAAI,CAAC,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAChC,qCAAqC;YAErC,IAAI,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBAC5C,IAAI,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACrC,OAAO,SAAS,CAAC,CAAC,gBAAgB;gBACpC,CAAC;gBAED,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAEjC,oCAAoC;gBACpC,UAAU,CAAC,GAAG,EAAE;oBACd,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACtC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YAChB,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACpD,cAAc,CAAC,MAAM,CAAC,CAAC;YACvB,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,CAAC;QAED,0BAA0B;QAC1B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,kGAAkG;QAE9H,IAAI,CAAC,aAAa,IAAI,OAAO,EAAE,CAAC;YAC9B,qBAAqB;YACrB,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;YACzB,IAAI,IAAI,EAAE,CAAC;gBACT,gHAAgH;gBAChH,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,UAAU;oBAAE,OAAO,SAAS,CAAC;gBAElC,6BAA6B;gBAC7B,MAAM,YAAY,GAAW,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;gBAEhD,aAAa,CAAC,YAAY,CAAC,CAAC;gBAE5B,OAAO,EAAE,IAAI,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,OAAO,sBAAW,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;CACF;AAED,kBAAe,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skroz/telegram-bot",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "license": "MIT",
   "repository": "git@gitlab.com:skroz/libs/utils.git",
   "main": "dist/index.js",
@@ -21,5 +21,5 @@
   "dependencies": {
     "@skroz/telegram-api": "^1.0.10"
   },
-  "gitHead": "8c295f6b494f0fed2e05f97c444d8ae0f16a06c0"
+  "gitHead": "e88af73cb8dbea50c6ab195afd7b77b74ef585da"
 }

package/src/index.ts

@@ -1,12 +1,29 @@
 import TelegramApi from '@skroz/telegram-api';
-import { TG_Update, TG_User } from '@skroz/telegram-api/dist/TelegramTypes';
+import {
+  TG_CallbackQuery,
+  TG_Message,
+  TG_SendMessageResponse,
+  TG_SendPhotoInput,
+  TG_Update,
+} from '@skroz/telegram-api/dist/TelegramTypes';
+
+/* eslint-disable @typescript-eslint/naming-convention */
 
 /* хранит уникальные колбэки, чтобы исключить повторное нажатие */
 const processedCallbacks = new Set();
-/* разделитель для отслеживания повторных колбэков */
-const uniqueCallbackFilter = '&&';
 /* разделитель для параметров колбэка */
-const callbackParamDivider = ':^:^:';
+const callbackDivider = '^:^:^';
+
+/* не больше 64 символов по документации, внутри защита от повторных кликов */
+export const createCallbackData = (
+  telegramId: number | string,
+  data: string[]
+): string =>
+  [`${Date.now()}_${telegramId}`, ...data].join(callbackDivider).slice(0, 64);
+
+/* не больше 64 символов по документации, внутри защита от повторных кликов */
+export const getCallbackData = (data: string): string[] =>
+  data.split(callbackDivider);
 
 class TelegramBot {
   constructor(private readonly botToken: string) {}
@@ -17,62 +34,90 @@ class TelegramBot {
 
   async handleUpdate(
     update: TG_Update,
-    handleCallback: (callbackParams: string[]) => void,
-    handleMessage: (incomingText: string) => void
-  ): Promise<{ from: TG_User } | undefined> {
+    handleCallback: (
+      callbackQuery: TG_CallbackQuery,
+      callbackDataParams: string[]
+    ) => Promise<void>,
+    handleMessage: (message: TG_Message) => void
+  ): Promise<void> {
     const callbackQuery = update.callback_query;
     if (callbackQuery) {
-      /* Обработаем этот callback */
-      /* Получаем Телеграм Юзера = from: TG_User */
-      const { from } = callbackQuery;
-      // В этом случае callbackQuery.message - это сообщение. На нём была кнопка, которую нажали
-      const telegramId = from.id;
-      if (!telegramId) return undefined;
-
-      /* Найдем Callback */
-      const callback: string | undefined = callbackQuery.data;
-      if (!callback) return undefined;
-      // const { message } = callbackQuery;
-
-      if (callback.includes(uniqueCallbackFilter)) {
-        if (processedCallbacks.has(callback)) {
-          return undefined; // Уже обработан
-        }
-
-        processedCallbacks.add(callback);
-
-        // Удаляем из памяти через 60 секунд
-        setTimeout(() => {
-          processedCallbacks.delete(callback);
-        }, 60 * 1000);
+      const { data } = callbackQuery;
+
+      if (!data) {
+        // 1. Коллбэк пришел от WebApp
+        // 2. Игровая кнопка
+        // 3. Кнопка с удаленным сообщением
+        return; // todo sendError
       }
 
-      const params = callback.split(callbackParamDivider);
-      handleCallback(params);
-      return { from };
-    }
+      // data - всегда уникален, потому что в начале стоит текущий Date.now()
+      if (processedCallbacks.has(data)) {
+        // чтобы избежать дублирования нажатия на кнопку
+        return; // Уже обработан
+      }
+      processedCallbacks.add(data);
 
+      // Удаляем из памяти через 60 секунд
+      setTimeout(() => {
+        processedCallbacks.delete(data);
+      }, 60 * 1000);
+
+      await handleCallback(callbackQuery, getCallbackData(data));
+    }
     /* обработаем сообщение */
     const { message } = update; // его нет, если это нажатие на кнопку callback_query или при редактировании предыдущего сообщения
 
     if (!callbackQuery && message) {
-      /* точно не кнопка */
-      const { from } = message;
-      if (from) {
-        /* Есть пользователь, значит это сообщение от пользователя, либо сообщения боту, либо в группе, либо в канале */
-        const telegramId = from.id;
-        if (!telegramId) return undefined;
-
-        /* Есть сообщение для бота */
-        const incomingText: string = message.text ?? '';
-
-        handleMessage(incomingText);
+      /* разбираем входящий текст */
+      await handleMessage(message);
+    }
+  }
 
-        return { from };
+  async sendPhoto(
+    input: TG_SendPhotoInput,
+    message?: TG_Message
+  ): Promise<TG_SendMessageResponse> {
+    const { chat_id, reply_markup, caption, photo } = input;
+
+    let sendResult: TG_SendMessageResponse;
+
+    const sendPhotoFunction = () =>
+      TelegramApi.sendPhoto(
+        {
+          chat_id,
+          caption,
+          photo,
+          parse_mode: 'HTML',
+          reply_markup,
+        },
+        this.botToken
+      );
+
+    if (message) {
+      try {
+        sendResult = await TelegramApi.editMessageMedia(
+          {
+            media: {
+              type: 'photo',
+              media: photo as string,
+              caption,
+              parse_mode: 'HTML',
+            },
+            message_id: message.message_id,
+            reply_markup,
+            chat_id,
+          },
+          this.botToken
+        );
+      } catch (e) {
+        sendResult = await sendPhotoFunction();
       }
+    } else {
+      sendResult = await sendPhotoFunction();
     }
 
-    return undefined;
+    return sendResult;
   }
 
   async deleteWebhook() {