chz-telegram-bot 0.5.3 → 0.5.5

package/dist/helpers/builders/scheduledActionBuilder.js

@@ -0,0 +1,95 @@
+import { ScheduledAction } from '../../entities/actions/scheduledAction';
+import { CachedStateFactory } from '../../entities/cachedStateFactory';
+import { ActionStateBase } from '../../entities/states/actionStateBase';
+import { Noop } from '../noop';
+/**
+ * Builder for `ScheduledAction` with state represented by `TActionState`
+ */
+export class ScheduledActionBuilderWithState {
+    name;
+    cachedStateFactories = new Map();
+    stateConstructor;
+    handler = Noop.call;
+    whitelistProvider = () => [];
+    activeProvider = () => true;
+    timeinHoursProvider = () => 0;
+    /**
+     * Builder for `ScheduledAction` with state represented by `TActionState`
+     * @param name Action name, will be used for logging and storage
+     * @param stateConstructor Function that creates default state object
+     */
+    constructor(name, stateConstructor) {
+        this.name = name;
+        this.stateConstructor = stateConstructor;
+    }
+    /**
+     * Sets whitelist for this action.
+     * @param chatIds Chat ids to execute in.
+     */
+    in(chatIds) {
+        this.whitelistProvider = () => chatIds;
+        return this;
+    }
+    /**
+     * Defines time for scheduled item execution.
+     * @param time Time of day (0 - 23) to execute action.
+     */
+    runAt(time) {
+        this.timeinHoursProvider = () => time;
+        return this;
+    }
+    /** Defines action logic itself, will be executed on timer.
+     * @param handler Callback that will be called on timer.
+     */
+    do(handler) {
+        this.handler = handler;
+        return this;
+    }
+    /**
+     * Defines process-wide cache, that is shared by all actions of this type (even in different bot instances).
+     * Can be used for fetch request de-duping, etc.
+     * @param key Key that will be used to retrieve value from cache.
+     * @param itemFactory Callback that will be executed once to create cached value.
+     * @param invalidationTimeoutInHours Timeout for cache invalidation.
+     */
+    withSharedCache(key, itemFactory, invalidationTimeoutInHours = 20) {
+        this.cachedStateFactories.set(key, new CachedStateFactory(itemFactory, invalidationTimeoutInHours));
+        return this;
+    }
+    /** If called during building, action is marked as disabled and never checked. */
+    disabled() {
+        this.activeProvider = () => false;
+        return this;
+    }
+    /**
+     * Configures action to use property value providers instead of static value to allow changes in runtime
+     */
+    withConfiguration(configuration) {
+        if (configuration.chatsWhitelistProvider)
+            this.whitelistProvider = configuration.chatsWhitelistProvider;
+        if (configuration.timeinHoursProvider)
+            this.timeinHoursProvider = configuration.timeinHoursProvider;
+        if (configuration.isActiveProvider)
+            this.activeProvider = configuration.isActiveProvider;
+        return this;
+    }
+    /** Builds action */
+    build() {
+        return new ScheduledAction(this.name, this.handler, {
+            chatsWhitelistProvider: this.whitelistProvider,
+            isActiveProvider: this.activeProvider,
+            timeinHoursProvider: this.timeinHoursProvider
+        }, this.cachedStateFactories, this.stateConstructor);
+    }
+}
+/**
+ * Builder for `ScheduledAction` with state represented by default state (containing only last execution date).
+ */
+export class ScheduledActionBuilder extends ScheduledActionBuilderWithState {
+    /**
+     * Builder for `ScheduledAction` with state represented by default state (containing only last execution date).
+     */
+    constructor(name) {
+        super(name, () => new ActionStateBase());
+    }
+}

package/dist/helpers/mapUtils.d.ts

@@ -0,0 +1,10 @@
+type KeyedReadonlyCollection<K, V> = {
+    get: (key: K) => V | undefined;
+};
+type KeyedWriteableCollection<K, V> = KeyedReadonlyCollection<K, V> & {
+    set: (key: K, value: V) => KeyedWriteableCollection<K, V>;
+};
+export declare function getOrSetIfNotExists<K, V>(map: KeyedWriteableCollection<K, V>, key: K, fallback: V): V;
+export declare function getOrThrow<K, V>(map: KeyedReadonlyCollection<K, V>, key: K, error?: string): NonNullable<V>;
+export {};
+//# sourceMappingURL=mapUtils.d.ts.map

package/dist/helpers/mapUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapUtils.d.ts","sourceRoot":"","sources":["../../helpers/mapUtils.ts"],"names":[],"mappings":"AAAA,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI;IAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;CAAE,CAAC;AACxE,KAAK,wBAAwB,CAAC,CAAC,EAAE,CAAC,IAAI,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAClE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC7D,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACpC,GAAG,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,EACnC,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,CAAC,KAQd;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAC3B,GAAG,EAAE,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,EAClC,GAAG,EAAE,CAAC,EACN,KAAK,GAAE,MAAsC,kBAMhD"}

package/dist/helpers/mapUtils.js

@@ -0,0 +1,13 @@
+export function getOrSetIfNotExists(map, key, fallback) {
+    const existingValue = map.get(key);
+    if (existingValue)
+        return existingValue;
+    map.set(key, fallback);
+    return fallback;
+}
+export function getOrThrow(map, key, error = 'Key not found in collection') {
+    const existingValue = map.get(key);
+    if (existingValue)
+        return existingValue;
+    throw new Error(error);
+}

package/dist/helpers/noop.d.ts

@@ -0,0 +1,9 @@
+import { BotResponse } from '../types/response';
+export declare class Noop {
+    static readonly NoResponse: BotResponse[];
+    static true(arg1: unknown): boolean;
+    static false(arg1: unknown): boolean;
+    static emptyString(): string;
+    static call(arg1: unknown): Promise<void>;
+}
+//# sourceMappingURL=noop.d.ts.map

package/dist/helpers/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../helpers/noop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,qBAAa,IAAI;IACb,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,CAAM;IAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO;IAGzB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO;IAG1B,MAAM,CAAC,WAAW;WAGL,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAIlD"}

package/dist/helpers/noop.js

@@ -0,0 +1,17 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+export class Noop {
+    static NoResponse = [];
+    static true(arg1) {
+        return true;
+    }
+    static false(arg1) {
+        return false;
+    }
+    static emptyString() {
+        return '';
+    }
+    static async call(arg1, arg2) {
+        return Promise.resolve();
+    }
+}

package/dist/helpers/objectFromEntries.d.ts

@@ -0,0 +1,2 @@
+export declare const typeSafeObjectFromEntries: <const T extends ReadonlyArray<readonly [PropertyKey, unknown]>>(entries: T) => { [K in T[number] as K[0]]: K[1]; };
+//# sourceMappingURL=objectFromEntries.d.ts.map

package/dist/helpers/objectFromEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectFromEntries.d.ts","sourceRoot":"","sources":["../../helpers/objectFromEntries.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,GAClC,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,EAE9D,SAAS,CAAC,KACX,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAElC,CAAC"}

package/dist/helpers/objectFromEntries.js

@@ -0,0 +1,3 @@
+export const typeSafeObjectFromEntries = (entries) => {
+    return Object.fromEntries(entries);
+};

package/dist/helpers/timeConvertions.d.ts

@@ -0,0 +1,5 @@
+import { Hours, Milliseconds, Seconds } from '../types/timeValues';
+export declare function secondsToMilliseconds(value: Seconds): Milliseconds;
+export declare function hoursToMilliseconds(value: Hours): Milliseconds;
+export declare function hoursToSeconds(value: Hours): Seconds;
+//# sourceMappingURL=timeConvertions.d.ts.map

package/dist/helpers/timeConvertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeConvertions.d.ts","sourceRoot":"","sources":["../../helpers/timeConvertions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAElE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAE9D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEpD"}

package/dist/helpers/timeConvertions.js

@@ -0,0 +1,9 @@
+export function secondsToMilliseconds(value) {
+    return (value * 1000);
+}
+export function hoursToMilliseconds(value) {
+    return (value * 60 * 60 * 1000);
+}
+export function hoursToSeconds(value) {
+    return (value * 60 * 60);
+}

package/dist/helpers/toArray.d.ts

@@ -0,0 +1,2 @@
+export declare function toArray<TType>(value: TType | TType[]): TType[];
+//# sourceMappingURL=toArray.d.ts.map

package/dist/helpers/toArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toArray.d.ts","sourceRoot":"","sources":["../../helpers/toArray.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,WAEpD"}

package/dist/helpers/toArray.js

@@ -0,0 +1,3 @@
+export function toArray(value) {
+    return Array.isArray(value) ? value : [value];
+}

package/dist/helpers/traceFactory.d.ts

@@ -0,0 +1,3 @@
+import { TraceId } from '../types/trace';
+export declare function createTrace(traceOwner: object | string, botName: string, traceName: string): TraceId;
+//# sourceMappingURL=traceFactory.d.ts.map

package/dist/helpers/traceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceFactory.d.ts","sourceRoot":"","sources":["../../helpers/traceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,wBAAgB,WAAW,CACvB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAIa,OAAO,CACxC"}

package/dist/helpers/traceFactory.js

@@ -0,0 +1,3 @@
+export function createTrace(traceOwner, botName, traceName) {
+    return `${typeof traceOwner == 'string' ? traceOwner : traceOwner.constructor.name}:${botName}-${traceName}`;
+}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export * from './main';
+export * from './helpers/builders/inlineQueryActionBuilder';
+export * from './helpers/builders/commandActionBuilder';
+export * from './helpers/builders/scheduledActionBuilder';
+export * from './types/actionState';
+export * from './entities/states/actionStateBase';
+export * from './types/messageTypes';
+export * from './helpers/timeConvertions';
+export * from './types/action';
+export * from './types/externalAliases';
+export * from './types/storage';
+export * from './types/logger';
+export * from './types/scheduler';
+export { CommandAction } from './entities/actions/commandAction';
+export { InlineQueryAction } from './entities/actions/inlineQueryAction';
+export { ReplyCaptureAction } from './entities/actions/replyCaptureAction';
+export { ScheduledAction } from './entities/actions/scheduledAction';
+export { Hours, Milliseconds, Seconds } from './types/timeValues';
+export { ChatContext } from './entities/context/chatContext';
+export { InlineQueryContext } from './entities/context/inlineQueryContext';
+export { MessageContext } from './entities/context/messageContext';
+export { ReplyContext } from './entities/context/replyContext';
+export { ICaptureController } from './types/capture';
+export { ChatInfo } from './dtos/chatInfo';
+export { MessageInfo } from './dtos/messageInfo';
+export { UserInfo } from './dtos/userInfo';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qBAAqB,CAAC;AACpC,cAAc,mCAAmC,CAAC;AAClD,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+export * from './main';
+export * from './helpers/builders/inlineQueryActionBuilder';
+export * from './helpers/builders/commandActionBuilder';
+export * from './helpers/builders/scheduledActionBuilder';
+export * from './types/actionState';
+export * from './entities/states/actionStateBase';
+export * from './types/messageTypes';
+export * from './helpers/timeConvertions';
+export * from './types/action';
+export * from './types/externalAliases';
+export * from './types/storage';
+export * from './types/logger';
+export * from './types/scheduler';
+export { CommandAction } from './entities/actions/commandAction';
+export { InlineQueryAction } from './entities/actions/inlineQueryAction';
+export { ReplyCaptureAction } from './entities/actions/replyCaptureAction';
+export { ScheduledAction } from './entities/actions/scheduledAction';
+export { ChatInfo } from './dtos/chatInfo';
+export { MessageInfo } from './dtos/messageInfo';
+export { UserInfo } from './dtos/userInfo';

package/dist/main.d.ts

@@ -0,0 +1,52 @@
+import { IStorageClient } from './types/storage';
+import { CommandAction } from './entities/actions/commandAction';
+import { ScheduledAction } from './entities/actions/scheduledAction';
+import { BotInstance } from './entities/botInstance';
+import { Seconds } from './types/timeValues';
+import { IScheduler } from './types/scheduler';
+import { ILogger } from './types/logger';
+import { InlineQueryAction } from './entities/actions/inlineQueryAction';
+import { IActionState } from './types/actionState';
+declare class BotOrchestrator {
+    bots: BotInstance[];
+    /**
+     * Starts bot
+     */
+    startBot(options: {
+        /** Bot name, used in logging */
+        name: string;
+        /** Path to file containing Telegram Bot token. */
+        tokenFilePath: string;
+        actions: {
+            /** Collection of actions that will be executed as a response to message from used. Created using `CommandActionBuilder`.*/
+            commands: CommandAction<IActionState>[];
+            /** Collection of actions that will be executed on timer. Created using `ScheduledActionBuilder`.*/
+            scheduled: ScheduledAction<IActionState>[];
+            /** Collection of actions that will handle inline queries */
+            inlineQueries: InlineQueryAction[];
+        };
+        /** Object containing chat name and chat id pairs. Used for logging and execution of scheduled action. */
+        chats: Record<string, number>;
+        /** Storage path for default `JsonFileStorage` client. Will be used only if `storageClient` is not provided. If not provided, default value of `./storage/` will be used.*/
+        storagePath?: string;
+        /** Period of time between execution of scheduled actions. */
+        scheduledPeriod?: Seconds;
+        /** If true, telegram API objects will be logged instead of message content. */
+        verboseLoggingForIncomingMessage?: boolean;
+        services?: {
+            /** Storage client for bot state storage. If not provided, default `JsonFileStorage` will be used. */
+            storageClient?: IStorageClient;
+            /** Logger client for bot logging. If not provided, default `JsonFileStorage` will be used. */
+            logger?: ILogger;
+            /** Scheduler client for bot scheduling. If not provided, default `NodeTimeoutScheduler` will be used. */
+            scheduler?: IScheduler;
+        };
+    }): Promise<BotInstance>;
+    /**
+     * Terminates all scheduled tasks, closes storage connections and stops all bots.
+     */
+    stopBots(): Promise<void>;
+}
+export declare const botOrchestrator: BotOrchestrator;
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,cAAM,eAAe;IACjB,IAAI,EAAE,WAAW,EAAE,CAAM;IAEzB;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE;QACpB,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,kDAAkD;QAClD,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE;YACL,2HAA2H;YAC3H,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,mGAAmG;YACnG,SAAS,EAAE,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3C,4DAA4D;YAC5D,aAAa,EAAE,iBAAiB,EAAE,CAAC;SACtC,CAAC;QACF,yGAAyG;QACzG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,2KAA2K;QAC3K,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,6DAA6D;QAC7D,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,+EAA+E;QAC/E,gCAAgC,CAAC,EAAE,OAAO,CAAC;QAC3C,QAAQ,CAAC,EAAE;YACP,qGAAqG;YACrG,aAAa,CAAC,EAAE,cAAc,CAAC;YAC/B,8FAA8F;YAC9F,MAAM,CAAC,EAAE,OAAO,CAAC;YACjB,yGAAyG;YACzG,SAAS,CAAC,EAAE,UAAU,CAAC;SAC1B,CAAC;KACL;IA0BD;;OAEG;IACG,QAAQ;CAKjB;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/main.js

@@ -0,0 +1,34 @@
+import { readFile } from 'fs/promises';
+import { BotInstance } from './entities/botInstance';
+class BotOrchestrator {
+    bots = [];
+    /**
+     * Starts bot
+     */
+    async startBot(options) {
+        const token = await readFile(options.tokenFilePath, 'utf8');
+        const bot = new BotInstance({
+            name: options.name,
+            actions: options.actions,
+            chats: options.chats,
+            services: {
+                storageClient: options.services?.storageClient,
+                logger: options.services?.logger,
+                scheduler: options.services?.scheduler
+            },
+            storagePath: options.storagePath
+        });
+        await bot.start(token, options.actions, options.scheduledPeriod, options.verboseLoggingForIncomingMessage);
+        this.bots.push(bot);
+        return bot;
+    }
+    /**
+     * Terminates all scheduled tasks, closes storage connections and stops all bots.
+     */
+    async stopBots() {
+        for (const bot of this.bots) {
+            await bot.stop();
+        }
+    }
+}
+export const botOrchestrator = new BotOrchestrator();

package/dist/services/actionProcessingService.d.ts

@@ -0,0 +1,25 @@
+import { Seconds } from '../types/timeValues';
+import { ILogger } from '../types/logger';
+import { IScheduler } from '../types/scheduler';
+import { IStorageClient } from '../types/storage';
+import { InlineQueryAction } from '../entities/actions/inlineQueryAction';
+import { IActionState } from '../types/actionState';
+import { CommandAction } from '../entities/actions/commandAction';
+import { ScheduledAction } from '../entities/actions/scheduledAction';
+export declare class ActionProcessingService {
+    private readonly storage;
+    private readonly logger;
+    private readonly commandProcessor;
+    private readonly scheduledProcessor;
+    private readonly inlineQueryProcessor;
+    private readonly botName;
+    private telegramBot;
+    constructor(botName: string, chats: Record<string, number>, storage: IStorageClient, scheduler: IScheduler, logger: ILogger);
+    initialize(token: string, actions: {
+        commands: CommandAction<IActionState>[];
+        scheduled: ScheduledAction<IActionState>[];
+        inlineQueries: InlineQueryAction[];
+    }, scheduledPeriod?: Seconds, verboseLoggingForIncomingMessage?: boolean): Promise<void>;
+    stop(): void;
+}
+//# sourceMappingURL=actionProcessingService.d.ts.map

package/dist/services/actionProcessingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionProcessingService.d.ts","sourceRoot":"","sources":["../../services/actionProcessingService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAuB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAQtE,qBAAa,uBAAuB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAElE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,WAAW,CAAe;gBAG9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,OAAO;IA4Bb,UAAU,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QACL,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QACxC,SAAS,EAAE,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3C,aAAa,EAAE,iBAAiB,EAAE,CAAC;KACtC,EACD,eAAe,CAAC,EAAE,OAAO,EACzB,gCAAgC,CAAC,EAAE,OAAO;IA2D9C,IAAI;CAGP"}

package/dist/services/actionProcessingService.js

@@ -0,0 +1,50 @@
+import { hoursToSeconds } from '../helpers/timeConvertions';
+import { TelegramApiService } from './telegramApi';
+import { buildHelpCommand } from '../builtin/helpAction';
+import { CommandActionProcessor } from './actionProcessors/commandActionProcessor';
+import { InlineQueryActionProcessor } from './actionProcessors/inlineQueryActionProcessor';
+import { ScheduledActionProcessor } from './actionProcessors/scheduledActionProcessor';
+import { Telegraf } from 'telegraf';
+export class ActionProcessingService {
+    storage;
+    logger;
+    commandProcessor;
+    scheduledProcessor;
+    inlineQueryProcessor;
+    botName;
+    telegramBot;
+    constructor(botName, chats, storage, scheduler, logger) {
+        this.storage = storage;
+        this.logger = logger;
+        this.commandProcessor = new CommandActionProcessor(botName, storage, scheduler, logger);
+        this.scheduledProcessor = new ScheduledActionProcessor(botName, chats, storage, scheduler, logger);
+        this.inlineQueryProcessor = new InlineQueryActionProcessor(botName, storage, scheduler, logger);
+        this.botName = botName;
+    }
+    async initialize(token, actions, scheduledPeriod, verboseLoggingForIncomingMessage) {
+        this.telegramBot = new Telegraf(token);
+        const api = new TelegramApiService(this.botName, this.telegramBot.telegram, this.storage, this.logger, (capture, id, chatInfo, traceId) => {
+            this.commandProcessor.captureRegistrationCallback(capture, id, chatInfo, traceId);
+        });
+        const botInfo = await this.telegramBot.telegram.getMe();
+        const commandActions = actions.commands.length > 0 && botInfo.username
+            ? [
+                buildHelpCommand(actions.commands
+                    .map((x) => x.readmeFactory(botInfo.username))
+                    .filter((x) => !!x), botInfo.username),
+                ...actions.commands
+            ]
+            : [];
+        this.commandProcessor.initialize(api, this.telegramBot, commandActions, verboseLoggingForIncomingMessage ?? false, botInfo);
+        this.inlineQueryProcessor.initialize(api, this.telegramBot, actions.inlineQueries, 300);
+        this.scheduledProcessor.initialize(api, actions.scheduled, scheduledPeriod ?? hoursToSeconds(1));
+        void this.telegramBot.launch();
+        void this.storage.saveMetadata([
+            ...actions.scheduled,
+            ...commandActions
+        ]);
+    }
+    stop() {
+        this.telegramBot.stop();
+    }
+}

package/dist/services/actionProcessors/baseProcessor.d.ts

@@ -0,0 +1,18 @@
+import { ILogger } from '../../types/logger';
+import { IScheduler } from '../../types/scheduler';
+import { IStorageClient } from '../../types/storage';
+import { TelegramApiService } from '../telegramApi';
+import { IAction } from '../../types/action';
+import { BaseContextInternal } from '../../entities/context/baseContext';
+export declare abstract class BaseActionProcessor {
+    protected readonly storage: IStorageClient;
+    protected readonly scheduler: IScheduler;
+    protected readonly logger: ILogger;
+    protected readonly botName: string;
+    protected api: TelegramApiService;
+    constructor(botName: string, storage: IStorageClient, scheduler: IScheduler, logger: ILogger);
+    private defaultErrorHandler;
+    initializeDependencies(api: TelegramApiService): void;
+    executeAction<TAction extends IAction, TActionContext extends BaseContextInternal<TAction>>(action: TAction, ctx: TActionContext, errorHandler?: (error: Error, ctx: TActionContext) => void): Promise<void>;
+}
+//# sourceMappingURL=baseProcessor.d.ts.map

package/dist/services/actionProcessors/baseProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseProcessor.d.ts","sourceRoot":"","sources":["../../../services/actionProcessors/baseProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,8BAAsB,mBAAmB;IACrC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAG,kBAAkB,CAAC;gBAG/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,OAAO;IASnB,OAAO,CAAC,mBAAmB;IAO3B,sBAAsB,CAAC,GAAG,EAAE,kBAAkB;IAIxC,aAAa,CACf,OAAO,SAAS,OAAO,EACvB,cAAc,SAAS,mBAAmB,CAAC,OAAO,CAAC,EAEnD,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,cAAc,EACnB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI;CAUjE"}

package/dist/services/actionProcessors/baseProcessor.js

@@ -0,0 +1,29 @@
+export class BaseActionProcessor {
+    storage;
+    scheduler;
+    logger;
+    botName;
+    api;
+    constructor(botName, storage, scheduler, logger) {
+        this.storage = storage;
+        this.scheduler = scheduler;
+        this.logger = logger;
+        this.botName = botName;
+    }
+    defaultErrorHandler(error, ctx) {
+        ctx.logger.errorWithTraceId(error, ctx);
+    }
+    initializeDependencies(api) {
+        this.api = api;
+    }
+    async executeAction(action, ctx, errorHandler) {
+        try {
+            const responses = await action.exec(ctx);
+            this.api.enqueueBatchedResponses(responses);
+            ctx.isInitialized = false;
+        }
+        catch (error) {
+            (errorHandler ?? this.defaultErrorHandler)(error, ctx);
+        }
+    }
+}

package/dist/services/actionProcessors/commandActionProcessor.d.ts

@@ -0,0 +1,20 @@
+import { CommandAction } from '../../entities/actions/commandAction';
+import { IActionState } from '../../types/actionState';
+import { TelegramApiService } from '../telegramApi';
+import { IReplyCapture } from '../../types/capture';
+import { TraceId } from '../../types/trace';
+import { ChatInfo } from '../../dtos/chatInfo';
+import { BaseActionProcessor } from './baseProcessor';
+import { BotInfo, TelegramBot } from '../../types/externalAliases';
+export declare class CommandActionProcessor extends BaseActionProcessor {
+    private readonly replyCaptures;
+    private readonly chatHistory;
+    private botInfo;
+    private commands;
+    initialize(api: TelegramApiService, telegram: TelegramBot, commands: CommandAction<IActionState>[], verboseLoggingForIncomingMessage: boolean, botInfo: BotInfo): void;
+    captureRegistrationCallback(capture: IReplyCapture, parentMessageId: number, chatInfo: ChatInfo, traceId: TraceId): void;
+    private processMessage;
+    private initializeReplyCaptureContext;
+    private initializeMessageContext;
+}
+//# sourceMappingURL=commandActionProcessor.d.ts.map

package/dist/services/actionProcessors/commandActionProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandActionProcessor.d.ts","sourceRoot":"","sources":["../../../services/actionProcessors/commandActionProcessor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAIrE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAM/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAKtD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAInE,qBAAa,sBAAuB,SAAQ,mBAAmB;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;IACxE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IACvE,OAAO,CAAC,OAAO,CAAW;IAE1B,OAAO,CAAC,QAAQ,CAKd;IAEF,UAAU,CACN,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,EACvC,gCAAgC,EAAE,OAAO,EACzC,OAAO,EAAE,OAAO;IA0DpB,2BAA2B,CACvB,OAAO,EAAE,aAAa,EACtB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO;YAgCN,cAAc;IAqD5B,OAAO,CAAC,6BAA6B;IAiCrC,OAAO,CAAC,wBAAwB;CAmCnC"}