katanakit-js 6.2.0 → 6.6.1

package/dist/adapters/telegram/telegram.service.js

@@ -3,27 +3,142 @@ import { useLogger } from "../../core/services/logger.service.js";
 import { useSleep } from "../../core/services/utils.service.js";
 /** Default Telegram Bot API base URL. */
 export const TELEGRAM_API_BASE = "https://api.telegram.org";
-/** Module-level bot configuration. */
-let config = null;
-/** Retrieves the configured bot or throws. */
-function getConfig() {
-    if (!config) {
-        throw new Error("[Telegram] Not configured. Call defineTelegramConfig() first.");
+/**
+ * TelegramService - Singleton para el bot de Telegram.
+ *
+ * Aplica el patrón Singleton: una única instancia centraliza la configuración,
+ * el envío de mensajes y el bucle de polling. La configuración se registra una
+ * sola vez y todas las operaciones comparten ese estado.
+ *
+ * @example
+ * ```ts
+ * TelegramService.getInstance().useInit({ token: process.env.TELEGRAM_BOT_TOKEN });
+ * await TelegramService.getInstance().useSendMessage(chatId, "Hello");
+ * ```
+ */
+export class TelegramService {
+    static instance;
+    /** Module-level bot configuration. */
+    config = null;
+    /**
+     * Constructor privado - enforce singleton.
+     */
+    constructor() { }
+    /**
+     * Obtiene la instancia única del TelegramService (Singleton).
+     *
+     * @returns La instancia única de {@link TelegramService}.
+     */
+    static getInstance() {
+        if (!TelegramService.instance) {
+            TelegramService.instance = new TelegramService();
+        }
+        return TelegramService.instance;
+    }
+    /** Retrieves the configured bot or throws. */
+    useGetConfig() {
+        if (!this.config) {
+            throw new Error("[Telegram] Not configured. Call defineTelegramConfig() first.");
+        }
+        return this.config;
+    }
+    /**
+     * Registers the Telegram bot configuration.
+     *
+     * @param cfg - Bot token (from BotFather) and optional API base URL.
+     *
+     * @example
+     * ```ts
+     * TelegramService.getInstance().useInit({ token: process.env.TELEGRAM_BOT_TOKEN });
+     * ```
+     */
+    useInit(cfg) {
+        this.config = { ...cfg };
+    }
+    /**
+     * Sends a text message to a Telegram chat.
+     *
+     * @param chatId - Destination chat id.
+     * @param text - Message body.
+     * @returns The Telegram API response.
+     */
+    async useSendMessage(chatId, text) {
+        const { token, apiBaseUrl } = this.useGetConfig();
+        return fetch(`${apiBaseUrl ?? TELEGRAM_API_BASE}/bot${token}/sendMessage`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ chat_id: chatId, text }),
+        });
+    }
+    /**
+     * Handles a single Telegram update: replies to inbound text messages.
+     *
+     * @param update - A Telegram update object (from `getUpdates` or a webhook).
+     * @param reply - Reply callback. Defaults to the assistant `useReply`.
+     *
+     * @example
+     * ```ts
+     * await TelegramService.getInstance().useHandleUpdate(update);
+     * ```
+     */
+    async useHandleUpdate(update, reply = useReply) {
+        const message = update?.message;
+        if (!message?.text || message.text.trim() === "")
+            return;
+        const sessionId = `telegram:${message.chat.id}`;
+        const result = await reply(sessionId, message.text);
+        if (result.ok) {
+            await this.useSendMessage(message.chat.id, result.data.reply);
+        }
+    }
+    /**
+     * Starts the long-polling loop that keeps fetching and answering updates.
+     * Runs until the provided signal aborts (or forever).
+     *
+     * @param options - Polling cadence, abort signal and reply callback.
+     *
+     * @example
+     * ```ts
+     * await TelegramService.getInstance().useStartPolling();
+     * ```
+     */
+    async useStartPolling(options = {}) {
+        const { intervalMs = 2000, signal, reply = useReply } = options;
+        const { token, apiBaseUrl } = this.useGetConfig();
+        const base = apiBaseUrl ?? TELEGRAM_API_BASE;
+        let offset = 0;
+        while (!signal?.aborted) {
+            try {
+                const response = await fetch(`${base}/bot${token}/getUpdates?timeout=30&offset=${offset}`, {
+                    signal,
+                });
+                if (!response.ok) {
+                    throw new Error(`getUpdates HTTP ${response.status}`);
+                }
+                const data = (await response.json());
+                for (const update of data.result ?? []) {
+                    offset = Math.max(offset, update.update_id + 1);
+                    await this.useHandleUpdate(update, reply);
+                }
+            }
+            catch (error) {
+                if (signal?.aborted)
+                    break;
+                const message = error instanceof Error ? error.message : String(error);
+                useLogger(`[Telegram] ${message}`, undefined, "error");
+            }
+            await useSleep(intervalMs);
+        }
     }
-    return config;
 }
 /**
- * Registers the Telegram bot configuration — the config-file entry point.
+ * Registers the Telegram bot configuration - the config-file entry point.
  *
  * One call is the whole setup: the literal is registered and handed back on
  * `config`, so `export default defineTelegramConfig({ … })` is enough.
  *
- * Config-only service: it accepts {@link TelegramConfig} and nothing else, so
- * declaring methods here is a compile error (use the API, Notion, WordPress or
- * InsForge `define*Config` when you need them).
- *
  * @param input - Bot token (from BotFather) and optional API base URL.
- * @returns The registered config as a {@link ConfigFacade}.
+ * @returns The registered config as a `ConfigFacade`.
  *
  * @example
  * ```ts
@@ -50,7 +165,7 @@ export function defineTelegramConfig(input) {
  * ```
  */
 export function useInitTelegram(cfg) {
-    config = { ...cfg };
+    TelegramService.getInstance().useInit(cfg);
 }
 /**
  * Sends a text message to a Telegram chat.
@@ -60,18 +175,13 @@ export function useInitTelegram(cfg) {
  * @returns The Telegram API response.
  */
 export async function useTelegramSendMessage(chatId, text) {
-    const { token, apiBaseUrl } = getConfig();
-    return fetch(`${apiBaseUrl ?? TELEGRAM_API_BASE}/bot${token}/sendMessage`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ chat_id: chatId, text }),
-    });
+    return TelegramService.getInstance().useSendMessage(chatId, text);
 }
 /**
  * Handles a single Telegram update: replies to inbound text messages.
  *
  * @param update - A Telegram update object (from `getUpdates` or a webhook).
- * @param reply - Reply callback. Defaults to the assistant {@link useReply}.
+ * @param reply - Reply callback. Defaults to the assistant `useReply`.
  *
  * @example
  * ```ts
@@ -79,14 +189,7 @@ export async function useTelegramSendMessage(chatId, text) {
  * ```
  */
 export async function useHandleTelegramUpdate(update, reply = useReply) {
-    const message = update?.message;
-    if (!message?.text || message.text.trim() === "")
-        return;
-    const sessionId = `telegram:${message.chat.id}`;
-    const result = await reply(sessionId, message.text);
-    if (result.ok) {
-        await useTelegramSendMessage(message.chat.id, result.data.reply);
-    }
+    return TelegramService.getInstance().useHandleUpdate(update, reply);
 }
 /**
  * Starts the long-polling loop that keeps fetching and answering updates.
@@ -100,31 +203,6 @@ export async function useHandleTelegramUpdate(update, reply = useReply) {
  * ```
  */
 export async function useStartTelegramPolling(options = {}) {
-    const { intervalMs = 2000, signal, reply = useReply } = options;
-    const { token, apiBaseUrl } = getConfig();
-    const base = apiBaseUrl ?? TELEGRAM_API_BASE;
-    let offset = 0;
-    while (!signal?.aborted) {
-        try {
-            const response = await fetch(`${base}/bot${token}/getUpdates?timeout=30&offset=${offset}`, {
-                signal,
-            });
-            if (!response.ok) {
-                throw new Error(`getUpdates HTTP ${response.status}`);
-            }
-            const data = (await response.json());
-            for (const update of data.result ?? []) {
-                offset = Math.max(offset, update.update_id + 1);
-                await useHandleTelegramUpdate(update, reply);
-            }
-        }
-        catch (error) {
-            if (signal?.aborted)
-                break;
-            const message = error instanceof Error ? error.message : String(error);
-            useLogger(`[Telegram] ${message}`, undefined, "error");
-        }
-        await useSleep(intervalMs);
-    }
+    return TelegramService.getInstance().useStartPolling(options);
 }
 //# sourceMappingURL=telegram.service.js.map

package/dist/adapters/telegram/telegram.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"telegram.service.js","sourceRoot":"","sources":["../../../src/adapters/telegram/telegram.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telegram.service.js","sourceRoot":"","sources":["../../../src/adapters/telegram/telegram.service.ts"],"names":[],"mappings":"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"}