onbuzz 4.9.13 → 4.10.0

package/src/services/telegrafBot.js

@@ -1,174 +1,174 @@
-/**
- * telegrafBot — node-telegram-bot-api-compatible wrapper around `telegraf`.
- *
- * Why this layer exists:
- *
- *   We migrated off `node-telegram-bot-api` because it kept the deprecated
- *   `request` / `form-data` / `@cypress/request` chain alive (9 CVEs incl.
- *   2 critical, no upstream fix). `telegraf` is the modern Telegram Bot
- *   API library with no deprecated transitive deps.
- *
- *   But `telegramService.js` is ~1900 LOC built against the
- *   node-telegram-bot-api surface (`bot.sendMessage(chatId, text, opts)`,
- *   `bot.editMessageText(text, opts)`, `bot.onText(regex, handler)`,
- *   `bot.on('message', handler)`, etc.). Rewriting every call site to
- *   telegraf's middleware/Context paradigm would be a 1900-line diff
- *   touching every handler. Insted, this thin wrapper presents the
- *   familiar surface on top of telegraf so the service code is
- *   unchanged.
- *
- *   The wrapper also keeps the test seam stable — the existing MockBot
- *   in __tests__/telegramService.test.js implements exactly this
- *   surface, so the test file's mock just retargets to this module.
- *
- * What it preserves:
- *
- *   - `bot.getMe()`            → telegraf `bot.telegram.getMe()`
- *   - `bot.stopPolling()`      → telegraf `bot.stop()`
- *   - `bot.sendMessage()`      → `bot.telegram.sendMessage()`
- *   - `bot.editMessageText()`  → flat → positional adapter (see below)
- *   - `bot.deleteMessage()`    → `bot.telegram.deleteMessage()`
- *   - `bot.sendChatAction()`   → `bot.telegram.sendChatAction()`
- *   - `bot.sendDocument()`     → buffer → `{ source, filename }`
- *   - `bot.sendPhoto()`        → buffer → `{ source, filename }`
- *   - `bot.answerCallbackQuery(id, opts)` → `answerCbQuery(id, text, opts)`
- *   - `bot.getFileLink()`      → string (telegraf returns URL object)
- *   - `bot.onText(regex, fn)`  → `bot.hears(regex, ctx⇒fn(ctx.message, ctx.match))`
- *   - `bot.on('message', fn)`  → `bot.on('message', ctx⇒fn(ctx.message))`
- *   - `bot.on('callback_query', fn)` → likewise with ctx.callbackQuery
- *
- * Signature drift worth flagging:
- *
- *   node-telegram-bot-api editMessageText: (text, { chat_id, message_id, ... })
- *   telegraf  editMessageText:             (chat_id, message_id, inline_id, text, extra)
- *   The wrapper unpacks the options bag and routes appropriately.
- */
-
-export async function createTelegrafBot(token, options = {}) {
-  const { Telegraf } = await import('telegraf');
-
-  const tgraf = new Telegraf(token);
-  const tg = tgraf.telegram;
-
-  // Telegraf handlers throw errors back into the polling loop and stop the
-  // bot by default. node-telegram-bot-api was much more forgiving — it
-  // logged and kept polling. Match that: catch+log so a single bad
-  // handler doesn't take the bot down.
-  tgraf.catch((err, ctx) => {
-    // eslint-disable-next-line no-console
-    console.warn('[telegrafBot] handler error:', err?.message || err, 'updateType:', ctx?.updateType);
-  });
-
-  // Track whether `launch()` has been called — repeated launches throw in
-  // telegraf, and we want stopPolling() to be a safe no-op when not
-  // launched yet.
-  let launched = false;
-
-  const wrapper = {
-    // ─── Internal access for advanced use / tests ──────────────────────
-    _tgraf: tgraf,
-    _tg: tg,
-
-    // ─── Lifecycle ─────────────────────────────────────────────────────
-    async getMe() {
-      return tg.getMe();
-    },
-
-    async stopPolling() {
-      if (!launched) return;
-      try { tgraf.stop(); } catch { /* idempotent */ }
-      launched = false;
-    },
-
-    // ─── Senders ───────────────────────────────────────────────────────
-    async sendMessage(chatId, text, opts = {}) {
-      return tg.sendMessage(chatId, text, opts);
-    },
-
-    async editMessageText(text, opts = {}) {
-      // node-telegram-bot-api's signature is a flat options bag. Telegraf's
-      // is positional. Unpack and route.
-      const { chat_id, message_id, inline_message_id, ...extra } = opts;
-      return tg.editMessageText(chat_id, message_id, inline_message_id, text, extra);
-    },
-
-    async deleteMessage(chatId, messageId) {
-      return tg.deleteMessage(chatId, messageId);
-    },
-
-    async sendChatAction(chatId, action) {
-      return tg.sendChatAction(chatId, action);
-    },
-
-    async sendPhoto(chatId, photo, opts = {}, fileOpts = {}) {
-      // node-telegram-bot-api accepts a Buffer with an optional fileOpts.filename.
-      // Telegraf wants { source: buffer, filename } for buffers.
-      if (Buffer.isBuffer(photo)) {
-        return tg.sendPhoto(chatId, { source: photo, filename: fileOpts.filename }, opts);
-      }
-      return tg.sendPhoto(chatId, photo, opts);
-    },
-
-    async sendDocument(chatId, doc, opts = {}, fileOpts = {}) {
-      if (Buffer.isBuffer(doc)) {
-        return tg.sendDocument(chatId, { source: doc, filename: fileOpts.filename }, opts);
-      }
-      return tg.sendDocument(chatId, doc, opts);
-    },
-
-    async answerCallbackQuery(queryId, opts = {}) {
-      // node-telegram-bot-api: (queryId, { text, show_alert, url, cache_time })
-      // telegraf:               answerCbQuery(queryId, text, extra)
-      const { text, ...extra } = opts || {};
-      return tg.answerCbQuery(queryId, text, extra);
-    },
-
-    async getFileLink(fileId) {
-      // Telegraf returns a URL object; node-telegram-bot-api returned a
-      // plain string. Coerce.
-      const url = await tg.getFileLink(fileId);
-      return typeof url === 'string' ? url : url.toString();
-    },
-
-    // ─── Event subscription ────────────────────────────────────────────
-    onText(regex, handler) {
-      // node-telegram-bot-api fires every matching handler in turn and
-      // passes (msg, regexMatch). Telegraf's `hears` does likewise via
-      // ctx.match.
-      tgraf.hears(regex, async (ctx) => {
-        await handler(ctx.message, ctx.match);
-      });
-    },
-
-    on(event, handler) {
-      if (event === 'message') {
-        tgraf.on('message', async (ctx) => { await handler(ctx.message); });
-        return;
-      }
-      if (event === 'callback_query') {
-        tgraf.on('callback_query', async (ctx) => { await handler(ctx.callbackQuery); });
-        return;
-      }
-      // Forward anything else verbatim — caller is on their own to handle
-      // the ctx vs raw-msg shape difference.
-      tgraf.on(event, async (ctx) => { await handler(ctx.update); });
-    },
-  };
-
-  // Telegraf's launch() is the equivalent of node-telegram-bot-api's
-  // `{ polling: true }` constructor option. It returns a promise that
-  // resolves only when the bot stops — we must NOT await it here or the
-  // wrapper-creation never returns. Fire-and-forget; surface errors via
-  // the central .catch above.
-  if (options.polling !== false) {
-    tgraf.launch().catch((err) => {
-      // eslint-disable-next-line no-console
-      console.warn('[telegrafBot] launch failed:', err?.message || err);
-    });
-    launched = true;
-  }
-
-  return wrapper;
-}
-
-export default createTelegrafBot;
+/**
+ * telegrafBot — node-telegram-bot-api-compatible wrapper around `telegraf`.
+ *
+ * Why this layer exists:
+ *
+ *   We migrated off `node-telegram-bot-api` because it kept the deprecated
+ *   `request` / `form-data` / `@cypress/request` chain alive (9 CVEs incl.
+ *   2 critical, no upstream fix). `telegraf` is the modern Telegram Bot
+ *   API library with no deprecated transitive deps.
+ *
+ *   But `telegramService.js` is ~1900 LOC built against the
+ *   node-telegram-bot-api surface (`bot.sendMessage(chatId, text, opts)`,
+ *   `bot.editMessageText(text, opts)`, `bot.onText(regex, handler)`,
+ *   `bot.on('message', handler)`, etc.). Rewriting every call site to
+ *   telegraf's middleware/Context paradigm would be a 1900-line diff
+ *   touching every handler. Insted, this thin wrapper presents the
+ *   familiar surface on top of telegraf so the service code is
+ *   unchanged.
+ *
+ *   The wrapper also keeps the test seam stable — the existing MockBot
+ *   in __tests__/telegramService.test.js implements exactly this
+ *   surface, so the test file's mock just retargets to this module.
+ *
+ * What it preserves:
+ *
+ *   - `bot.getMe()`            → telegraf `bot.telegram.getMe()`
+ *   - `bot.stopPolling()`      → telegraf `bot.stop()`
+ *   - `bot.sendMessage()`      → `bot.telegram.sendMessage()`
+ *   - `bot.editMessageText()`  → flat → positional adapter (see below)
+ *   - `bot.deleteMessage()`    → `bot.telegram.deleteMessage()`
+ *   - `bot.sendChatAction()`   → `bot.telegram.sendChatAction()`
+ *   - `bot.sendDocument()`     → buffer → `{ source, filename }`
+ *   - `bot.sendPhoto()`        → buffer → `{ source, filename }`
+ *   - `bot.answerCallbackQuery(id, opts)` → `answerCbQuery(id, text, opts)`
+ *   - `bot.getFileLink()`      → string (telegraf returns URL object)
+ *   - `bot.onText(regex, fn)`  → `bot.hears(regex, ctx⇒fn(ctx.message, ctx.match))`
+ *   - `bot.on('message', fn)`  → `bot.on('message', ctx⇒fn(ctx.message))`
+ *   - `bot.on('callback_query', fn)` → likewise with ctx.callbackQuery
+ *
+ * Signature drift worth flagging:
+ *
+ *   node-telegram-bot-api editMessageText: (text, { chat_id, message_id, ... })
+ *   telegraf  editMessageText:             (chat_id, message_id, inline_id, text, extra)
+ *   The wrapper unpacks the options bag and routes appropriately.
+ */
+
+export async function createTelegrafBot(token, options = {}) {
+  const { Telegraf } = await import('telegraf');
+
+  const tgraf = new Telegraf(token);
+  const tg = tgraf.telegram;
+
+  // Telegraf handlers throw errors back into the polling loop and stop the
+  // bot by default. node-telegram-bot-api was much more forgiving — it
+  // logged and kept polling. Match that: catch+log so a single bad
+  // handler doesn't take the bot down.
+  tgraf.catch((err, ctx) => {
+     
+    console.warn('[telegrafBot] handler error:', err?.message || err, 'updateType:', ctx?.updateType);
+  });
+
+  // Track whether `launch()` has been called — repeated launches throw in
+  // telegraf, and we want stopPolling() to be a safe no-op when not
+  // launched yet.
+  let launched = false;
+
+  const wrapper = {
+    // ─── Internal access for advanced use / tests ──────────────────────
+    _tgraf: tgraf,
+    _tg: tg,
+
+    // ─── Lifecycle ─────────────────────────────────────────────────────
+    async getMe() {
+      return tg.getMe();
+    },
+
+    async stopPolling() {
+      if (!launched) return;
+      try { tgraf.stop(); } catch { /* idempotent */ }
+      launched = false;
+    },
+
+    // ─── Senders ───────────────────────────────────────────────────────
+    async sendMessage(chatId, text, opts = {}) {
+      return tg.sendMessage(chatId, text, opts);
+    },
+
+    async editMessageText(text, opts = {}) {
+      // node-telegram-bot-api's signature is a flat options bag. Telegraf's
+      // is positional. Unpack and route.
+      const { chat_id, message_id, inline_message_id, ...extra } = opts;
+      return tg.editMessageText(chat_id, message_id, inline_message_id, text, extra);
+    },
+
+    async deleteMessage(chatId, messageId) {
+      return tg.deleteMessage(chatId, messageId);
+    },
+
+    async sendChatAction(chatId, action) {
+      return tg.sendChatAction(chatId, action);
+    },
+
+    async sendPhoto(chatId, photo, opts = {}, fileOpts = {}) {
+      // node-telegram-bot-api accepts a Buffer with an optional fileOpts.filename.
+      // Telegraf wants { source: buffer, filename } for buffers.
+      if (Buffer.isBuffer(photo)) {
+        return tg.sendPhoto(chatId, { source: photo, filename: fileOpts.filename }, opts);
+      }
+      return tg.sendPhoto(chatId, photo, opts);
+    },
+
+    async sendDocument(chatId, doc, opts = {}, fileOpts = {}) {
+      if (Buffer.isBuffer(doc)) {
+        return tg.sendDocument(chatId, { source: doc, filename: fileOpts.filename }, opts);
+      }
+      return tg.sendDocument(chatId, doc, opts);
+    },
+
+    async answerCallbackQuery(queryId, opts = {}) {
+      // node-telegram-bot-api: (queryId, { text, show_alert, url, cache_time })
+      // telegraf:               answerCbQuery(queryId, text, extra)
+      const { text, ...extra } = opts || {};
+      return tg.answerCbQuery(queryId, text, extra);
+    },
+
+    async getFileLink(fileId) {
+      // Telegraf returns a URL object; node-telegram-bot-api returned a
+      // plain string. Coerce.
+      const url = await tg.getFileLink(fileId);
+      return typeof url === 'string' ? url : url.toString();
+    },
+
+    // ─── Event subscription ────────────────────────────────────────────
+    onText(regex, handler) {
+      // node-telegram-bot-api fires every matching handler in turn and
+      // passes (msg, regexMatch). Telegraf's `hears` does likewise via
+      // ctx.match.
+      tgraf.hears(regex, async (ctx) => {
+        await handler(ctx.message, ctx.match);
+      });
+    },
+
+    on(event, handler) {
+      if (event === 'message') {
+        tgraf.on('message', async (ctx) => { await handler(ctx.message); });
+        return;
+      }
+      if (event === 'callback_query') {
+        tgraf.on('callback_query', async (ctx) => { await handler(ctx.callbackQuery); });
+        return;
+      }
+      // Forward anything else verbatim — caller is on their own to handle
+      // the ctx vs raw-msg shape difference.
+      tgraf.on(event, async (ctx) => { await handler(ctx.update); });
+    },
+  };
+
+  // Telegraf's launch() is the equivalent of node-telegram-bot-api's
+  // `{ polling: true }` constructor option. It returns a promise that
+  // resolves only when the bot stops — we must NOT await it here or the
+  // wrapper-creation never returns. Fire-and-forget; surface errors via
+  // the central .catch above.
+  if (options.polling !== false) {
+    tgraf.launch().catch((err) => {
+       
+      console.warn('[telegrafBot] launch failed:', err?.message || err);
+    });
+    launched = true;
+  }
+
+  return wrapper;
+}
+
+export default createTelegrafBot;