chz-telegram-bot 0.0.46 → 0.0.48

package/dist/services/jsonFileStorage.d.ts

@@ -7,16 +7,16 @@ export declare class JsonFileStorage implements IStorageClient {
     private cache;
     private storagePath;
     private botName;
-    constructor(botName: string, actions: IActionWithState[], path?: string);
+    constructor(botName: string, actions: IActionWithState<IActionState>[], path?: string);
     private lock;
     private loadInternal;
     private save;
     private buidPathFromKey;
     load<TActionState extends IActionState>(key: ActionKey): Promise<Record<number, TActionState>>;
-    saveMetadata(actions: IActionWithState[], botName: string): Promise<void>;
-    getActionState<TActionState extends IActionState>(action: IActionWithState, chatId: number): Promise<TActionState>;
-    saveActionExecutionResult(action: IActionWithState, chatId: number, transactionResult: ActionExecutionResult): Promise<void>;
+    saveMetadata(actions: IActionWithState<IActionState>[], botName: string): Promise<void>;
+    getActionState<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number): Promise<TActionState>;
+    saveActionExecutionResult<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number, transactionResult: ActionExecutionResult<TActionState>): Promise<void>;
     close(): Promise<void>;
-    updateStateFor<TActionState extends IActionState>(action: IActionWithState, chatId: number, update: (state: TActionState) => Promise<void>): Promise<void>;
+    updateStateFor<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number, update: (state: TActionState) => Promise<void>): Promise<void>;
 }
 //# sourceMappingURL=jsonFileStorage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"jsonFileStorage.d.ts","sourceRoot":"","sources":["../../services/jsonFileStorage.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEvE,qBAAa,eAAgB,YAAW,cAAc;IAClD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM;YAgBzD,IAAI;YAgBJ,YAAY;YAqBZ,IAAI;IAalB,OAAO,CAAC,eAAe;IAOjB,IAAI,CAAC,YAAY,SAAS,YAAY,EAAE,GAAG,EAAE,SAAS;IAMtD,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM;IAUzD,cAAc,CAAC,YAAY,SAAS,YAAY,EAClD,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM;IAYZ,yBAAyB,CAC3B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,qBAAqB;IAYtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,cAAc,CAAC,YAAY,SAAS,YAAY,EAClD,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC;CAcrD"}
+{"version":3,"file":"jsonFileStorage.d.ts","sourceRoot":"","sources":["../../services/jsonFileStorage.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEvE,qBAAa,eAAgB,YAAW,cAAc;IAClD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAGpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,EAAE,EACzC,IAAI,CAAC,EAAE,MAAM;YAiBH,IAAI;YAgBJ,YAAY;YAqBZ,IAAI;IAgBlB,OAAO,CAAC,eAAe;IAOjB,IAAI,CAAC,YAAY,SAAS,YAAY,EAAE,GAAG,EAAE,SAAS;IAMtD,YAAY,CACd,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,EAAE,EACzC,OAAO,EAAE,MAAM;IAWb,cAAc,CAAC,YAAY,SAAS,YAAY,EAClD,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,MAAM,EAAE,MAAM;IAYZ,yBAAyB,CAAC,YAAY,SAAS,YAAY,EAC7D,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,qBAAqB,CAAC,YAAY,CAAC;IAYpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,cAAc,CAAC,YAAY,SAAS,YAAY,EAClD,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC;CAcrD"}

package/dist/services/jsonFileStorage.js

@@ -48,7 +48,7 @@ class JsonFileStorage {
         return (this.cache.get(key) ?? {});
     }
     async save(data, key) {
-        this.cache.delete(key);
+        this.cache.set(key, data);
         const targetPath = this.buidPathFromKey(key);
         const folderName = (0, path_1.dirname)(targetPath);
         if (!(0, fs_1.existsSync)(folderName)) {

package/dist/services/telegramApi.d.ts

@@ -1,13 +1,8 @@
 import { ChatContext } from '../entities/context/chatContext';
 import { MessageContext } from '../entities/context/messageContext';
 import { IStorageClient } from '../types/storage';
-import { Reaction } from '../entities/responses/reaction';
 import { IncomingMessage } from '../entities/incomingMessage';
 import { BotResponse } from '../types/response';
-import { UnpinResponse } from '../entities/responses/unpin';
-import { TextMessage } from '../entities/responses/textMessage';
-import { VideoMessage } from '../entities/responses/videoMessage';
-import { ImageMessage } from '../entities/responses/imageMessage';
 import { Telegram } from 'telegraf/typings/telegram';
 import { ScheduledAction } from '../entities/actions/scheduledAction';
 import { IActionState } from '../types/actionState';
@@ -19,18 +14,12 @@ export declare class TelegramApiService {
     telegram: Telegram;
     chats: Record<number, string>;
     storage: IStorageClient;
-    interactions: IBotApiInteractions;
     constructor(botName: string, telegram: Telegram, storage: IStorageClient, chats: Record<string, number>);
+    enqueueBatchedResponses(responses: BotResponse[]): void;
     flushResponses(): Promise<void>;
     private pinIfShould;
     private processResponse;
-    private enqueue;
     initializeContextForMessage<TActionState extends IActionState>(ctx: MessageContext<TActionState>, incomingMessage: IncomingMessage, command: CommandAction<TActionState>): MessageContext<TActionState>;
     initializeContextForChat<TActionState extends IActionState>(ctx: ChatContext<TActionState>, chatId: number, scheduledAction: ScheduledAction<TActionState>): ChatContext<TActionState>;
 }
-export interface IBotApiInteractions {
-    respond: (response: TextMessage | VideoMessage | ImageMessage) => void;
-    react: (reaction: Reaction) => void;
-    unpin: (unpinMessage: UnpinResponse) => void;
-}
 //# sourceMappingURL=telegramApi.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"telegramApi.d.ts","sourceRoot":"","sources":["../../services/telegramApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAIlE,qBAAa,kBAAkB;IAC3B,UAAU,UAAS;IACnB,YAAY,EAAE,WAAW,EAAE,CAAM;IAEjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,mBAAmB,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAc3B,cAAc;YA2BN,WAAW;YAqBX,eAAe;IA2E7B,OAAO,CAAC,OAAO;IAIf,2BAA2B,CAAC,YAAY,SAAS,YAAY,EACzD,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC,EACjC,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC;IAWxC,wBAAwB,CAAC,YAAY,SAAS,YAAY,EACtD,GAAG,EAAE,WAAW,CAAC,YAAY,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,CAAC,YAAY,CAAC;CAYrD;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,KAAK,IAAI,CAAC;IACvE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,YAAY,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD"}
+{"version":3,"file":"telegramApi.d.ts","sourceRoot":"","sources":["../../services/telegramApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAIlE,qBAAa,kBAAkB;IAC3B,UAAU,UAAS;IACnB,YAAY,EAAE,WAAW,EAAE,CAAM;IAEjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQjC,uBAAuB,CAAC,SAAS,EAAE,WAAW,EAAE;IAM1C,cAAc;YA2BN,WAAW;YAqBX,eAAe;IA2E7B,2BAA2B,CAAC,YAAY,SAAS,YAAY,EACzD,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC,EACjC,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC;IAUxC,wBAAwB,CAAC,YAAY,SAAS,YAAY,EACtD,GAAG,EAAE,WAAW,CAAC,YAAY,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,CAAC,YAAY,CAAC;CAWrD"}

package/dist/services/telegramApi.js

@@ -13,11 +13,11 @@ class TelegramApiService {
         this.botName = botName;
         this.chats = (0, inverseRecord_1.inverseRecord)(chats);
         this.storage = storage;
-        this.interactions = {
-            react: (reaction) => this.enqueue(reaction),
-            respond: (response) => this.enqueue(response),
-            unpin: (unpinMessage) => this.enqueue(unpinMessage)
-        };
+    }
+    enqueueBatchedResponses(responses) {
+        for (const response of responses) {
+            this.messageQueue.push(response);
+        }
     }
     async flushResponses() {
         if (this.isFlushing)
@@ -87,14 +87,11 @@ class TelegramApiService {
                 break;
         }
     }
-    enqueue(response) {
-        this.messageQueue.push(response);
-    }
     initializeContextForMessage(ctx, incomingMessage, command) {
-        return ctx.initializeMessageContext(this.botName, command, this.interactions, incomingMessage, this.storage);
+        return ctx.initializeMessageContext(this.botName, command, incomingMessage, this.storage);
     }
     initializeContextForChat(ctx, chatId, scheduledAction) {
-        return ctx.initializeChatContext(this.botName, scheduledAction, this.interactions, chatId, this.chats[chatId], `Scheduled:${scheduledAction.key}:${chatId}`, this.storage);
+        return ctx.initializeChatContext(this.botName, scheduledAction, chatId, this.chats[chatId], `Scheduled:${scheduledAction.key}:${chatId}`, this.storage);
     }
 }
 exports.TelegramApiService = TelegramApiService;

package/dist/types/actionWithState.d.ts

@@ -2,8 +2,8 @@ import { IActionState } from './actionState';
 export type ActionKey = string & {
     __brand: 'actionKey';
 };
-export interface IActionWithState {
+export interface IActionWithState<TActionState extends IActionState> {
     key: ActionKey;
-    stateConstructor: () => IActionState;
+    stateConstructor: () => TActionState;
 }
 //# sourceMappingURL=actionWithState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"actionWithState.d.ts","sourceRoot":"","sources":["../../types/actionWithState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,SAAS,CAAC;IACf,gBAAgB,EAAE,MAAM,YAAY,CAAC;CACxC"}
+{"version":3,"file":"actionWithState.d.ts","sourceRoot":"","sources":["../../types/actionWithState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,gBAAgB,CAAC,YAAY,SAAS,YAAY;IAC/D,GAAG,EAAE,SAAS,CAAC;IACf,gBAAgB,EAAE,MAAM,YAAY,CAAC;CACxC"}

package/dist/types/response.d.ts

@@ -1,8 +1,10 @@
+import { DelayResponse } from '../entities/responses/delay';
 import { ImageMessage } from '../entities/responses/imageMessage';
 import { Reaction } from '../entities/responses/reaction';
 import { TextMessage } from '../entities/responses/textMessage';
 import { UnpinResponse } from '../entities/responses/unpin';
 import { VideoMessage } from '../entities/responses/videoMessage';
+import { IActionState } from './actionState';
 import { IActionWithState } from './actionWithState';
 export declare const BotResponseTypes: {
     readonly unpin: "unpin";
@@ -10,13 +12,14 @@ export declare const BotResponseTypes: {
     readonly image: "image";
     readonly video: "video";
     readonly react: "react";
+    readonly delay: "delay";
 };
-export type BotResponse = UnpinResponse | Reaction | TextMessage | VideoMessage | ImageMessage;
+export type BotResponse = UnpinResponse | Reaction | TextMessage | VideoMessage | DelayResponse | ImageMessage;
 export interface IChatResponse {
     kind: keyof typeof BotResponseTypes;
     chatId: number;
     traceId: number | string;
-    action: IActionWithState;
+    action: IActionWithState<IActionState>;
 }
 export interface IReplyMessage<TType> extends IChatResponse {
     content: TType;

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

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../types/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAEX,MAAM,MAAM,WAAW,GACjB,aAAa,GACb,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,YAAY,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,OAAO,gBAAgB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,CAAE,SAAQ,aAAa;IACvD,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../types/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAEX,MAAM,MAAM,WAAW,GACjB,aAAa,GACb,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,OAAO,gBAAgB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,CAAE,SAAQ,aAAa;IACvD,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACtB"}

package/dist/types/response.js

@@ -6,5 +6,6 @@ exports.BotResponseTypes = {
     text: 'text',
     image: 'image',
     video: 'video',
-    react: 'react'
+    react: 'react',
+    delay: 'delay'
 };

package/dist/types/storage.d.ts

@@ -2,11 +2,11 @@ import { ActionExecutionResult } from '../entities/actionExecutionResult';
 import { IActionState } from './actionState';
 import { ActionKey, IActionWithState } from './actionWithState';
 export interface IStorageClient {
-    updateStateFor<TActionState extends IActionState>(action: IActionWithState, chatId: number, update: (state: TActionState) => Promise<void>): Promise<void>;
+    updateStateFor<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number, update: (state: TActionState) => Promise<void>): Promise<void>;
     close(): Promise<void>;
     load<TActionState extends IActionState>(key: ActionKey): Promise<Record<number, TActionState>>;
-    saveMetadata(actions: IActionWithState[], botName: string): Promise<void>;
-    getActionState<TActionState extends IActionState>(action: IActionWithState, chatId: number): Promise<TActionState>;
-    saveActionExecutionResult(action: IActionWithState, chatId: number, transactionResult: ActionExecutionResult): Promise<void>;
+    saveMetadata<TActionState extends IActionState>(actions: IActionWithState<TActionState>[], botName: string): Promise<void>;
+    getActionState<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number): Promise<TActionState>;
+    saveActionExecutionResult<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number, transactionResult: ActionExecutionResult<TActionState>): Promise<void>;
 }
 //# sourceMappingURL=storage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../types/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC3B,cAAc,CAAC,YAAY,SAAS,YAAY,EAC5C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,YAAY,SAAS,YAAY,EAClC,GAAG,EAAE,SAAS,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACzC,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,cAAc,CAAC,YAAY,SAAS,YAAY,EAC5C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,yBAAyB,CACrB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,qBAAqB,GACzC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../types/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC3B,cAAc,CAAC,YAAY,SAAS,YAAY,EAC5C,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,YAAY,SAAS,YAAY,EAClC,GAAG,EAAE,SAAS,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACzC,YAAY,CAAC,YAAY,SAAS,YAAY,EAC1C,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,EAAE,EACzC,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CAAC,YAAY,SAAS,YAAY,EAC5C,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,yBAAyB,CAAC,YAAY,SAAS,YAAY,EACvD,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,qBAAqB,CAAC,YAAY,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB"}

package/entities/actionExecutionResult.ts

@@ -1,10 +1,10 @@
 import { IActionState } from '../types/actionState';
 
-export class ActionExecutionResult {
-    data: IActionState;
+export class ActionExecutionResult<TActionState extends IActionState> {
+    data: TActionState;
     shouldUpdate: boolean;
 
-    constructor(data: IActionState, shouldUpdate: boolean) {
+    constructor(data: TActionState, shouldUpdate: boolean) {
         this.data = data;
         this.shouldUpdate = shouldUpdate;
     }

package/entities/actions/commandAction.ts

@@ -13,7 +13,7 @@ import { ActionExecutionResult } from '../actionExecutionResult';
 import { CommandTrigger } from '../../types/commandTrigger';
 
 export class CommandAction<TActionState extends IActionState>
-    implements IActionWithState
+    implements IActionWithState<TActionState>
 {
     triggers: CommandTrigger[];
     handler: CommandHandler<TActionState>;
@@ -51,13 +51,16 @@ export class CommandAction<TActionState extends IActionState>
     }
 
     async exec(ctx: MessageContext<TActionState>) {
-        if (!ctx.isInitialized) throw new Error('Context is not initialized');
+        if (!ctx.isInitialized)
+            throw new Error(
+                `Context for ${this.key} is not initialized or already consumed`
+            );
 
-        if (!this.active || this.chatsBlacklist.includes(ctx.chatId)) return;
+        if (!this.active || this.chatsBlacklist.includes(ctx.chatId)) return [];
 
         const isConditionMet = await this.condition(ctx);
 
-        if (!isConditionMet) return;
+        if (!isConditionMet) return [];
 
         const state = await ctx.storage.getActionState<TActionState>(
             this,
@@ -71,7 +74,7 @@ export class CommandAction<TActionState extends IActionState>
                 CommandTriggerCheckResult.DoNotTrigger
             );
 
-        if (!shouldTrigger) return;
+        if (!shouldTrigger) return [];
 
         Logger.logWithTraceId(
             ctx.botName,
@@ -98,6 +101,10 @@ export class CommandAction<TActionState extends IActionState>
             ctx.chatId,
             new ActionExecutionResult(state, ctx.startCooldown && shouldTrigger)
         );
+
+        ctx.isInitialized = false;
+
+        return ctx.responses;
     }
 
     private checkTrigger(

package/entities/actions/scheduledAction.ts

@@ -12,7 +12,7 @@ import { Logger } from '../../services/logger';
 import { Scheduler } from '../../services/taskScheduler';
 
 export class ScheduledAction<TActionState extends IActionState>
-    implements IActionWithState
+    implements IActionWithState<TActionState>
 {
     static locks = new Map<string, Semaphore>();
 
@@ -47,9 +47,13 @@ export class ScheduledAction<TActionState extends IActionState>
     }
 
     async exec(ctx: ChatContext<TActionState>) {
-        if (!ctx.isInitialized) throw new Error('Context is not initialized');
+        if (!ctx.isInitialized)
+            throw new Error(
+                `Context for ${this.key} is not initialized or already consumed`
+            );
 
-        if (!this.active || !this.chatsWhitelist.includes(ctx.chatId)) return;
+        if (!this.active || !this.chatsWhitelist.includes(ctx.chatId))
+            return [];
 
         const state = await ctx.storage.getActionState<TActionState>(
             this,
@@ -81,6 +85,10 @@ export class ScheduledAction<TActionState extends IActionState>
                 new ActionExecutionResult(state, isAllowedToTrigger)
             );
         }
+
+        ctx.isInitialized = false;
+
+        return ctx.responses;
     }
 
     private async getCachedValue<TResult>(

package/entities/botInstance.ts

@@ -169,7 +169,8 @@ export class BotInstance {
                 this.api.initializeContextForChat(ctx, chatId, scheduledAction);
 
                 try {
-                    await scheduledAction.exec(ctx);
+                    const responses = await scheduledAction.exec(ctx);
+                    this.api.enqueueBatchedResponses(responses);
                 } catch (error) {
                     Logger.errorWithTraceId(
                         ctx.botName,
@@ -192,7 +193,8 @@ export class BotInstance {
             this.api.initializeContextForMessage(ctx, msg, commandAction);
 
             try {
-                await commandAction.exec(ctx);
+                const responses = await commandAction.exec(ctx);
+                this.api.enqueueBatchedResponses(responses);
             } catch (error) {
                 Logger.errorWithTraceId(
                     ctx.botName,

package/entities/context/chatContext.ts

@@ -1,5 +1,4 @@
 import { resolve } from 'path';
-import { IBotApiInteractions } from '../../services/telegramApi';
 import { IStorageClient } from '../../types/storage';
 import { ImageMessage } from '../responses/imageMessage';
 import { TextMessage } from '../responses/textMessage';
@@ -10,13 +9,16 @@ import {
     TextMessageSendingOptions
 } from '../../types/messageSendingOptions';
 import { IActionWithState } from '../../types/actionWithState';
+import { IActionState } from '../../types/actionState';
+import { BotResponse } from '../../types/response';
+import { Milliseconds } from '../../types/timeValues';
+import { DelayResponse } from '../responses/delay';
 
 /**
  * Context of action executed in chat.
  */
-export class ChatContext<TActionState> {
-    protected action!: IActionWithState;
-    protected interactions!: IBotApiInteractions;
+export class ChatContext<TActionState extends IActionState> {
+    protected action!: IActionWithState<TActionState>;
     updateActions: Array<(state: TActionState) => void> = [];
     /** Trace id of a action execution. */
     traceId!: number | string;
@@ -28,6 +30,8 @@ export class ChatContext<TActionState> {
     chatName!: string;
     /** Storage client instance for this bot. */
     storage!: IStorageClient;
+    /** Ordered collection of responses to be processed  */
+    responses: BotResponse[] = [];
 
     isInitialized = false;
 
@@ -35,8 +39,7 @@ export class ChatContext<TActionState> {
 
     initializeChatContext(
         botName: string,
-        action: IActionWithState,
-        interactions: IBotApiInteractions,
+        action: IActionWithState<TActionState>,
         chatId: number,
         chatName: string,
         traceId: number | string,
@@ -44,7 +47,6 @@ export class ChatContext<TActionState> {
     ) {
         this.botName = botName;
         this.action = action;
-        this.interactions = interactions;
         this.chatId = chatId;
         this.chatName = chatName;
         this.traceId = traceId;
@@ -52,6 +54,7 @@ export class ChatContext<TActionState> {
 
         this.updateActions = [];
         this.isInitialized = true;
+        this.responses = [];
 
         return this;
     }
@@ -65,12 +68,13 @@ export class ChatContext<TActionState> {
     }
 
     /**
-     * Sends text message to chat.
+     * Sends text message to chat after action execution is finished.
+     * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
      * @param text Message contents.
      * @param options Message sending option.
      */
     sendTextToChat(text: string, options?: TextMessageSendingOptions) {
-        this.interactions.respond(
+        this.responses.push(
             new TextMessage(
                 text,
                 this.chatId,
@@ -83,13 +87,14 @@ export class ChatContext<TActionState> {
     }
 
     /**
-     * Sends image message to chat.
+     * Sends image message to chat after action execution is finished.
+     * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
      * @param name Message contents.
      * @param options Message sending option.
      */
     sendImageToChat(name: string, options?: MessageSendingOptions) {
         const filePath = `./content/${name}.png`;
-        this.interactions.respond(
+        this.responses.push(
             new ImageMessage(
                 { source: resolve(filePath) },
                 this.chatId,
@@ -102,13 +107,14 @@ export class ChatContext<TActionState> {
     }
 
     /**
-     * Sends video/gif message to chat.
+     * Sends video/gif message to chat after action execution is finished.
+     * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
      * @param name Message contents.
      * @param options Message sending option.
      */
     sendVideoToChat(name: string, options?: MessageSendingOptions) {
         const filePath = `./content/${name}.mp4`;
-        this.interactions.respond(
+        this.responses.push(
             new VideoMessage(
                 { source: resolve(filePath) },
                 this.chatId,
@@ -121,12 +127,23 @@ export class ChatContext<TActionState> {
     }
 
     /**
-     * Unpins message.
+     * Unpins message after action execution is finished.
+     * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
      * @param messageId Message id.
      */
     unpinMessage(messageId: number) {
-        this.interactions.unpin(
+        this.responses.push(
             new UnpinResponse(messageId, this.chatId, this.traceId, this.action)
         );
     }
+
+    /**
+     * Delays next response by specified amount of time.
+     * @param delay Delay in milliseconds.
+     */
+    delayNextResponse(delay: Milliseconds) {
+        this.responses.push(
+            new DelayResponse(delay, this.chatId, this.traceId, this.action)
+        );
+    }
 }

package/entities/context/messageContext.ts

@@ -1,5 +1,4 @@
 import { resolve } from 'path';
-import { IBotApiInteractions } from '../../services/telegramApi';
 import { TelegramEmoji } from 'telegraf/types';
 import { IStorageClient } from '../../types/storage';
 import { IActionState } from '../../types/actionState';
@@ -16,7 +15,6 @@ import {
 } from '../../types/messageSendingOptions';
 import { IActionWithState, ActionKey } from '../../types/actionWithState';
 import { MessageTypeValue } from '../../types/messageTypes';
-
 /**
  * Context of action executed in chat, in response to a message
  */
@@ -44,8 +42,7 @@ export class MessageContext<
 
     initializeMessageContext(
         botName: string,
-        action: IActionWithState,
-        interactions: IBotApiInteractions,
+        action: IActionWithState<TActionState>,
         message: IncomingMessage,
         storage: IStorageClient
     ) {
@@ -63,7 +60,6 @@ export class MessageContext<
         return this.initializeChatContext(
             botName,
             action,
-            interactions,
             message.chat.id,
             message.chatName,
             message.traceId,
@@ -94,12 +90,13 @@ export class MessageContext<
     }
 
     /**
-     * Reply with text message to message that triggered this action.
+     * Reply with text message to message that triggered this action after action execution is finished.
+     * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
      * @param text Message contents.
      * @param options Message sending option.
      */
     replyWithText(text: string, options?: TextMessageSendingOptions) {
-        this.interactions.respond(
+        this.responses.push(
             new TextMessage(
                 text,
                 this.chatId,
@@ -112,13 +109,14 @@ export class MessageContext<
     }
 
     /**
-     * Reply with image message to message that triggered this action.
+     * Reply with image message to message that triggered this action after action execution is finished.
+     * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
      * @param text Message contents.
      * @param options Message sending option.
      */
     replyWithImage(name: string, options?: MessageSendingOptions) {
         const filePath = `./content/${name}.png`;
-        this.interactions.respond(
+        this.responses.push(
             new ImageMessage(
                 { source: resolve(filePath) },
                 this.chatId,
@@ -131,13 +129,14 @@ export class MessageContext<
     }
 
     /**
-     * Reply with video/gif message to message that triggered this action.
+     * Reply with video/gif message to message that triggered this action after action execution is finished.
+     * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
      * @param text Message contents.
      * @param options Message sending option.
      */
     replyWithVideo(name: string, options?: MessageSendingOptions) {
         const filePath = `./content/${name}.mp4`;
-        this.interactions.respond(
+        this.responses.push(
             new VideoMessage(
                 { source: resolve(filePath) },
                 this.chatId,
@@ -150,11 +149,12 @@ export class MessageContext<
     }
 
     /**
-     * React to the message that triggered this action.
+     * React to the message that triggered this action after action execution is finished.
+     * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
      * @param emoji Telegram emoji to react with.
      */
     react(emoji: TelegramEmoji) {
-        this.interactions.react(
+        this.responses.push(
             new Reaction(
                 this.traceId,
                 this.chatId,

package/entities/responses/delay.ts

@@ -0,0 +1,25 @@
+import { IActionState } from '../../types/actionState';
+import { IActionWithState } from '../../types/actionWithState';
+import { BotResponseTypes, IChatResponse } from '../../types/response';
+import { Milliseconds } from '../../types/timeValues';
+
+export class DelayResponse implements IChatResponse {
+    kind = BotResponseTypes.delay;
+
+    chatId: number;
+    traceId: number | string;
+    delay: Milliseconds;
+    action: IActionWithState<IActionState>;
+
+    constructor(
+        delay: Milliseconds,
+        chatId: number,
+        traceId: number | string,
+        action: IActionWithState<IActionState>
+    ) {
+        this.chatId = chatId;
+        this.delay = delay;
+        this.traceId = traceId;
+        this.action = action;
+    }
+}

package/entities/responses/imageMessage.ts

@@ -2,6 +2,7 @@ import { InputFile } from 'telegraf/types';
 import { BotResponseTypes, IReplyMessage } from '../../types/response';
 import { MessageSendingOptions } from '../../types/messageSendingOptions';
 import { IActionWithState } from '../../types/actionWithState';
+import { IActionState } from '../../types/actionState';
 
 export class ImageMessage implements IReplyMessage<InputFile> {
     kind = BotResponseTypes.image;
@@ -12,14 +13,14 @@ export class ImageMessage implements IReplyMessage<InputFile> {
     traceId: string | number;
     disableWebPreview = false;
     shouldPin: boolean;
-    action: IActionWithState;
+    action: IActionWithState<IActionState>;
 
     constructor(
         image: InputFile,
         chatId: number,
         replyId: number | undefined,
         traceId: number | string,
-        action: IActionWithState,
+        action: IActionWithState<IActionState>,
         options?: MessageSendingOptions
     ) {
         this.content = image;

package/entities/responses/reaction.ts

@@ -1,6 +1,7 @@
 import { TelegramEmoji } from 'telegraf/types';
 import { BotResponseTypes, IChatResponse } from '../../types/response';
 import { IActionWithState } from '../../types/actionWithState';
+import { IActionState } from '../../types/actionState';
 
 export class Reaction implements IChatResponse {
     kind = BotResponseTypes.react;
@@ -9,14 +10,14 @@ export class Reaction implements IChatResponse {
     messageId: number;
     traceId: number | string;
     emoji: TelegramEmoji;
-    action: IActionWithState;
+    action: IActionWithState<IActionState>;
 
     constructor(
         traceId: number | string,
         chatId: number,
         messageId: number,
         emoji: TelegramEmoji,
-        action: IActionWithState
+        action: IActionWithState<IActionState>
     ) {
         this.chatId = chatId;
         this.messageId = messageId;