chz-telegram-bot 0.0.19 → 0.0.21

package/dist/entities/actions/scheduledAction.d.ts

@@ -1,11 +1,11 @@
 import { Sema as Semaphore } from 'async-sema';
 import { ScheduledHandler } from '../../types/handlers';
 import { HoursOfDay } from '../../types/timeValues';
+import { IActionState } from '../../types/actionState';
 import { IActionWithState } from '../../types/actionWithState';
 import { CachedStateFactory } from '../cachedStateFactory';
 import { ChatContext } from '../context/chatContext';
-import { ActionStateBase } from '../states/actionStateBase';
-export declare class ScheduledAction implements IActionWithState {
+export declare class ScheduledAction<TActionState extends IActionState> implements IActionWithState {
     static semaphore: Semaphore;
     name: string;
     timeinHours: HoursOfDay;
@@ -13,10 +13,10 @@ export declare class ScheduledAction implements IActionWithState {
     chatsWhitelist: number[];
     key: string;
     cachedState: Map<string, unknown>;
-    stateConstructor: () => ActionStateBase;
+    stateConstructor: () => TActionState;
     cachedStateFactories: Map<string, CachedStateFactory>;
-    handler: ScheduledHandler;
-    constructor(name: string, handler: ScheduledHandler, timeinHours: HoursOfDay, active: boolean, whitelist: number[], cachedStateFactories: Map<string, CachedStateFactory>);
+    handler: ScheduledHandler<TActionState>;
+    constructor(name: string, handler: ScheduledHandler<TActionState>, timeinHours: HoursOfDay, active: boolean, whitelist: number[], cachedStateFactories: Map<string, CachedStateFactory>, stateConstructor: () => TActionState);
     exec(ctx: ChatContext): Promise<void>;
     private getCachedValue;
     private shouldTrigger;

package/dist/entities/actions/scheduledAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduledAction.d.ts","sourceRoot":"","sources":["../../../entities/actions/scheduledAction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAK5D,qBAAa,eAAgB,YAAW,gBAAgB;IACpD,MAAM,CAAC,SAAS,YAAoB;IAEpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IAEZ,WAAW,uBAA8B;IACzC,gBAAgB,wBAA+B;IAC/C,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtD,OAAO,EAAE,gBAAgB,CAAC;gBAGtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,UAAU,EACvB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAWnD,IAAI,CAAC,GAAG,EAAE,WAAW;YA4Bb,cAAc;IAqC5B,OAAO,CAAC,aAAa;CASxB"}
+{"version":3,"file":"scheduledAction.d.ts","sourceRoot":"","sources":["../../../entities/actions/scheduledAction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAKrD,qBAAa,eAAe,CAAC,YAAY,SAAS,YAAY,CAC1D,YAAW,gBAAgB;IAE3B,MAAM,CAAC,SAAS,YAAoB;IAEpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IAEZ,WAAW,uBAA8B;IACzC,gBAAgB,EAAE,MAAM,YAAY,CAAC;IACrC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtD,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAGpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACvC,WAAW,EAAE,UAAU,EACvB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACrD,gBAAgB,EAAE,MAAM,YAAY;IAYlC,IAAI,CAAC,GAAG,EAAE,WAAW;YAkCb,cAAc;IAqC5B,OAAO,CAAC,aAAa;CASxB"}

package/dist/entities/actions/scheduledAction.js

@@ -7,14 +7,12 @@ exports.ScheduledAction = void 0;
 const moment_1 = __importDefault(require("moment"));
 const async_sema_1 = require("async-sema");
 const timeConvertions_1 = require("../../helpers/timeConvertions");
-const actionStateBase_1 = require("../states/actionStateBase");
 const actionExecutionResult_1 = require("../actionExecutionResult");
 const logger_1 = require("../../services/logger");
 const taskScheduler_1 = require("../../services/taskScheduler");
 class ScheduledAction {
-    constructor(name, handler, timeinHours, active, whitelist, cachedStateFactories) {
+    constructor(name, handler, timeinHours, active, whitelist, cachedStateFactories, stateConstructor) {
         this.cachedState = new Map();
-        this.stateConstructor = () => new actionStateBase_1.ActionStateBase();
         this.name = name;
         this.handler = handler;
         this.timeinHours = timeinHours;
@@ -22,6 +20,7 @@ class ScheduledAction {
         this.chatsWhitelist = whitelist;
         this.cachedStateFactories = cachedStateFactories;
         this.key = `scheduled:${this.name.replace('.', '-')}`;
+        this.stateConstructor = stateConstructor;
     }
     async exec(ctx) {
         if (!this.active || !this.chatsWhitelist.includes(ctx.chatId))
@@ -30,7 +29,7 @@ class ScheduledAction {
         const isAllowedToTrigger = this.shouldTrigger(state);
         if (isAllowedToTrigger) {
             logger_1.Logger.logWithTraceId(ctx.botName, ctx.traceId, ctx.chatName, ` - Executing [${this.name}] in ${ctx.chatId}`);
-            await this.handler(ctx, (key) => this.getCachedValue(key, ctx.botName));
+            await this.handler(ctx, (key) => this.getCachedValue(key, ctx.botName), state);
             state.lastExecutedDate = (0, moment_1.default)().valueOf();
             await ctx.storage.saveActionExecutionResult(this, ctx.chatId, new actionExecutionResult_1.ActionExecutionResult(state, isAllowedToTrigger));
         }

package/dist/entities/botInstance.d.ts

@@ -15,11 +15,13 @@ export declare class BotInstance {
         name: string;
         token: string;
         commands: CommandAction<IActionState>[];
-        scheduled: ScheduledAction[];
+        scheduled: ScheduledAction<IActionState>[];
         chats: Map<string, number>;
         storageClient?: IStorageClient;
         storagePath?: string;
     });
+    private initializeScheduledProcessing;
+    private initializeMessageProcessing;
     stop(code: string): Promise<void>;
     private runScheduled;
     private processMessages;

package/dist/entities/botInstance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"botInstance.d.ts","sourceRoot":"","sources":["../../entities/botInstance.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAK5D,qBAAa,WAAW;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,EAAE,cAAc,CAAC;gBAEZ,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QACxC,SAAS,EAAE,eAAe,EAAE,CAAC;QAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3B,aAAa,CAAC,EAAE,cAAc,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB;IAuEK,IAAI,CAAC,IAAI,EAAE,MAAM;YAYT,YAAY;YAqBZ,eAAe;CAmBhC"}
+{"version":3,"file":"botInstance.d.ts","sourceRoot":"","sources":["../../entities/botInstance.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAK5D,qBAAa,WAAW;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,EAAE,cAAc,CAAC;gBAEZ,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QACxC,SAAS,EAAE,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3B,aAAa,CAAC,EAAE,cAAc,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB;IAkCD,OAAO,CAAC,6BAA6B;IAcrC,OAAO,CAAC,2BAA2B;IAkC7B,IAAI,CAAC,IAAI,EAAE,MAAM;YAYT,YAAY;YAoBZ,eAAe;CAmBhC"}

package/dist/entities/botInstance.js

@@ -21,26 +21,36 @@ class BotInstance {
             options.storageClient ??
                 new jsonFileStorage_1.JsonFileStorage(options.name, options.storagePath);
         this.api = new telegramApi_1.TelegramApiService(this.name, this.telegraf.telegram, this.storage, this.chats);
-        this.telegraf.on('message', async (ctx) => {
-            const msg = new incomingMessage_1.IncomingMessage(ctx.update.message);
-            const messageContent = msg.text || '<non-text message>';
-            const messageFromName = msg.from?.first_name ?? 'Unknown';
-            const messageFromId = msg.from?.id ?? 'Unknown';
-            logger_1.Logger.logWithTraceId(this.name, msg.traceId, msg.chatName, `${messageFromName} (${messageFromId}): ${messageContent}`);
-            if (msg.text) {
-                this.messageQueue.push(msg);
-            }
-        });
-        this.telegraf.launch();
-        taskScheduler_1.Scheduler.createTask('MessageProcessing', async () => {
-            while (this.messageQueue.length > 0) {
-                await this.processMessages();
-            }
-        }, (0, timeConvertions_1.secondsToMilliseconds)(0.3), false, this.name);
-        taskScheduler_1.Scheduler.createTask('ScheduledProcessing', async () => {
-            await this.runScheduled();
-        }, (0, timeConvertions_1.hoursToMilliseconds)(0.5), true, this.name);
+        this.initializeMessageProcessing();
+        this.initializeScheduledProcessing();
         this.storage.saveMetadata([...this.commands, ...this.scheduled], this.name);
+        this.telegraf.launch();
+    }
+    initializeScheduledProcessing() {
+        if (this.scheduled.length > 0) {
+            taskScheduler_1.Scheduler.createTask('ScheduledProcessing', async () => {
+                await this.runScheduled();
+            }, (0, timeConvertions_1.hoursToMilliseconds)(0.5), true, this.name);
+        }
+    }
+    initializeMessageProcessing() {
+        if (this.commands.length > 0) {
+            this.telegraf.on('message', async (ctx) => {
+                const msg = new incomingMessage_1.IncomingMessage(ctx.update.message);
+                const messageContent = msg.text || '<non-text message>';
+                const messageFromName = msg.from?.first_name ?? 'Unknown';
+                const messageFromId = msg.from?.id ?? 'Unknown';
+                logger_1.Logger.logWithTraceId(this.name, msg.traceId, msg.chatName, `${messageFromName} (${messageFromId}): ${messageContent}`);
+                if (msg.text) {
+                    this.messageQueue.push(msg);
+                }
+            });
+            taskScheduler_1.Scheduler.createTask('MessageProcessing', async () => {
+                while (this.messageQueue.length > 0) {
+                    await this.processMessages();
+                }
+            }, (0, timeConvertions_1.secondsToMilliseconds)(0.3), false, this.name);
+        }
     }
     async stop(code) {
         logger_1.Logger.logWithTraceId(this.name, `System:Bot-${this.name}-Stop`, 'System', 'Stopping bot...');
@@ -55,7 +65,6 @@ class BotInstance {
                     await trig.exec(ctx);
                 }
                 catch (error) {
-                    console.dir(error);
                     logger_1.Logger.errorWithTraceId(ctx.botName, ctx.traceId, chatName, error, ctx);
                 }
             }

package/dist/entities/context/chatContext.d.ts

@@ -1,5 +1,6 @@
 import { IBotApiInteractions } from '../../services/telegramApi';
 import { IStorageClient } from '../../types/storage';
+import { MessageSendingOptions, TextMessageSendingOptions } from '../../types/messageSendingOptions';
 export declare class ChatContext {
     botName: string;
     actionKey: string;
@@ -9,9 +10,9 @@ export declare class ChatContext {
     traceId: number | string;
     storage: IStorageClient;
     constructor(botName: string, actionKey: string, interactions: IBotApiInteractions, chatId: number, chatName: string, traceId: number | string, storage: IStorageClient);
-    sendTextToChat(text: string, disableWebPreview?: boolean, pinned?: boolean): void;
-    sendImageToChat(name: string, pinned?: boolean): void;
-    sendVideoToChat(name: string, pinned?: boolean): void;
+    sendTextToChat(text: string, options?: TextMessageSendingOptions): void;
+    sendImageToChat(name: string, options?: MessageSendingOptions): void;
+    sendVideoToChat(name: string, options?: MessageSendingOptions): void;
     unpinMessage(messageId: number): void;
 }
 //# sourceMappingURL=chatContext.d.ts.map

package/dist/entities/context/chatContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chatContext.d.ts","sourceRoot":"","sources":["../../../entities/context/chatContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,qBAAa,WAAW;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,EAAE,cAAc;IAW3B,cAAc,CACV,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,OAAO,EAC3B,MAAM,CAAC,EAAE,OAAO;IAepB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAc9C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAc9C,YAAY,CAAC,SAAS,EAAE,MAAM;CAUjC"}
+{"version":3,"file":"chatContext.d.ts","sourceRoot":"","sources":["../../../entities/context/chatContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EAC5B,MAAM,mCAAmC,CAAC;AAE3C,qBAAa,WAAW;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,EAAE,cAAc;IAW3B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAahE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAc7D,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAc7D,YAAY,CAAC,SAAS,EAAE,MAAM;CAUjC"}

package/dist/entities/context/chatContext.js

@@ -16,16 +16,16 @@ class ChatContext {
         this.traceId = traceId;
         this.storage = storage;
     }
-    sendTextToChat(text, disableWebPreview, pinned) {
-        this.interactions.respond(new textMessage_1.TextMessage(text, this.chatId, undefined, this.traceId, disableWebPreview ?? false, pinned ?? false, this.actionKey));
+    sendTextToChat(text, options) {
+        this.interactions.respond(new textMessage_1.TextMessage(text, this.chatId, undefined, this.traceId, this.actionKey, options));
     }
-    sendImageToChat(name, pinned) {
+    sendImageToChat(name, options) {
         const filePath = `./content/${name}.png`;
-        this.interactions.respond(new imageMessage_1.ImageMessage({ source: (0, path_1.resolve)(filePath) }, this.chatId, undefined, this.traceId, pinned ?? false, this.actionKey));
+        this.interactions.respond(new imageMessage_1.ImageMessage({ source: (0, path_1.resolve)(filePath) }, this.chatId, undefined, this.traceId, this.actionKey, options));
     }
-    sendVideoToChat(name, pinned) {
+    sendVideoToChat(name, options) {
         const filePath = `./content/${name}.mp4`;
-        this.interactions.respond(new videoMessage_1.VideoMessage({ source: (0, path_1.resolve)(filePath) }, this.chatId, undefined, this.traceId, pinned ?? false, this.actionKey));
+        this.interactions.respond(new videoMessage_1.VideoMessage({ source: (0, path_1.resolve)(filePath) }, this.chatId, undefined, this.traceId, this.actionKey, options));
     }
     unpinMessage(messageId) {
         this.interactions.unpin(new unpin_1.UnpinResponse(messageId, this.chatId, this.traceId, this.actionKey));

package/dist/entities/context/messageContext.d.ts

@@ -3,6 +3,7 @@ import { TelegramEmoji } from 'telegraf/types';
 import { IStorageClient } from '../../types/storage';
 import { IActionState } from '../../types/actionState';
 import { ChatContext } from './chatContext';
+import { MessageSendingOptions, TextMessageSendingOptions } from '../../types/messageSendingOptions';
 export declare class MessageContext<TActionState extends IActionState> extends ChatContext {
     messageId: number;
     messageText: string;
@@ -14,9 +15,9 @@ export declare class MessageContext<TActionState extends IActionState> extends C
     constructor(botName: string, scheduledKey: string, interactions: IBotApiInteractions, chatId: number, chatName: string, messageId: number, messageText: string, fromUserId: number | undefined, traceId: number | string, fromUserName: string, storage: IStorageClient);
     loadStateOf<TAnotherActionState extends IActionState>(commandName: string): Promise<TAnotherActionState>;
     updateState(stateUpdateAction: (state: TActionState) => void): void;
-    replyWithText(text: string, disableWebPreview?: boolean, pinned?: boolean): void;
-    replyWithImage(name: string, pinned?: boolean): void;
-    replyWithVideo(name: string, pinned?: boolean): void;
+    replyWithText(text: string, options?: TextMessageSendingOptions): void;
+    replyWithImage(name: string, options?: MessageSendingOptions): void;
+    replyWithVideo(name: string, options?: MessageSendingOptions): void;
     react(emoji: TelegramEmoji): void;
 }
 //# sourceMappingURL=messageContext.d.ts.map

package/dist/entities/context/messageContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messageContext.d.ts","sourceRoot":"","sources":["../../../entities/context/messageContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,cAAc,CACvB,YAAY,SAAS,YAAY,CACnC,SAAQ,WAAW;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,gBAAgB,EAAE,CAAM;IACtC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAQ;IAC9B,aAAa,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,CAAM;IACzD,YAAY,EAAE,MAAM,CAAC;gBAGjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,cAAc;IAkBrB,WAAW,CAAC,mBAAmB,SAAS,YAAY,EACtD,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC;IAU/B,WAAW,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI;IAM5D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO;IAczE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAc7C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAc7C,KAAK,CAAC,KAAK,EAAE,aAAa;CAW7B"}
+{"version":3,"file":"messageContext.d.ts","sourceRoot":"","sources":["../../../entities/context/messageContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EAC5B,MAAM,mCAAmC,CAAC;AAE3C,qBAAa,cAAc,CACvB,YAAY,SAAS,YAAY,CACnC,SAAQ,WAAW;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,gBAAgB,EAAE,CAAM;IACtC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAQ;IAC9B,aAAa,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,CAAM;IACzD,YAAY,EAAE,MAAM,CAAC;gBAGjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,cAAc;IAkBrB,WAAW,CAAC,mBAAmB,SAAS,YAAY,EACtD,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC;IAU/B,WAAW,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI;IAM5D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAa/D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAc5D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAc5D,KAAK,CAAC,KAAK,EAAE,aAAa;CAW7B"}

package/dist/entities/context/messageContext.js

@@ -25,16 +25,16 @@ class MessageContext extends chatContext_1.ChatContext {
     updateState(stateUpdateAction) {
         this.updateActions.push(stateUpdateAction);
     }
-    replyWithText(text, disableWebPreview, pinned) {
-        this.interactions.respond(new textMessage_1.TextMessage(text, this.chatId, this.messageId, this.traceId, disableWebPreview ?? false, pinned ?? false, this.actionKey));
+    replyWithText(text, options) {
+        this.interactions.respond(new textMessage_1.TextMessage(text, this.chatId, this.messageId, this.traceId, this.actionKey, options));
     }
-    replyWithImage(name, pinned) {
+    replyWithImage(name, options) {
         const filePath = `./content/${name}.png`;
-        this.interactions.respond(new imageMessage_1.ImageMessage({ source: (0, path_1.resolve)(filePath) }, this.chatId, this.messageId, this.traceId, pinned ?? false, this.actionKey));
+        this.interactions.respond(new imageMessage_1.ImageMessage({ source: (0, path_1.resolve)(filePath) }, this.chatId, this.messageId, this.traceId, this.actionKey, options));
     }
-    replyWithVideo(name, pinned) {
+    replyWithVideo(name, options) {
         const filePath = `./content/${name}.mp4`;
-        this.interactions.respond(new videoMessage_1.VideoMessage({ source: (0, path_1.resolve)(filePath) }, this.chatId, this.messageId, this.traceId, pinned ?? false, this.actionKey));
+        this.interactions.respond(new videoMessage_1.VideoMessage({ source: (0, path_1.resolve)(filePath) }, this.chatId, this.messageId, this.traceId, this.actionKey, options));
     }
     react(emoji) {
         this.interactions.react(new reaction_1.Reaction(this.traceId, this.chatId, this.messageId, emoji, this.actionKey));

package/dist/entities/responses/imageMessage.d.ts

@@ -1,5 +1,6 @@
 import { InputFile } from 'telegraf/types';
 import { IReplyMessage } from '../../types/response';
+import { MessageSendingOptions } from '../../types/messageSendingOptions';
 export declare class ImageMessage implements IReplyMessage<InputFile> {
     kind: "image";
     content: InputFile;
@@ -9,6 +10,6 @@ export declare class ImageMessage implements IReplyMessage<InputFile> {
     disableWebPreview: boolean;
     shouldPin: boolean;
     sourceActionKey: string;
-    constructor(image: InputFile, chatId: number, replyId: number | undefined, traceId: number | string, pinned: boolean, sourceActionKey: string);
+    constructor(image: InputFile, chatId: number, replyId: number | undefined, traceId: number | string, sourceActionKey: string, options?: MessageSendingOptions);
 }
 //# sourceMappingURL=imageMessage.d.ts.map

package/dist/entities/responses/imageMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageMessage.d.ts","sourceRoot":"","sources":["../../../entities/responses/imageMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,qBAAa,YAAa,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,IAAI,UAA0B;IAE9B,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iBAAiB,UAAS;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;gBAGpB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,OAAO,EACf,eAAe,EAAE,MAAM;CAS9B"}
+{"version":3,"file":"imageMessage.d.ts","sourceRoot":"","sources":["../../../entities/responses/imageMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,qBAAa,YAAa,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,IAAI,UAA0B;IAE9B,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iBAAiB,UAAS;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;gBAGpB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,qBAAqB;CAStC"}

package/dist/entities/responses/imageMessage.js

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ImageMessage = void 0;
 const response_1 = require("../../types/response");
 class ImageMessage {
-    constructor(image, chatId, replyId, traceId, pinned, sourceActionKey) {
+    constructor(image, chatId, replyId, traceId, sourceActionKey, options) {
         this.kind = response_1.BotResponseTypes.image;
         this.disableWebPreview = false;
         this.content = image;
         this.chatId = chatId;
         this.replyId = replyId;
         this.traceId = traceId;
-        this.shouldPin = pinned;
+        this.shouldPin = options?.pin ?? false;
         this.sourceActionKey = sourceActionKey;
     }
 }

package/dist/entities/responses/textMessage.d.ts

@@ -1,3 +1,4 @@
+import { TextMessageSendingOptions } from '../../types/messageSendingOptions';
 import { IReplyMessage } from '../../types/response';
 export declare class TextMessage implements IReplyMessage<string> {
     kind: "text";
@@ -8,6 +9,6 @@ export declare class TextMessage implements IReplyMessage<string> {
     disableWebPreview: boolean;
     shouldPin: boolean;
     sourceActionKey: string;
-    constructor(text: string, chatId: number, replyId: number | undefined, traceId: string | number, disableWebPreview: boolean, pinned: boolean, sourceActionKey: string);
+    constructor(text: string, chatId: number, replyId: number | undefined, traceId: string | number, sourceActionKey: string, options?: TextMessageSendingOptions);
 }
 //# sourceMappingURL=textMessage.d.ts.map

package/dist/entities/responses/textMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textMessage.d.ts","sourceRoot":"","sources":["../../../entities/responses/textMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,qBAAa,WAAY,YAAW,aAAa,CAAC,MAAM,CAAC;IACrD,IAAI,SAAyB;IAE7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;gBAGpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,iBAAiB,EAAE,OAAO,EAC1B,MAAM,EAAE,OAAO,EACf,eAAe,EAAE,MAAM;CAU9B"}
+{"version":3,"file":"textMessage.d.ts","sourceRoot":"","sources":["../../../entities/responses/textMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,qBAAa,WAAY,YAAW,aAAa,CAAC,MAAM,CAAC;IACrD,IAAI,SAAyB;IAE7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;gBAGpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,yBAAyB;CAU1C"}

package/dist/entities/responses/textMessage.js

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TextMessage = void 0;
 const response_1 = require("../../types/response");
 class TextMessage {
-    constructor(text, chatId, replyId, traceId, disableWebPreview, pinned, sourceActionKey) {
+    constructor(text, chatId, replyId, traceId, sourceActionKey, options) {
         this.kind = response_1.BotResponseTypes.text;
         this.content = text;
         this.chatId = chatId;
         this.replyId = replyId;
         this.traceId = traceId;
-        this.disableWebPreview = disableWebPreview;
-        this.shouldPin = pinned;
+        this.disableWebPreview = options?.disableWebPreview ?? false;
+        this.shouldPin = options?.pin ?? false;
         this.sourceActionKey = sourceActionKey;
     }
 }

package/dist/entities/responses/videoMessage.d.ts

@@ -1,5 +1,6 @@
 import { InputFile } from 'telegraf/types';
 import { IReplyMessage } from '../../types/response';
+import { MessageSendingOptions } from '../../types/messageSendingOptions';
 export declare class VideoMessage implements IReplyMessage<InputFile> {
     kind: "video";
     content: InputFile;
@@ -9,6 +10,6 @@ export declare class VideoMessage implements IReplyMessage<InputFile> {
     disableWebPreview: boolean;
     shouldPin: boolean;
     sourceActionKey: string;
-    constructor(video: InputFile, chatId: number, replyId: number | undefined, traceId: number | string, pinned: boolean, sourceActionKey: string);
+    constructor(video: InputFile, chatId: number, replyId: number | undefined, traceId: number | string, sourceActionKey: string, options?: MessageSendingOptions);
 }
 //# sourceMappingURL=videoMessage.d.ts.map

package/dist/entities/responses/videoMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"videoMessage.d.ts","sourceRoot":"","sources":["../../../entities/responses/videoMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,qBAAa,YAAa,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,IAAI,UAA0B;IAE9B,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iBAAiB,UAAS;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;gBAGpB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,OAAO,EACf,eAAe,EAAE,MAAM;CAS9B"}
+{"version":3,"file":"videoMessage.d.ts","sourceRoot":"","sources":["../../../entities/responses/videoMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,qBAAa,YAAa,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,IAAI,UAA0B;IAE9B,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iBAAiB,UAAS;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;gBAGpB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,qBAAqB;CAStC"}

package/dist/entities/responses/videoMessage.js

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VideoMessage = void 0;
 const response_1 = require("../../types/response");
 class VideoMessage {
-    constructor(video, chatId, replyId, traceId, pinned, sourceActionKey) {
+    constructor(video, chatId, replyId, traceId, sourceActionKey, options) {
         this.kind = response_1.BotResponseTypes.video;
         this.disableWebPreview = false;
         this.content = video;
         this.chatId = chatId;
         this.replyId = replyId;
         this.traceId = traceId;
-        this.shouldPin = pinned;
+        this.shouldPin = options?.pin ?? false;
         this.sourceActionKey = sourceActionKey;
     }
 }

package/dist/helpers/builders/scheduledActionBuilder.d.ts

@@ -1,20 +1,26 @@
 import { ScheduledAction } from '../../entities/actions/scheduledAction';
 import { CachedStateFactory } from '../../entities/cachedStateFactory';
+import { ActionStateBase } from '../../entities/states/actionStateBase';
+import { IActionState } from '../../types/actionState';
 import { ScheduledHandler } from '../../types/handlers';
 import { Hours, HoursOfDay } from '../../types/timeValues';
-export declare class ScheduledActionBuilder {
+export declare class ScheduledActionBuilderWithState<TActionState extends IActionState> {
     active: boolean;
     time: HoursOfDay;
     cachedStateFactories: Map<string, CachedStateFactory>;
     whitelist: number[];
-    handler: ScheduledHandler;
+    stateConstructor: () => TActionState;
+    handler: ScheduledHandler<TActionState>;
     name: string;
-    constructor(name: string);
+    constructor(name: string, stateConstructor: () => TActionState);
     allowIn(chatId: number): this;
     runAt(time: HoursOfDay): this;
-    do(handler: ScheduledHandler): this;
+    do(handler: ScheduledHandler<TActionState>): this;
     withSharedCache(key: string, itemFactory: () => Promise<unknown>, invalidationTimeoutInHours?: Hours): this;
     disabled(): this;
-    build(): ScheduledAction;
+    build(): ScheduledAction<TActionState>;
+}
+export declare class ScheduledActionBuilder extends ScheduledActionBuilderWithState<ActionStateBase> {
+    constructor(name: string);
 }
 //# sourceMappingURL=scheduledActionBuilder.d.ts.map

package/dist/helpers/builders/scheduledActionBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduledActionBuilder.d.ts","sourceRoot":"","sources":["../../../helpers/builders/scheduledActionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG3D,qBAAa,sBAAsB;IAC/B,MAAM,UAAQ;IACd,IAAI,EAAE,UAAU,CAAK;IACrB,oBAAoB,kCAAyC;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAM;IACzB,OAAO,EAAE,gBAAgB,CAAa;IAEtC,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,EAAE,MAAM;IAIxB,OAAO,CAAC,MAAM,EAAE,MAAM;IAMtB,KAAK,CAAC,IAAI,EAAE,UAAU;IAMtB,EAAE,CAAC,OAAO,EAAE,gBAAgB;IAM5B,eAAe,CACX,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACnC,0BAA0B,GAAE,KAAmB;IAUnD,QAAQ;IAMR,KAAK;CAUR"}
+{"version":3,"file":"scheduledActionBuilder.d.ts","sourceRoot":"","sources":["../../../helpers/builders/scheduledActionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG3D,qBAAa,+BAA+B,CACxC,YAAY,SAAS,YAAY;IAEjC,MAAM,UAAQ;IACd,IAAI,EAAE,UAAU,CAAK;IACrB,oBAAoB,kCAAyC;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAM;IACzB,gBAAgB,EAAE,MAAM,YAAY,CAAC;IACrC,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAa;IAEpD,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,YAAY;IAK9D,OAAO,CAAC,MAAM,EAAE,MAAM;IAMtB,KAAK,CAAC,IAAI,EAAE,UAAU;IAMtB,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC;IAM1C,eAAe,CACX,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACnC,0BAA0B,GAAE,KAAmB;IAUnD,QAAQ;IAMR,KAAK;CAWR;AAED,qBAAa,sBAAuB,SAAQ,+BAA+B,CAAC,eAAe,CAAC;gBAC5E,IAAI,EAAE,MAAM;CAG3B"}

package/dist/helpers/builders/scheduledActionBuilder.js

@@ -1,17 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScheduledActionBuilder = void 0;
+exports.ScheduledActionBuilder = exports.ScheduledActionBuilderWithState = void 0;
 const scheduledAction_1 = require("../../entities/actions/scheduledAction");
 const cachedStateFactory_1 = require("../../entities/cachedStateFactory");
+const actionStateBase_1 = require("../../entities/states/actionStateBase");
 const noop_1 = require("../noop");
-class ScheduledActionBuilder {
-    constructor(name) {
+class ScheduledActionBuilderWithState {
+    constructor(name, stateConstructor) {
         this.active = true;
         this.time = 0;
         this.cachedStateFactories = new Map();
         this.whitelist = [];
         this.handler = noop_1.Noop.call;
         this.name = name;
+        this.stateConstructor = stateConstructor;
     }
     allowIn(chatId) {
         this.whitelist.push(chatId);
@@ -34,7 +36,13 @@ class ScheduledActionBuilder {
         return this;
     }
     build() {
-        return new scheduledAction_1.ScheduledAction(this.name, this.handler, this.time, this.active, this.whitelist, this.cachedStateFactories);
+        return new scheduledAction_1.ScheduledAction(this.name, this.handler, this.time, this.active, this.whitelist, this.cachedStateFactories, this.stateConstructor);
+    }
+}
+exports.ScheduledActionBuilderWithState = ScheduledActionBuilderWithState;
+class ScheduledActionBuilder extends ScheduledActionBuilderWithState {
+    constructor(name) {
+        super(name, () => new actionStateBase_1.ActionStateBase());
     }
 }
 exports.ScheduledActionBuilder = ScheduledActionBuilder;

package/dist/main.d.ts

@@ -7,7 +7,7 @@ declare function startBot(options: {
     name: string;
     tokenFilePath: string;
     commands: CommandAction<IActionState>[];
-    scheduled: ScheduledAction[];
+    scheduled: ScheduledAction<IActionState>[];
     chats: Map<string, number>;
     storageClient?: IStorageClient;
     storagePath?: string;

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAQrD,iBAAe,QAAQ,CAAC,OAAO,EAAE;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;IACxC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,wBAcA;AAED,iBAAe,QAAQ,CAAC,MAAM,EAAE,MAAM,iBASrC;AAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAQrD,iBAAe,QAAQ,CAAC,OAAO,EAAE;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;IACxC,SAAS,EAAE,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;IAC3C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,wBAcA;AAED,iBAAe,QAAQ,CAAC,MAAM,EAAE,MAAM,iBASrC;AAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}

package/dist/types/handlers.d.ts

@@ -3,5 +3,5 @@ import { MessageContext } from '../entities/context/messageContext';
 import { IActionState } from './actionState';
 import { CachedValueAccessor } from './cachedValueAccessor';
 export type CommandHandler<TActionState extends IActionState> = (ctx: MessageContext<TActionState>, state: TActionState) => Promise<void>;
-export type ScheduledHandler = (ctx: ChatContext, getCached: CachedValueAccessor) => Promise<void>;
+export type ScheduledHandler<TActionState extends IActionState> = (ctx: ChatContext, getCached: CachedValueAccessor, state: TActionState) => Promise<void>;
 //# sourceMappingURL=handlers.d.ts.map

package/dist/types/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../types/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,cAAc,CAAC,YAAY,SAAS,YAAY,IAAI,CAC5D,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC,EACjC,KAAK,EAAE,YAAY,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,gBAAgB,GAAG,CAC3B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,mBAAmB,KAC7B,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../types/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,cAAc,CAAC,YAAY,SAAS,YAAY,IAAI,CAC5D,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC,EACjC,KAAK,EAAE,YAAY,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,gBAAgB,CAAC,YAAY,SAAS,YAAY,IAAI,CAC9D,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,YAAY,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/types/messageSendingOptions.d.ts

@@ -0,0 +1,7 @@
+export interface MessageSendingOptions {
+    pin?: boolean;
+}
+export interface TextMessageSendingOptions extends MessageSendingOptions {
+    disableWebPreview?: boolean;
+}
+//# sourceMappingURL=messageSendingOptions.d.ts.map

package/dist/types/messageSendingOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageSendingOptions.d.ts","sourceRoot":"","sources":["../../types/messageSendingOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/types/messageSendingOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/entities/actions/scheduledAction.ts

@@ -7,12 +7,13 @@ import { IActionState } from '../../types/actionState';
 import { IActionWithState } from '../../types/actionWithState';
 import { CachedStateFactory } from '../cachedStateFactory';
 import { ChatContext } from '../context/chatContext';
-import { ActionStateBase } from '../states/actionStateBase';
 import { ActionExecutionResult } from '../actionExecutionResult';
 import { Logger } from '../../services/logger';
 import { Scheduler } from '../../services/taskScheduler';
 
-export class ScheduledAction implements IActionWithState {
+export class ScheduledAction<TActionState extends IActionState>
+    implements IActionWithState
+{
     static semaphore = new Semaphore(1);
 
     name: string;
@@ -22,17 +23,18 @@ export class ScheduledAction implements IActionWithState {
     key: string;
 
     cachedState = new Map<string, unknown>();
-    stateConstructor = () => new ActionStateBase();
+    stateConstructor: () => TActionState;
     cachedStateFactories: Map<string, CachedStateFactory>;
-    handler: ScheduledHandler;
+    handler: ScheduledHandler<TActionState>;
 
     constructor(
         name: string,
-        handler: ScheduledHandler,
+        handler: ScheduledHandler<TActionState>,
         timeinHours: HoursOfDay,
         active: boolean,
         whitelist: number[],
-        cachedStateFactories: Map<string, CachedStateFactory>
+        cachedStateFactories: Map<string, CachedStateFactory>,
+        stateConstructor: () => TActionState
     ) {
         this.name = name;
         this.handler = handler;
@@ -41,12 +43,16 @@ export class ScheduledAction implements IActionWithState {
         this.chatsWhitelist = whitelist;
         this.cachedStateFactories = cachedStateFactories;
         this.key = `scheduled:${this.name.replace('.', '-')}`;
+        this.stateConstructor = stateConstructor;
     }
 
     async exec(ctx: ChatContext) {
         if (!this.active || !this.chatsWhitelist.includes(ctx.chatId)) return;
 
-        const state = await ctx.storage.getActionState(this, ctx.chatId);
+        const state = await ctx.storage.getActionState<TActionState>(
+            this,
+            ctx.chatId
+        );
         const isAllowedToTrigger = this.shouldTrigger(state);
 
         if (isAllowedToTrigger) {
@@ -57,8 +63,11 @@ export class ScheduledAction implements IActionWithState {
                 ` - Executing [${this.name}] in ${ctx.chatId}`
             );
 
-            await this.handler(ctx, <TResult>(key: string) =>
-                this.getCachedValue<TResult>(key, ctx.botName)
+            await this.handler(
+                ctx,
+                <TResult>(key: string) =>
+                    this.getCachedValue<TResult>(key, ctx.botName),
+                state
             );
 
             state.lastExecutedDate = moment().valueOf();

package/entities/botInstance.ts

@@ -19,7 +19,7 @@ export class BotInstance {
     private api: TelegramApiService;
     private telegraf: Telegraf;
     private commands: CommandAction<IActionState>[];
-    private scheduled: ScheduledAction[];
+    private scheduled: ScheduledAction<IActionState>[];
     private chats: Map<string, number>;
     private messageQueue: IncomingMessage[] = [];
     storage: IStorageClient;
@@ -28,7 +28,7 @@ export class BotInstance {
         name: string;
         token: string;
         commands: CommandAction<IActionState>[];
-        scheduled: ScheduledAction[];
+        scheduled: ScheduledAction<IActionState>[];
         chats: Map<string, number>;
         storageClient?: IStorageClient;
         storagePath?: string;
@@ -55,52 +55,63 @@ export class BotInstance {
             this.chats
         );
 
-        this.telegraf.on('message', async (ctx) => {
-            const msg = new IncomingMessage(ctx.update.message);
-            const messageContent = msg.text || '<non-text message>';
-
-            const messageFromName = msg.from?.first_name ?? 'Unknown';
-            const messageFromId = msg.from?.id ?? 'Unknown';
-            Logger.logWithTraceId(
-                this.name,
-                msg.traceId,
-                msg.chatName,
-                `${messageFromName} (${messageFromId}): ${messageContent}`
-            );
+        this.initializeMessageProcessing();
+        this.initializeScheduledProcessing();
 
-            if (msg.text) {
-                this.messageQueue.push(msg);
-            }
-        });
+        this.storage.saveMetadata(
+            [...this.commands, ...this.scheduled],
+            this.name
+        );
 
         this.telegraf.launch();
+    }
 
-        Scheduler.createTask(
-            'MessageProcessing',
-            async () => {
-                while (this.messageQueue.length > 0) {
-                    await this.processMessages();
-                }
-            },
-            secondsToMilliseconds(0.3 as Seconds),
-            false,
-            this.name
-        );
+    private initializeScheduledProcessing() {
+        if (this.scheduled.length > 0) {
+            Scheduler.createTask(
+                'ScheduledProcessing',
+                async () => {
+                    await this.runScheduled();
+                },
+                hoursToMilliseconds(0.5 as Hours),
+                true,
+                this.name
+            );
+        }
+    }
 
-        Scheduler.createTask(
-            'ScheduledProcessing',
-            async () => {
-                await this.runScheduled();
-            },
-            hoursToMilliseconds(0.5 as Hours),
-            true,
-            this.name
-        );
+    private initializeMessageProcessing() {
+        if (this.commands.length > 0) {
+            this.telegraf.on('message', async (ctx) => {
+                const msg = new IncomingMessage(ctx.update.message);
+                const messageContent = msg.text || '<non-text message>';
+
+                const messageFromName = msg.from?.first_name ?? 'Unknown';
+                const messageFromId = msg.from?.id ?? 'Unknown';
+                Logger.logWithTraceId(
+                    this.name,
+                    msg.traceId,
+                    msg.chatName,
+                    `${messageFromName} (${messageFromId}): ${messageContent}`
+                );
 
-        this.storage.saveMetadata(
-            [...this.commands, ...this.scheduled],
-            this.name
-        );
+                if (msg.text) {
+                    this.messageQueue.push(msg);
+                }
+            });
+
+            Scheduler.createTask(
+                'MessageProcessing',
+                async () => {
+                    while (this.messageQueue.length > 0) {
+                        await this.processMessages();
+                    }
+                },
+                secondsToMilliseconds(0.3 as Seconds),
+                false,
+                this.name
+            );
+        }
     }
 
     async stop(code: string) {
@@ -123,7 +134,6 @@ export class BotInstance {
                 try {
                     await trig.exec(ctx);
                 } catch (error) {
-                    console.dir(error);
                     Logger.errorWithTraceId(
                         ctx.botName,
                         ctx.traceId,

package/entities/context/chatContext.ts

@@ -5,6 +5,10 @@ import { ImageMessage } from '../responses/imageMessage';
 import { TextMessage } from '../responses/textMessage';
 import { VideoMessage } from '../responses/videoMessage';
 import { UnpinResponse } from '../responses/unpin';
+import {
+    MessageSendingOptions,
+    TextMessageSendingOptions
+} from '../../types/messageSendingOptions';
 
 export class ChatContext {
     botName: string;
@@ -33,25 +37,20 @@ export class ChatContext {
         this.storage = storage;
     }
 
-    sendTextToChat(
-        text: string,
-        disableWebPreview?: boolean,
-        pinned?: boolean
-    ) {
+    sendTextToChat(text: string, options?: TextMessageSendingOptions) {
         this.interactions.respond(
             new TextMessage(
                 text,
                 this.chatId,
                 undefined,
                 this.traceId,
-                disableWebPreview ?? false,
-                pinned ?? false,
-                this.actionKey
+                this.actionKey,
+                options
             )
         );
     }
 
-    sendImageToChat(name: string, pinned?: boolean) {
+    sendImageToChat(name: string, options?: MessageSendingOptions) {
         const filePath = `./content/${name}.png`;
         this.interactions.respond(
             new ImageMessage(
@@ -59,13 +58,13 @@ export class ChatContext {
                 this.chatId,
                 undefined,
                 this.traceId,
-                pinned ?? false,
-                this.actionKey
+                this.actionKey,
+                options
             )
         );
     }
 
-    sendVideoToChat(name: string, pinned?: boolean) {
+    sendVideoToChat(name: string, options?: MessageSendingOptions) {
         const filePath = `./content/${name}.mp4`;
         this.interactions.respond(
             new VideoMessage(
@@ -73,8 +72,8 @@ export class ChatContext {
                 this.chatId,
                 undefined,
                 this.traceId,
-                pinned ?? false,
-                this.actionKey
+                this.actionKey,
+                options
             )
         );
     }

package/entities/context/messageContext.ts

@@ -9,6 +9,10 @@ import { TextMessage } from '../responses/textMessage';
 import { VideoMessage } from '../responses/videoMessage';
 import { ActionStateBase } from '../states/actionStateBase';
 import { ChatContext } from './chatContext';
+import {
+    MessageSendingOptions,
+    TextMessageSendingOptions
+} from '../../types/messageSendingOptions';
 
 export class MessageContext<
     TActionState extends IActionState
@@ -68,21 +72,20 @@ export class MessageContext<
         );
     }
 
-    replyWithText(text: string, disableWebPreview?: boolean, pinned?: boolean) {
+    replyWithText(text: string, options?: TextMessageSendingOptions) {
         this.interactions.respond(
             new TextMessage(
                 text,
                 this.chatId,
                 this.messageId,
                 this.traceId,
-                disableWebPreview ?? false,
-                pinned ?? false,
-                this.actionKey
+                this.actionKey,
+                options
             )
         );
     }
 
-    replyWithImage(name: string, pinned?: boolean) {
+    replyWithImage(name: string, options?: MessageSendingOptions) {
         const filePath = `./content/${name}.png`;
         this.interactions.respond(
             new ImageMessage(
@@ -90,13 +93,13 @@ export class MessageContext<
                 this.chatId,
                 this.messageId,
                 this.traceId,
-                pinned ?? false,
-                this.actionKey
+                this.actionKey,
+                options
             )
         );
     }
 
-    replyWithVideo(name: string, pinned?: boolean) {
+    replyWithVideo(name: string, options?: MessageSendingOptions) {
         const filePath = `./content/${name}.mp4`;
         this.interactions.respond(
             new VideoMessage(
@@ -104,8 +107,8 @@ export class MessageContext<
                 this.chatId,
                 this.messageId,
                 this.traceId,
-                pinned ?? false,
-                this.actionKey
+                this.actionKey,
+                options
             )
         );
     }

package/entities/responses/imageMessage.ts

@@ -1,5 +1,6 @@
 import { InputFile } from 'telegraf/types';
 import { BotResponseTypes, IReplyMessage } from '../../types/response';
+import { MessageSendingOptions } from '../../types/messageSendingOptions';
 
 export class ImageMessage implements IReplyMessage<InputFile> {
     kind = BotResponseTypes.image;
@@ -17,14 +18,14 @@ export class ImageMessage implements IReplyMessage<InputFile> {
         chatId: number,
         replyId: number | undefined,
         traceId: number | string,
-        pinned: boolean,
-        sourceActionKey: string
+        sourceActionKey: string,
+        options?: MessageSendingOptions
     ) {
         this.content = image;
         this.chatId = chatId;
         this.replyId = replyId;
         this.traceId = traceId;
-        this.shouldPin = pinned;
+        this.shouldPin = options?.pin ?? false;
         this.sourceActionKey = sourceActionKey;
     }
 }

package/entities/responses/textMessage.ts

@@ -1,3 +1,4 @@
+import { TextMessageSendingOptions } from '../../types/messageSendingOptions';
 import { BotResponseTypes, IReplyMessage } from '../../types/response';
 
 export class TextMessage implements IReplyMessage<string> {
@@ -16,16 +17,15 @@ export class TextMessage implements IReplyMessage<string> {
         chatId: number,
         replyId: number | undefined,
         traceId: string | number,
-        disableWebPreview: boolean,
-        pinned: boolean,
-        sourceActionKey: string
+        sourceActionKey: string,
+        options?: TextMessageSendingOptions
     ) {
         this.content = text;
         this.chatId = chatId;
         this.replyId = replyId;
         this.traceId = traceId;
-        this.disableWebPreview = disableWebPreview;
-        this.shouldPin = pinned;
+        this.disableWebPreview = options?.disableWebPreview ?? false;
+        this.shouldPin = options?.pin ?? false;
         this.sourceActionKey = sourceActionKey;
     }
 }

package/entities/responses/videoMessage.ts

@@ -1,5 +1,6 @@
 import { InputFile } from 'telegraf/types';
 import { BotResponseTypes, IReplyMessage } from '../../types/response';
+import { MessageSendingOptions } from '../../types/messageSendingOptions';
 
 export class VideoMessage implements IReplyMessage<InputFile> {
     kind = BotResponseTypes.video;
@@ -17,14 +18,14 @@ export class VideoMessage implements IReplyMessage<InputFile> {
         chatId: number,
         replyId: number | undefined,
         traceId: number | string,
-        pinned: boolean,
-        sourceActionKey: string
+        sourceActionKey: string,
+        options?: MessageSendingOptions
     ) {
         this.content = video;
         this.chatId = chatId;
         this.replyId = replyId;
         this.traceId = traceId;
-        this.shouldPin = pinned;
+        this.shouldPin = options?.pin ?? false;
         this.sourceActionKey = sourceActionKey;
     }
 }

package/helpers/builders/scheduledActionBuilder.ts

@@ -1,20 +1,26 @@
 import { ScheduledAction } from '../../entities/actions/scheduledAction';
 import { CachedStateFactory } from '../../entities/cachedStateFactory';
+import { ActionStateBase } from '../../entities/states/actionStateBase';
+import { IActionState } from '../../types/actionState';
 import { ScheduledHandler } from '../../types/handlers';
 import { Hours, HoursOfDay } from '../../types/timeValues';
 import { Noop } from '../noop';
 
-export class ScheduledActionBuilder {
+export class ScheduledActionBuilderWithState<
+    TActionState extends IActionState
+> {
     active = true;
     time: HoursOfDay = 0;
     cachedStateFactories = new Map<string, CachedStateFactory>();
     whitelist: number[] = [];
-    handler: ScheduledHandler = Noop.call;
+    stateConstructor: () => TActionState;
+    handler: ScheduledHandler<TActionState> = Noop.call;
 
     name: string;
 
-    constructor(name: string) {
+    constructor(name: string, stateConstructor: () => TActionState) {
         this.name = name;
+        this.stateConstructor = stateConstructor;
     }
 
     allowIn(chatId: number) {
@@ -29,7 +35,7 @@ export class ScheduledActionBuilder {
         return this;
     }
 
-    do(handler: ScheduledHandler) {
+    do(handler: ScheduledHandler<TActionState>) {
         this.handler = handler;
 
         return this;
@@ -55,13 +61,20 @@ export class ScheduledActionBuilder {
     }
 
     build() {
-        return new ScheduledAction(
+        return new ScheduledAction<TActionState>(
             this.name,
             this.handler,
             this.time,
             this.active,
             this.whitelist,
-            this.cachedStateFactories
+            this.cachedStateFactories,
+            this.stateConstructor
         );
     }
 }
+
+export class ScheduledActionBuilder extends ScheduledActionBuilderWithState<ActionStateBase> {
+    constructor(name: string) {
+        super(name, () => new ActionStateBase());
+    }
+}

package/main.ts

@@ -17,7 +17,7 @@ async function startBot(options: {
     name: string;
     tokenFilePath: string;
     commands: CommandAction<IActionState>[];
-    scheduled: ScheduledAction[];
+    scheduled: ScheduledAction<IActionState>[];
     chats: Map<string, number>;
     storageClient?: IStorageClient;
     storagePath?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "chz-telegram-bot",
-    "version": "0.0.19",
+    "version": "0.0.21",
     "type": "module",
     "dependencies": {
         "async-sema": "^3.1.1",

package/types/handlers.ts

@@ -8,7 +8,8 @@ export type CommandHandler<TActionState extends IActionState> = (
     state: TActionState
 ) => Promise<void>;
 
-export type ScheduledHandler = (
+export type ScheduledHandler<TActionState extends IActionState> = (
     ctx: ChatContext,
-    getCached: CachedValueAccessor
+    getCached: CachedValueAccessor,
+    state: TActionState
 ) => Promise<void>;

package/types/messageSendingOptions.ts

@@ -0,0 +1,7 @@
+export interface MessageSendingOptions {
+    pin?: boolean;
+}
+
+export interface TextMessageSendingOptions extends MessageSendingOptions {
+    disableWebPreview?: boolean;
+}