@vvlad1973/telegram-bot-client 2.0.0 → 2.0.2

package/dist/agents/workers/WorkerClientFactory.js

@@ -5,9 +5,8 @@
  * @module agents/workers/WorkerClientFactory
  */
 'use strict';
-import { TelegramTransport } from '../../transport/TelegramTransport.js';
 import { TelegramBotClient } from '../../client/TelegramBotClient.js';
-import { TokensManager } from '../../transport/TokensManager.js';
+import { RouteMode } from '../../types/route.types.js';
 /**
  * Worker Client Factory
  * Creates and initializes transport and client for worker thread
@@ -18,22 +17,22 @@ export class WorkerClientFactory {
      */
     static createClient(config) {
         const { token, routeId, baseUrl, httpOptions } = config;
-        // Create tokens manager
-        const tokensManager = new TokensManager();
-        tokensManager.addToken(routeId, token);
-        tokensManager.setDefaultToken(routeId);
-        // Create transport
-        const transport = new TelegramTransport({
-            tokens: tokensManager,
+        // Create client with route configuration
+        const client = new TelegramBotClient({
+            routes: {
+                token,
+                mode: RouteMode.LongPolling
+            },
+            defaultRouteId: routeId,
+            apiUrl: baseUrl,
             httpClientOptions: {
-                baseUrl: baseUrl,
                 timeout: httpOptions?.timeout,
                 retries: httpOptions?.retries,
                 retryDelay: httpOptions?.retryDelay,
             },
         });
-        // Create client
-        const client = new TelegramBotClient({ transport });
+        // Access transport through client's private property
+        const transport = client.transport;
         return { transport, client };
     }
 }

package/dist/agents/workers/WorkerClientFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerClientFactory.js","sourceRoot":"","sources":["../../../src/agents/workers/WorkerClientFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,CAAC;AAEb,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAcjE;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAoB;QACtC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAExD,wBAAwB;QACxB,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QAC1C,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACvC,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEvC,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC;YACtC,MAAM,EAAE,aAAa;YACrB,iBAAiB,EAAE;gBACjB,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE,WAAW,EAAE,OAAO;gBAC7B,OAAO,EAAE,WAAW,EAAE,OAAO;gBAC7B,UAAU,EAAE,WAAW,EAAE,UAAU;aACpC;SACF,CAAC,CAAC;QAEH,gBAAgB;QAChB,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"WorkerClientFactory.js","sourceRoot":"","sources":["../../../src/agents/workers/WorkerClientFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,CAAC;AAGb,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAavD;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAoB;QACtC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAExD,yCAAyC;QACzC,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC;YACnC,MAAM,EAAE;gBACN,KAAK;gBACL,IAAI,EAAE,SAAS,CAAC,WAAW;aAC5B;YACD,cAAc,EAAE,OAAO;YACvB,MAAM,EAAE,OAAO;YACf,iBAAiB,EAAE;gBACjB,OAAO,EAAE,WAAW,EAAE,OAAO;gBAC7B,OAAO,EAAE,WAAW,EAAE,OAAO;gBAC7B,UAAU,EAAE,WAAW,EAAE,UAAU;aACpC;SACF,CAAC,CAAC;QAEH,qDAAqD;QACrD,MAAM,SAAS,GAAI,MAAsD,CAAC,SAAS,CAAC;QAEpF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/agents/workers/long-polling-worker-test.js

@@ -9,6 +9,7 @@ import { parentPort, workerData } from 'worker_threads';
 import { PollingLoop } from './PollingLoop.js';
 import { WorkerCommandHandler } from './WorkerCommandHandler.js';
 import { TelegramBotClient } from '../../client/TelegramBotClient.js';
+import { RouteMode } from '../../types/route.types.js';
 /**
  * Mock transport for testing
  */
@@ -49,7 +50,7 @@ const config = workerData.config;
 if (!config) {
     throw new Error('Worker config not provided in workerData');
 }
-const { routeId, timeout, limit, allowedUpdates, offset, mockUpdates } = config;
+const { timeout, limit, allowedUpdates, offset, mockUpdates } = config;
 /**
  * Send message to main thread
  */
@@ -60,12 +61,26 @@ function sendMessage(msg) {
  * Create mock transport and client
  * For testing, we create a client with minimal route configuration
  */
-const transport = new MockTransport(mockUpdates || []);
-const client = new TelegramBotClient({ transport });
+const mockTransport = new MockTransport(mockUpdates || []);
+// Create client with dummy route configuration
+// Note: when routes is an object (not array/Map), the routeId becomes 'default'
+const client = new TelegramBotClient({
+    routes: {
+        token: config.token,
+        mode: RouteMode.LongPolling
+    }
+});
+// Replace the transport in client with mock transport (for testing purposes only)
+// This is a hack but necessary for testing in worker thread
+client.transport = mockTransport;
+// Access the mock transport
+const transport = mockTransport;
+// Override routeId to 'default' since that's what's created from single route object
+const actualRouteId = 'default';
 const pollingLoop = new PollingLoop({
     client,
     transport,
-    routeId,
+    routeId: actualRouteId,
     timeout,
     limit,
     allowedUpdates,
@@ -74,7 +89,7 @@ const pollingLoop = new PollingLoop({
 });
 const commandHandler = new WorkerCommandHandler({
     pollingLoop,
-    routeId,
+    routeId: actualRouteId,
     sendMessage,
 });
 /**
@@ -88,7 +103,7 @@ parentPort?.on('message', (msg) => {
         const err = error instanceof Error ? error : new Error(String(error));
         sendMessage({
             type: 'error',
-            routeId,
+            routeId: actualRouteId,
             message: `Command handler error: ${err.message}`,
             stack: err.stack,
         });
@@ -101,7 +116,7 @@ process.on('unhandledRejection', (reason) => {
     const err = reason instanceof Error ? reason : new Error(String(reason));
     sendMessage({
         type: 'error',
-        routeId,
+        routeId: actualRouteId,
         message: `Unhandled rejection: ${err.message}`,
         stack: err.stack,
     });
@@ -112,7 +127,7 @@ process.on('unhandledRejection', (reason) => {
 process.on('uncaughtException', (error) => {
     sendMessage({
         type: 'error',
-        routeId,
+        routeId: actualRouteId,
         message: `Uncaught exception: ${error.message}`,
         stack: error.stack,
     });

package/dist/agents/workers/long-polling-worker-test.js.map

@@ -1 +1 @@
-{"version":3,"file":"long-polling-worker-test.js","sourceRoot":"","sources":["../../../src/agents/workers/long-polling-worker-test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"long-polling-worker-test.js","sourceRoot":"","sources":["../../../src/agents/workers/long-polling-worker-test.ts"],"names":[],"mappings":"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"}

package/dist/api/types/GetFileResponseSuccess.generated.d.ts

@@ -1,3 +1,4 @@
+import { File } from './File.generated';
 import { Success } from './Success.generated';
-export interface GetFileResponseSuccess extends Success<boolean> {
+export interface GetFileResponseSuccess extends Success<File> {
 }

package/dist/api/types/GetFileResponseSuccess.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"GetFileResponseSuccess.generated.js","sourceRoot":"","sources":["../../../src/api/types/GetFileResponseSuccess.generated.ts"],"names":[],"mappings":"AAEmE,CAAC"}
+{"version":3,"file":"GetFileResponseSuccess.generated.js","sourceRoot":"","sources":["../../../src/api/types/GetFileResponseSuccess.generated.ts"],"names":[],"mappings":"AAGgE,CAAC"}

package/dist/client/TelegramBotClient.d.ts

@@ -1,13 +1,19 @@
 /**
- * Telegram Bot Client with update processing, middleware, and event system
+ * Telegram Bot Client with route management, middleware, and event system
  *
  * @module client/TelegramBotClient
  */
 import type { Update } from '../api/types/index.js';
 import { BaseTelegramApi } from '../api/BaseTelegramApi.generated.js';
-import type { ITransport } from '../types/transport.types.js';
 import type { ContentTypeSuffix } from '../constants.js';
 import type { ILogger, LoggerOptions, ILoggerAware } from '../types/logger.types.js';
+import type { RouteConfig, RouteMode } from '../types/route.types.js';
+import type { HttpClientOptions } from '../types/http-client.types.js';
+import type { IQueueProvider } from '../types/queue.types.js';
+import { TelegramHttpClient } from '../transport/TelegramHttpClient.js';
+import { RouteConfigManager } from './managers/RouteConfigManager.js';
+import { RouteLifecycleManager } from './managers/RouteLifecycleManager.js';
+import { PollingIntegrationManager } from './managers/PollingIntegrationManager.js';
 /**
  * Middleware function type
  */
@@ -33,38 +39,61 @@ export interface UpdateFilter {
  * Configuration options for TelegramBotClient
  */
 export interface TelegramBotClientOptions extends LoggerOptions {
-    /** Transport instance for API communication */
-    transport: ITransport;
+    /** Route configurations - can be single route, array, or Map */
+    routes: RouteConfig | RouteConfig[] | Map<string, RouteConfig>;
+    /** Default route ID (optional, defaults to first route) */
+    defaultRouteId?: string;
+    /** API base URL (default: https://api.telegram.org) */
+    apiUrl?: string;
+    /** Base URL for webhook templating (combined with webhook.path) */
+    webhookBaseUrl?: string;
+    /** Queue provider for queue-based mode (optional) */
+    queueProvider?: IQueueProvider;
+    /** HTTP client options */
+    httpClientOptions?: HttpClientOptions;
 }
 /**
- * TelegramBotClient extends BaseTelegramApi with update processing capabilities
+ * TelegramBotClient with Composition Pattern architecture
  *
  * Features:
  * - All Telegram API methods from BaseTelegramApi
+ * - Multi-route (multi-token) support
+ * - Route lifecycle management
  * - Update processing with middleware support
  * - Event-based subscriptions
  * - Filter-based update routing
  * - Message and callback wrappers
  * - LoggerTree integration support
+ * - Queue integration for production deployments
  *
  * @example
  * ```typescript
- * import { TelegramBotClient, TelegramTransport } from '@vvlad1973/telegram-bot-client';
+ * import { TelegramBotClient, RouteMode } from '@vvlad1973/telegram-bot-client';
  *
- * const transport = new TelegramTransport({
- *   tokens: { default: 'BOT_TOKEN' }
+ * const bot = new TelegramBotClient({
+ *   routes: { token: 'BOT_TOKEN', mode: RouteMode.LongPolling }
  * });
  *
- * const bot = new TelegramBotClient({ transport });
+ * await bot.init();
  *
  * bot.on('message.text', (wrapper) => {
  *   wrapper.replyMessage('Echo: ' + wrapper.text);
  * });
+ *
+ * await bot.startPolling();
  * ```
  */
 export declare class TelegramBotClient extends BaseTelegramApi implements ILoggerAware {
+    /** Route configuration manager */
+    private readonly configManager;
+    /** Route lifecycle manager */
+    private readonly lifecycleManager;
+    /** Polling integration manager */
+    private readonly pollingIntegrationManager;
     /** Transport instance for API communication */
     private readonly transport;
+    /** Tokens manager */
+    private readonly tokensManager;
     /** Logger instance - mutable to support LoggerBinder.bind() */
     logger?: ILogger;
     /** Middleware stack */
@@ -73,11 +102,19 @@ export declare class TelegramBotClient extends BaseTelegramApi implements ILogge
     private totalReceived;
     /** Cache for deserialized filters (key: serialized filter string, value: deserialized filter) */
     private filterCache;
+    /**
+     * Public access to managers (readonly)
+     */
+    readonly managers: {
+        readonly config: RouteConfigManager;
+        readonly lifecycle: RouteLifecycleManager;
+        readonly polling: PollingIntegrationManager;
+    };
     /**
      * Create a new TelegramBotClient instance
-     * @param options - Client configuration options (or transport for backward compatibility)
+     * @param options - Client configuration options
      */
-    constructor(options: TelegramBotClientOptions | ITransport);
+    constructor(options: TelegramBotClientOptions);
     /**
      * Implementation of abstract callApi method from BaseTelegramApi
      * Delegates to transport.request() method
@@ -89,6 +126,53 @@ export declare class TelegramBotClient extends BaseTelegramApi implements ILogge
      * @returns Promise with API response
      */
     protected callApi<T>(methodName: string, params: Record<string, unknown>, routeId?: string, contentType?: keyof typeof ContentTypeSuffix): Promise<T>;
+    /**
+     * Initialize route (calls getMe and stores bot info)
+     * Delegates to RouteLifecycleManager
+     *
+     * @param routeId - Route identifier (optional, uses default if not specified)
+     * @returns Promise that resolves when route is initialized
+     */
+    init(routeId?: string): Promise<void>;
+    /**
+     * Activate route (set to specified mode)
+     * Delegates to RouteLifecycleManager
+     *
+     * @param routeId - Route identifier (optional, uses default if not specified)
+     * @param mode - Route mode (optional, uses configured mode from route config)
+     * @returns Promise that resolves when route is activated
+     */
+    activate(routeId?: string, mode?: RouteMode): Promise<void>;
+    /**
+     * Deactivate route (set to inactive mode)
+     * Delegates to RouteLifecycleManager
+     *
+     * @param routeId - Route identifier (optional, uses default if not specified)
+     * @returns Promise that resolves when route is deactivated
+     */
+    deactivate(routeId?: string): Promise<void>;
+    /**
+     * Start long polling for all routes configured with LongPolling mode
+     * Delegates to PollingIntegrationManager
+     *
+     * @returns Promise that resolves when polling is started
+     */
+    startPolling(): Promise<void>;
+    /**
+     * Stop long polling
+     * Delegates to PollingIntegrationManager
+     *
+     * @returns Promise that resolves when polling is stopped
+     */
+    stopPolling(): Promise<void>;
+    /**
+     * Set or update route configuration
+     * Delegates to RouteConfigManager
+     *
+     * @param id - Route identifier
+     * @param config - Route configuration
+     */
+    setRoute(id: string, config: RouteConfig): void;
     /**
      * Serialize filter to unique string key
      * Handles RegExp serialization properly
@@ -223,7 +307,7 @@ export declare class TelegramBotClient extends BaseTelegramApi implements ILogge
      * Process incoming update with middleware and event emission
      *
      * @param update - Telegram Update object
-     * @param _context - Optional context object (e.g., { routeId: 'bot1' })
+     * @param context - Optional context object (e.g., { routeId: 'bot1' })
      * @returns Wrapped object (MessageWrapper, CallbackQueryWrapper, or raw data)
      *
      * @example
@@ -247,7 +331,7 @@ export declare class TelegramBotClient extends BaseTelegramApi implements ILogge
      * await client.processUpdate(update, { routeId: 'bot1' });
      * ```
      */
-    processUpdate(update: Update, _context?: {
+    processUpdate(update: Update, context?: {
         routeId?: string;
         [key: string]: unknown;
     }): Promise<unknown>;
@@ -268,7 +352,7 @@ export declare class TelegramBotClient extends BaseTelegramApi implements ILogge
      * const buffer = await httpClient.downloadFile(url, { timeout: 60000 });
      * ```
      */
-    getHttpClient(): any;
+    getHttpClient(): TelegramHttpClient;
     /**
      * Get bot token for specified route
      * Useful for constructing file download URLs and other operations
@@ -288,4 +372,159 @@ export declare class TelegramBotClient extends BaseTelegramApi implements ILogge
      * ```
      */
     getToken(routeId?: string): string;
+    /**
+     * Shutdown the client and close all resources (transport, polling, etc.)
+     * Should be called before application shutdown
+     *
+     * @returns Promise that resolves when all resources are closed
+     */
+    shutdown(): Promise<void>;
+}
+declare module './TelegramBotClient.js' {
+    interface TelegramBotClient {
+        /**
+         * Subscribe to an event
+         *
+         * Inherited from EventEmitter via BaseApi.
+         * TelegramBotClient supports the following event types:
+         * - Message types: 'message.text', 'message.photo', 'message.video', etc.
+         * - Commands: '/start', '/help', etc.
+         * - Update types: 'callback_query', 'inline_query', etc.
+         * - Wildcard: '*' for all updates
+         * - Filters: Use onFilter() for complex filtering
+         *
+         * @param eventName - Event name or filter
+         * @param listener - Event listener function
+         * @returns This client instance for chaining
+         *
+         * @example
+         * ```typescript
+         * // Subscribe to text messages
+         * bot.on('message.text', (wrapper: MessageWrapper) => {
+         *   console.log('Text:', wrapper.text);
+         * });
+         *
+         * // Subscribe to commands
+         * bot.on('/start', (params, wrapper) => {
+         *   wrapper.replyMessage('Welcome!');
+         * });
+         *
+         * // Subscribe to callback queries
+         * bot.on('callback_query', (wrapper: CallbackQueryWrapper) => {
+         *   wrapper.answer('Button clicked!');
+         * });
+         *
+         * // Subscribe to all updates
+         * bot.on('*', (type, wrapper) => {
+         *   console.log('Update type:', type);
+         * });
+         * ```
+         */
+        on(eventName: string | symbol, listener: (...args: any[]) => void): this;
+        /**
+         * Subscribe to an event (one time only)
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @param listener - Event listener function
+         * @returns This client instance for chaining
+         */
+        once(eventName: string | symbol, listener: (...args: any[]) => void): this;
+        /**
+         * Remove event listener
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @param listener - Event listener function to remove
+         * @returns This client instance for chaining
+         */
+        off(eventName: string | symbol, listener: (...args: any[]) => void): this;
+        /**
+         * Remove all listeners for an event, or all events
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name (optional, if not provided removes all listeners)
+         * @returns This client instance for chaining
+         */
+        removeAllListeners(eventName?: string | symbol): this;
+        /**
+         * Emit an event
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @param args - Event arguments
+         * @returns true if the event had listeners, false otherwise
+         */
+        emit(eventName: string | symbol, ...args: any[]): boolean;
+        /**
+         * Get array of event names
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @returns Array of event names
+         */
+        eventNames(): (string | symbol)[];
+        /**
+         * Get listener count for an event
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @returns Number of listeners
+         */
+        listenerCount(eventName: string | symbol): number;
+        /**
+         * Get listeners for an event
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @returns Array of listener functions
+         */
+        listeners(eventName: string | symbol): ((...args: any[]) => void)[];
+        /**
+         * Add event listener (alias for on)
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @param listener - Event listener function
+         * @returns This client instance for chaining
+         */
+        addListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+        /**
+         * Remove event listener (alias for off)
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @param listener - Event listener function to remove
+         * @returns This client instance for chaining
+         */
+        removeListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+        /**
+         * Prepend event listener (add to beginning of listeners array)
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @param listener - Event listener function
+         * @returns This client instance for chaining
+         */
+        prependListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+        /**
+         * Prepend one-time event listener (add to beginning of listeners array)
+         *
+         * Inherited from EventEmitter via BaseApi.
+         *
+         * @param eventName - Event name
+         * @param listener - Event listener function
+         * @returns This client instance for chaining
+         */
+        prependOnceListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    }
 }