@waiaas/daemon 2.0.0-rc.1

package/dist/infrastructure/telegram/telegram-api.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Telegram Bot API fetch wrapper (Node.js 22 built-in fetch, no external libraries).
+ *
+ * Provides getUpdates (Long Polling), sendMessage (MarkdownV2), and answerCallbackQuery.
+ * AbortSignal.timeout used for request timeout control.
+ */
+import type { TelegramUpdate, TelegramInlineKeyboardMarkup } from './telegram-types.js';
+export declare class TelegramApi {
+    private baseUrl;
+    constructor(botToken: string);
+    /**
+     * Long-poll for updates from Telegram Bot API.
+     *
+     * @param offset - Update offset (last update_id + 1)
+     * @param timeout - Long-poll timeout in seconds (server-side wait)
+     * @returns Array of updates (empty if no new updates)
+     */
+    getUpdates(offset: number, timeout: number): Promise<TelegramUpdate[]>;
+    /**
+     * Send a text message to a chat.
+     *
+     * @param chatId - Target chat ID
+     * @param text - Message text (MarkdownV2 formatted)
+     * @param replyMarkup - Optional inline keyboard markup
+     */
+    sendMessage(chatId: number, text: string, replyMarkup?: TelegramInlineKeyboardMarkup): Promise<void>;
+    /**
+     * Answer a callback query (acknowledge button press).
+     *
+     * @param callbackQueryId - Callback query ID from the update
+     * @param text - Optional notification text shown to user
+     */
+    answerCallbackQuery(callbackQueryId: string, text?: string): Promise<void>;
+}
+//# sourceMappingURL=telegram-api.d.ts.map

package/dist/infrastructure/telegram/telegram-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-api.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/telegram/telegram-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,MAAM;IAI5B;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAkB5E;;;;;;OAMG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,4BAA4B,GACzC,OAAO,CAAC,IAAI,CAAC;IAmBhB;;;;;OAKG;IACG,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUjF"}

package/dist/infrastructure/telegram/telegram-api.js

@@ -0,0 +1,82 @@
+/**
+ * Telegram Bot API fetch wrapper (Node.js 22 built-in fetch, no external libraries).
+ *
+ * Provides getUpdates (Long Polling), sendMessage (MarkdownV2), and answerCallbackQuery.
+ * AbortSignal.timeout used for request timeout control.
+ */
+export class TelegramApi {
+    baseUrl;
+    constructor(botToken) {
+        this.baseUrl = `https://api.telegram.org/bot${botToken}`;
+    }
+    /**
+     * Long-poll for updates from Telegram Bot API.
+     *
+     * @param offset - Update offset (last update_id + 1)
+     * @param timeout - Long-poll timeout in seconds (server-side wait)
+     * @returns Array of updates (empty if no new updates)
+     */
+    async getUpdates(offset, timeout) {
+        const url = `${this.baseUrl}/getUpdates`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                offset,
+                timeout,
+                allowed_updates: ['message', 'callback_query'],
+            }),
+            signal: AbortSignal.timeout((timeout + 5) * 1000),
+        });
+        if (!res.ok)
+            throw new Error(`Telegram API error: ${res.status}`);
+        const data = (await res.json());
+        if (!data.ok)
+            throw new Error('Telegram API returned ok=false');
+        return data.result;
+    }
+    /**
+     * Send a text message to a chat.
+     *
+     * @param chatId - Target chat ID
+     * @param text - Message text (MarkdownV2 formatted)
+     * @param replyMarkup - Optional inline keyboard markup
+     */
+    async sendMessage(chatId, text, replyMarkup) {
+        const url = `${this.baseUrl}/sendMessage`;
+        const body = {
+            chat_id: chatId,
+            text,
+            parse_mode: 'MarkdownV2',
+        };
+        if (replyMarkup)
+            body.reply_markup = replyMarkup;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const b = await res.text();
+            throw new Error(`sendMessage failed: ${res.status} ${b}`);
+        }
+    }
+    /**
+     * Answer a callback query (acknowledge button press).
+     *
+     * @param callbackQueryId - Callback query ID from the update
+     * @param text - Optional notification text shown to user
+     */
+    async answerCallbackQuery(callbackQueryId, text) {
+        const url = `${this.baseUrl}/answerCallbackQuery`;
+        const body = { callback_query_id: callbackQueryId };
+        if (text)
+            body.text = text;
+        await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+    }
+}
+//# sourceMappingURL=telegram-api.js.map

package/dist/infrastructure/telegram/telegram-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-api.js","sourceRoot":"","sources":["../../../src/infrastructure/telegram/telegram-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,OAAO,WAAW;IACd,OAAO,CAAS;IAExB,YAAY,QAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,+BAA+B,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,OAAe;QAC9C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,aAAa,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,MAAM;gBACN,OAAO;gBACP,eAAe,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC;aAC/C,CAAC;YACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;SAClD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA8C,CAAC;QAC7E,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,IAAY,EACZ,WAA0C;QAE1C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,cAAc,CAAC;QAC1C,MAAM,IAAI,GAA4B;YACpC,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,UAAU,EAAE,YAAY;SACzB,CAAC;QACF,IAAI,WAAW;YAAE,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QACjD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CAAC,eAAuB,EAAE,IAAa;QAC9D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,sBAAsB,CAAC;QAClD,MAAM,IAAI,GAA4B,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;QAC7E,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAC3B,MAAM,KAAK,CAAC,GAAG,EAAE;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/infrastructure/telegram/telegram-auth.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Telegram Bot 2-Tier Authorization module.
+ *
+ * Enforces role-based access control for Telegram Bot commands:
+ *   - PUBLIC: /start, /help (anyone, even unregistered)
+ *   - READONLY: /status, /wallets (READONLY + ADMIN roles)
+ *   - ADMIN: /pending, /approve, /reject, /killswitch, /newsession (ADMIN only)
+ *
+ * Roles: PENDING (awaiting admin approval), READONLY, ADMIN.
+ *
+ * Uses better-sqlite3 directly (same pattern as KillSwitchService).
+ *
+ * @see packages/daemon/src/services/kill-switch-service.ts (SQLite direct pattern)
+ */
+import type { Database } from 'better-sqlite3';
+import type { TelegramUserRole } from './telegram-types.js';
+export declare const PUBLIC_COMMANDS: readonly ["/start", "/help"];
+export declare const READONLY_COMMANDS: readonly ["/status", "/wallets"];
+export declare const ADMIN_COMMANDS: readonly ["/pending", "/approve", "/reject", "/killswitch", "/newsession"];
+export declare class TelegramAuth {
+    private sqlite;
+    constructor(sqlite: Database);
+    /**
+     * Look up the role for a given chat_id.
+     * Returns null if the user is not registered.
+     */
+    getRole(chatId: number): TelegramUserRole | null;
+    /**
+     * Check whether a chat_id is allowed to execute the given command.
+     *
+     * @returns `{ allowed: true }` or `{ allowed: false, reason }`.
+     *   Possible reasons: 'not_registered', 'pending_approval', 'admin_only'.
+     */
+    checkPermission(chatId: number, command: string): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * Update a user's role (called from Admin API).
+     * Sets approved_at timestamp when changing from PENDING.
+     *
+     * @returns true if a row was updated, false if chatId not found.
+     */
+    updateRole(chatId: number, newRole: 'ADMIN' | 'READONLY'): boolean;
+    /**
+     * List all registered Telegram users (for Admin API).
+     * Ordered by registration time descending (newest first).
+     */
+    listUsers(): Array<{
+        chat_id: number;
+        username: string | null;
+        role: string;
+        registered_at: number;
+        approved_at: number | null;
+    }>;
+}
+//# sourceMappingURL=telegram-auth.d.ts.map

package/dist/infrastructure/telegram/telegram-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-auth.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/telegram/telegram-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,eAAO,MAAM,eAAe,8BAA+B,CAAC;AAC5D,eAAO,MAAM,iBAAiB,kCAAmC,CAAC;AAClE,eAAO,MAAM,cAAc,4EAA6E,CAAC;AAMzG,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAEpC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAOhD;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAsBvF;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO;IAQlE;;;OAGG;IACH,SAAS,IAAI,KAAK,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;CAaH"}

package/dist/infrastructure/telegram/telegram-auth.js

@@ -0,0 +1,88 @@
+/**
+ * Telegram Bot 2-Tier Authorization module.
+ *
+ * Enforces role-based access control for Telegram Bot commands:
+ *   - PUBLIC: /start, /help (anyone, even unregistered)
+ *   - READONLY: /status, /wallets (READONLY + ADMIN roles)
+ *   - ADMIN: /pending, /approve, /reject, /killswitch, /newsession (ADMIN only)
+ *
+ * Roles: PENDING (awaiting admin approval), READONLY, ADMIN.
+ *
+ * Uses better-sqlite3 directly (same pattern as KillSwitchService).
+ *
+ * @see packages/daemon/src/services/kill-switch-service.ts (SQLite direct pattern)
+ */
+// ---------------------------------------------------------------------------
+// Command permission tiers
+// ---------------------------------------------------------------------------
+export const PUBLIC_COMMANDS = ['/start', '/help'];
+export const READONLY_COMMANDS = ['/status', '/wallets'];
+export const ADMIN_COMMANDS = ['/pending', '/approve', '/reject', '/killswitch', '/newsession'];
+// ---------------------------------------------------------------------------
+// TelegramAuth
+// ---------------------------------------------------------------------------
+export class TelegramAuth {
+    sqlite;
+    constructor(sqlite) {
+        this.sqlite = sqlite;
+    }
+    /**
+     * Look up the role for a given chat_id.
+     * Returns null if the user is not registered.
+     */
+    getRole(chatId) {
+        const row = this.sqlite
+            .prepare('SELECT role FROM telegram_users WHERE chat_id = ?')
+            .get(chatId);
+        return row?.role ?? null;
+    }
+    /**
+     * Check whether a chat_id is allowed to execute the given command.
+     *
+     * @returns `{ allowed: true }` or `{ allowed: false, reason }`.
+     *   Possible reasons: 'not_registered', 'pending_approval', 'admin_only'.
+     */
+    checkPermission(chatId, command) {
+        // PUBLIC commands: anyone (even unregistered) can execute
+        if (PUBLIC_COMMANDS.includes(command)) {
+            return { allowed: true };
+        }
+        const role = this.getRole(chatId);
+        if (!role)
+            return { allowed: false, reason: 'not_registered' };
+        if (role === 'PENDING')
+            return { allowed: false, reason: 'pending_approval' };
+        // READONLY: /status, /wallets only
+        if (role === 'READONLY') {
+            if (READONLY_COMMANDS.includes(command)) {
+                return { allowed: true };
+            }
+            return { allowed: false, reason: 'admin_only' };
+        }
+        // ADMIN: all commands allowed
+        return { allowed: true };
+    }
+    /**
+     * Update a user's role (called from Admin API).
+     * Sets approved_at timestamp when changing from PENDING.
+     *
+     * @returns true if a row was updated, false if chatId not found.
+     */
+    updateRole(chatId, newRole) {
+        const now = Math.floor(Date.now() / 1000);
+        const result = this.sqlite
+            .prepare('UPDATE telegram_users SET role = ?, approved_at = ? WHERE chat_id = ?')
+            .run(newRole, now, chatId);
+        return result.changes > 0;
+    }
+    /**
+     * List all registered Telegram users (for Admin API).
+     * Ordered by registration time descending (newest first).
+     */
+    listUsers() {
+        return this.sqlite
+            .prepare('SELECT chat_id, username, role, registered_at, approved_at FROM telegram_users ORDER BY registered_at DESC')
+            .all();
+    }
+}
+//# sourceMappingURL=telegram-auth.js.map

package/dist/infrastructure/telegram/telegram-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-auth.js","sourceRoot":"","sources":["../../../src/infrastructure/telegram/telegram-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAC;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,UAAU,CAAU,CAAC;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,CAAU,CAAC;AAEzG,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,MAAgB;QAAhB,WAAM,GAAN,MAAM,CAAU;IAAG,CAAC;IAExC;;;OAGG;IACH,OAAO,CAAC,MAAc;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM;aACpB,OAAO,CAAC,mDAAmD,CAAC;aAC5D,GAAG,CAAC,MAAM,CAAiC,CAAC;QAC/C,OAAQ,GAAG,EAAE,IAAyB,IAAI,IAAI,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,MAAc,EAAE,OAAe;QAC7C,0DAA0D;QAC1D,IAAK,eAAqC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QAC/D,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAE9E,mCAAmC;QACnC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,IAAK,iBAAuC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC3B,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAClD,CAAC;QAED,8BAA8B;QAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,MAAc,EAAE,OAA6B;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;aACvB,OAAO,CAAC,uEAAuE,CAAC;aAChF,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,SAAS;QAOP,OAAO,IAAI,CAAC,MAAM;aACf,OAAO,CACN,4GAA4G,CAC7G;aACA,GAAG,EAMJ,CAAC;IACL,CAAC;CACF"}

package/dist/infrastructure/telegram/telegram-bot-service.d.ts

@@ -0,0 +1,95 @@
+/**
+ * TelegramBotService: Long Polling bot with 2-Tier auth + 9 commands.
+ *
+ * Uses better-sqlite3 directly for DB access (same pattern as KillSwitchService).
+ * Long Polling with exponential backoff (1s -> 2s -> 4s -> ... -> 30s max).
+ * MarkdownV2 escape for all user-facing text.
+ *
+ * Commands:
+ *   /start      - Register chat_id as PENDING user             (public)
+ *   /help       - Show available commands                        (public)
+ *   /status     - Show daemon status, wallet count, session count (readonly+)
+ *   /wallets    - List all wallets                               (readonly+)
+ *   /pending    - List pending approval transactions             (admin)
+ *   /approve    - Approve a pending transaction                  (admin)
+ *   /reject     - Reject a pending transaction                   (admin)
+ *   /killswitch - Activate kill switch with confirmation          (admin)
+ *   /newsession - Create a new session for a wallet              (admin)
+ *
+ * Auth: TelegramAuth 2-Tier (PUBLIC / READONLY / ADMIN)
+ * Callback queries: inline keyboard buttons for approve/reject/killswitch/newsession
+ *
+ * @see packages/daemon/src/services/kill-switch-service.ts (SQLite direct pattern)
+ * @see packages/daemon/src/services/autostop-service.ts (service start/stop pattern)
+ */
+import type { Database } from 'better-sqlite3';
+import type { SupportedLocale } from '@waiaas/core';
+import type { TelegramApi } from './telegram-api.js';
+import type { KillSwitchService } from '../../services/kill-switch-service.js';
+import type { NotificationService } from '../../notifications/notification-service.js';
+import type { SettingsService } from '../settings/settings-service.js';
+import type { JwtSecretManager } from '../jwt/index.js';
+/**
+ * Escape special characters for Telegram MarkdownV2 parse mode.
+ * @see https://core.telegram.org/bots/api#markdownv2-style
+ */
+export declare const escapeMarkdownV2: (s: string) => string;
+export interface TelegramBotServiceOptions {
+    sqlite: Database;
+    api: TelegramApi;
+    locale?: SupportedLocale;
+    killSwitchService?: KillSwitchService;
+    notificationService?: NotificationService;
+    settingsService?: SettingsService;
+    jwtSecretManager?: JwtSecretManager;
+    sessionTtl?: number;
+}
+export declare class TelegramBotService {
+    private sqlite;
+    private api;
+    private locale;
+    private killSwitchService?;
+    private jwtSecretManager?;
+    private sessionTtl;
+    private auth;
+    private running;
+    private offset;
+    private backoffMs;
+    private retryCount;
+    private static readonly MAX_BACKOFF_MS;
+    private static readonly POLL_TIMEOUT_SEC;
+    constructor(opts: TelegramBotServiceOptions);
+    /**
+     * Start the Long Polling loop (fire-and-forget, runs in background).
+     * Does NOT block -- returns immediately after starting the async loop.
+     */
+    start(): void;
+    /**
+     * Stop the Long Polling loop. The loop exits on next iteration.
+     */
+    stop(): void;
+    /** Whether the bot service is currently running. */
+    get isRunning(): boolean;
+    /** Current backoff interval in ms (for testing). */
+    get currentBackoffMs(): number;
+    /** Current consecutive failure count (for testing). */
+    get consecutiveFailures(): number;
+    private pollLoop;
+    private handleUpdate;
+    private handleMessage;
+    private handleCallbackQuery;
+    private handleStart;
+    private handleHelp;
+    private handleStatus;
+    private handleWallets;
+    private handlePending;
+    private handleApprove;
+    private handleReject;
+    private handleKillswitch;
+    private executeKillswitchConfirm;
+    private handleNewSession;
+    private executeNewSession;
+    private formatUptime;
+    private sleep;
+}
+//# sourceMappingURL=telegram-bot-service.d.ts.map

package/dist/infrastructure/telegram/telegram-bot-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-bot-service.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/telegram/telegram-bot-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,iBAAiB,CAAC;AAQpE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,GAAG,MAAM,KAAG,MACK,CAAC;AAMnD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAU;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAM;gBAElC,IAAI,EAAE,yBAAyB;IAU3C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ,oDAAoD;IACpD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,oDAAoD;IACpD,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,uDAAuD;IACvD,IAAI,mBAAmB,IAAI,MAAM,CAEhC;YAMa,QAAQ;YA8CR,YAAY;YAUZ,aAAa;YAqEb,mBAAmB;YA0EnB,WAAW;YAqBX,UAAU;YAKV,YAAY;YAgDZ,aAAa;YAiCb,aAAa;YAoDb,aAAa;YAmDb,YAAY;YAmDZ,gBAAgB;YAwBhB,wBAAwB;YA0BxB,gBAAgB;YAqBhB,iBAAiB;IAoE/B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,KAAK;CAGd"}