chz-telegram-bot 0.0.45 → 0.0.47

package/dist/services/telegramApi.d.ts

@@ -0,0 +1,36 @@
+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';
+import { CommandAction } from '../entities/actions/commandAction';
+export declare class TelegramApiService {
+    isFlushing: boolean;
+    messageQueue: BotResponse[];
+    botName: string;
+    telegram: Telegram;
+    chats: Record<number, string>;
+    storage: IStorageClient;
+    interactions: IBotApiInteractions;
+    constructor(botName: string, telegram: Telegram, storage: IStorageClient, chats: Record<string, number>);
+    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

@@ -0,0 +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"}

package/dist/services/telegramApi.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramApiService = void 0;
+const inverseRecord_1 = require("../helpers/inverseRecord");
+const logger_1 = require("./logger");
+const promises_1 = require("timers/promises");
+const TELEGRAM_RATELIMIT_DELAY = 35;
+class TelegramApiService {
+    constructor(botName, telegram, storage, chats) {
+        this.isFlushing = false;
+        this.messageQueue = [];
+        this.telegram = telegram;
+        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)
+        };
+    }
+    async flushResponses() {
+        if (this.isFlushing)
+            return;
+        this.isFlushing = true;
+        while (this.messageQueue.length) {
+            const message = this.messageQueue.pop();
+            if (!message)
+                break;
+            try {
+                await this.processResponse(message);
+                await (0, promises_1.setTimeout)(TELEGRAM_RATELIMIT_DELAY);
+            }
+            catch (error) {
+                logger_1.Logger.errorWithTraceId(this.botName, message.traceId, this.chats[message.chatId], error, message);
+            }
+        }
+        this.isFlushing = false;
+    }
+    async pinIfShould(response, sentMessage) {
+        if (response.shouldPin) {
+            await this.telegram.pinChatMessage(response.chatId, sentMessage.message_id, { disable_notification: true });
+            await this.storage.updateStateFor(response.action, response.chatId, async (state) => {
+                state.pinnedMessages.push(sentMessage.message_id);
+            });
+        }
+    }
+    async processResponse(response) {
+        let sentMessage;
+        switch (response.kind) {
+            case 'text':
+                sentMessage = await this.telegram.sendMessage(response.chatId, response.content, {
+                    reply_to_message_id: response.replyId,
+                    parse_mode: 'MarkdownV2',
+                    disable_web_page_preview: response.disableWebPreview
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                });
+                await this.pinIfShould(response, sentMessage);
+                break;
+            case 'image':
+                sentMessage = await this.telegram.sendPhoto(response.chatId, response.content, response.replyId
+                    ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        { reply_to_message_id: response.replyId }
+                    : undefined);
+                await this.pinIfShould(response, sentMessage);
+                break;
+            case 'video':
+                sentMessage = await this.telegram.sendVideo(response.chatId, response.content, response.replyId
+                    ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        { reply_to_message_id: response.replyId }
+                    : undefined);
+                await this.pinIfShould(response, sentMessage);
+                break;
+            case 'react':
+                await this.telegram.setMessageReaction(response.chatId, response.messageId, [
+                    {
+                        type: 'emoji',
+                        emoji: response.emoji
+                    }
+                ], true);
+                return;
+            case 'unpin':
+                await this.telegram.unpinChatMessage(response.chatId, response.messageId);
+                await this.storage.updateStateFor(response.action, response.chatId, async (state) => {
+                    state.pinnedMessages = state.pinnedMessages.filter((x) => x != response.messageId);
+                });
+                break;
+        }
+    }
+    enqueue(response) {
+        this.messageQueue.push(response);
+    }
+    initializeContextForMessage(ctx, incomingMessage, command) {
+        return ctx.initializeMessageContext(this.botName, command, this.interactions, 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);
+    }
+}
+exports.TelegramApiService = TelegramApiService;

package/dist/types/actionState.d.ts

@@ -0,0 +1,5 @@
+export interface IActionState {
+    lastExecutedDate: number;
+    pinnedMessages: number[];
+}
+//# sourceMappingURL=actionState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actionState.d.ts","sourceRoot":"","sources":["../../types/actionState.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/types/actionState.js

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

package/dist/types/actionWithState.d.ts

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

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

@@ -0,0 +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,CAAC,YAAY,SAAS,YAAY;IAC/D,GAAG,EAAE,SAAS,CAAC;IACf,gBAAgB,EAAE,MAAM,YAAY,CAAC;CACxC"}

package/dist/types/actionWithState.js

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

package/dist/types/cachedValueAccessor.d.ts

@@ -0,0 +1,2 @@
+export type CachedValueAccessor = <TResult>(key: string) => Promise<TResult>;
+//# sourceMappingURL=cachedValueAccessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cachedValueAccessor.d.ts","sourceRoot":"","sources":["../../types/cachedValueAccessor.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/types/cachedValueAccessor.js

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

package/dist/types/commandCondition.d.ts

@@ -0,0 +1,4 @@
+import { MessageContext } from '../entities/context/messageContext';
+import { IActionState } from './actionState';
+export type CommandCondition<TActionState extends IActionState> = (ctx: MessageContext<TActionState>) => Promise<boolean>;
+//# sourceMappingURL=commandCondition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commandCondition.d.ts","sourceRoot":"","sources":["../../types/commandCondition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,gBAAgB,CAAC,YAAY,SAAS,YAAY,IAAI,CAC9D,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC,KAChC,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/types/commandCondition.js

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

package/dist/types/commandTrigger.d.ts

@@ -0,0 +1,3 @@
+import { MessageTypeValue } from './messageTypes';
+export type CommandTrigger = MessageTypeValue | string | RegExp;
+//# sourceMappingURL=commandTrigger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commandTrigger.d.ts","sourceRoot":"","sources":["../../types/commandTrigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/dist/types/commandTrigger.js

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

package/dist/types/daysOfTheWeek.d.ts

@@ -0,0 +1,10 @@
+export declare enum Day {
+    Sunday = 0,
+    Monday = 1,
+    Tuesday = 2,
+    Wednesday = 3,
+    Thursday = 4,
+    Friday = 5,
+    Saturday = 6
+}
+//# sourceMappingURL=daysOfTheWeek.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daysOfTheWeek.d.ts","sourceRoot":"","sources":["../../types/daysOfTheWeek.ts"],"names":[],"mappings":"AAAA,oBAAY,GAAG;IACX,MAAM,IAAI;IACV,MAAM,IAAI;IACV,OAAO,IAAI;IACX,SAAS,IAAI;IACb,QAAQ,IAAI;IACZ,MAAM,IAAI;IACV,QAAQ,IAAI;CACf"}

package/dist/types/daysOfTheWeek.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Day = void 0;
+var Day;
+(function (Day) {
+    Day[Day["Sunday"] = 0] = "Sunday";
+    Day[Day["Monday"] = 1] = "Monday";
+    Day[Day["Tuesday"] = 2] = "Tuesday";
+    Day[Day["Wednesday"] = 3] = "Wednesday";
+    Day[Day["Thursday"] = 4] = "Thursday";
+    Day[Day["Friday"] = 5] = "Friday";
+    Day[Day["Saturday"] = 6] = "Saturday";
+})(Day || (exports.Day = Day = {}));

package/dist/types/handlers.d.ts

@@ -0,0 +1,17 @@
+import { ChatContext } from '../entities/context/chatContext';
+import { MessageContext } from '../entities/context/messageContext';
+import { IActionState } from './actionState';
+import { CachedValueAccessor } from './cachedValueAccessor';
+export type CommandHandler<TActionState extends IActionState> = (
+/** Context of action executed in chat, in response to a message. */
+ctx: MessageContext<TActionState>, 
+/** State of an action being executed. */
+state: TActionState) => Promise<void>;
+export type ScheduledHandler<TActionState extends IActionState> = (
+/** Context of action executed in chat. */
+ctx: ChatContext<TActionState>, 
+/** Function that will attempt to get value from cache. If there is no value found, corresponding cached state factory will be called. */
+getCached: CachedValueAccessor, 
+/** State of an action being executed. */
+state: TActionState) => Promise<void>;
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +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;AAC5D,oEAAoE;AACpE,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC;AACjC,yCAAyC;AACzC,KAAK,EAAE,YAAY,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,gBAAgB,CAAC,YAAY,SAAS,YAAY,IAAI;AAC9D,0CAA0C;AAC1C,GAAG,EAAE,WAAW,CAAC,YAAY,CAAC;AAC9B,yIAAyI;AACzI,SAAS,EAAE,mBAAmB;AAC9B,yCAAyC;AACzC,KAAK,EAAE,YAAY,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/types/handlers.js

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

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/dist/types/messageTypes.d.ts

@@ -0,0 +1,16 @@
+export declare const MessageType: {
+    readonly Text: "__msg:Text";
+    readonly Sticker: "__msg:Sticker";
+    readonly Animation: "__msg:Animation";
+    readonly Document: "__msg:Document";
+    readonly Voice: "__msg:Voice";
+    readonly Audio: "__msg:Audio";
+    readonly LeftChatMember: "__msg:LeftChatMember";
+    readonly NewChatMember: "__msg:NewChatMember";
+    readonly Poll: "__msg:Poll";
+    readonly Location: "__msg:Location";
+    readonly Photo: "__msg:Photo";
+    readonly Unknown: "__msg:Unknown";
+};
+export type MessageTypeValue = (typeof MessageType)[keyof typeof MessageType];
+//# sourceMappingURL=messageTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messageTypes.d.ts","sourceRoot":"","sources":["../../types/messageTypes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAad,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}

package/dist/types/messageTypes.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageType = void 0;
+exports.MessageType = {
+    Text: '__msg:Text',
+    Sticker: '__msg:Sticker',
+    Animation: '__msg:Animation',
+    Document: '__msg:Document',
+    Voice: '__msg:Voice',
+    Audio: '__msg:Audio',
+    LeftChatMember: '__msg:LeftChatMember',
+    NewChatMember: '__msg:NewChatMember',
+    Poll: '__msg:Poll',
+    Location: '__msg:Location',
+    Photo: '__msg:Photo',
+    Unknown: '__msg:Unknown'
+};

package/dist/types/replyMessage.d.ts

@@ -0,0 +1,8 @@
+export interface IReplyMessage<TType> {
+    content: TType;
+    chatId: number;
+    replyId: number | undefined;
+    traceId: number | string;
+    disableWebPreview: boolean;
+}
+//# sourceMappingURL=replyMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replyMessage.d.ts","sourceRoot":"","sources":["../../types/replyMessage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa,CAAC,KAAK;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;CAC9B"}

package/dist/types/replyMessage.js

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

package/dist/types/response.d.ts

@@ -0,0 +1,28 @@
+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";
+    readonly text: "text";
+    readonly image: "image";
+    readonly video: "video";
+    readonly react: "react";
+};
+export type BotResponse = UnpinResponse | Reaction | TextMessage | VideoMessage | ImageMessage;
+export interface IChatResponse {
+    kind: keyof typeof BotResponseTypes;
+    chatId: number;
+    traceId: number | string;
+    action: IActionWithState<IActionState>;
+}
+export interface IReplyMessage<TType> extends IChatResponse {
+    content: TType;
+    replyId: number | undefined;
+    disableWebPreview: boolean;
+    shouldPin: boolean;
+}
+//# sourceMappingURL=response.d.ts.map

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

@@ -0,0 +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,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,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,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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotResponseTypes = void 0;
+exports.BotResponseTypes = {
+    unpin: 'unpin',
+    text: 'text',
+    image: 'image',
+    video: 'video',
+    react: 'react'
+};

package/dist/types/storage.d.ts

@@ -0,0 +1,12 @@
+import { ActionExecutionResult } from '../entities/actionExecutionResult';
+import { IActionState } from './actionState';
+import { ActionKey, IActionWithState } from './actionWithState';
+export interface IStorageClient {
+    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<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

@@ -0,0 +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,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/dist/types/storage.js

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

package/dist/types/timeValues.d.ts

@@ -0,0 +1,11 @@
+export type Milliseconds = number & {
+    __brand: 'ms';
+};
+export type Seconds = number & {
+    __brand: 's';
+};
+export type Hours = number & {
+    __brand: 'h';
+};
+export type HoursOfDay = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23;
+//# sourceMappingURL=timeValues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeValues.d.ts","sourceRoot":"","sources":["../../types/timeValues.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AACtD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC;AAChD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,UAAU,GAChB,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,CAAC"}

package/dist/types/timeValues.js

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

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,7 +51,10 @@ 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;
 
@@ -98,6 +101,8 @@ export class CommandAction<TActionState extends IActionState>
             ctx.chatId,
             new ActionExecutionResult(state, ctx.startCooldown && shouldTrigger)
         );
+
+        ctx.isInitialized = false;
     }
 
     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,7 +47,10 @@ 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;
 
@@ -81,6 +84,8 @@ export class ScheduledAction<TActionState extends IActionState>
                 new ActionExecutionResult(state, isAllowedToTrigger)
             );
         }
+
+        ctx.isInitialized = false;
     }
 
     private async getCachedValue<TResult>(

package/entities/context/chatContext.ts

@@ -10,12 +10,13 @@ import {
     TextMessageSendingOptions
 } from '../../types/messageSendingOptions';
 import { IActionWithState } from '../../types/actionWithState';
+import { IActionState } from '../../types/actionState';
 
 /**
  * Context of action executed in chat.
  */
-export class ChatContext<TActionState> {
-    protected action!: IActionWithState;
+export class ChatContext<TActionState extends IActionState> {
+    protected action!: IActionWithState<TActionState>;
     protected interactions!: IBotApiInteractions;
     updateActions: Array<(state: TActionState) => void> = [];
     /** Trace id of a action execution. */
@@ -35,7 +36,7 @@ export class ChatContext<TActionState> {
 
     initializeChatContext(
         botName: string,
-        action: IActionWithState,
+        action: IActionWithState<TActionState>,
         interactions: IBotApiInteractions,
         chatId: number,
         chatName: string,

package/entities/context/messageContext.ts

@@ -44,7 +44,7 @@ export class MessageContext<
 
     initializeMessageContext(
         botName: string,
-        action: IActionWithState,
+        action: IActionWithState<TActionState>,
         interactions: IBotApiInteractions,
         message: IncomingMessage,
         storage: IStorageClient

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;

package/entities/responses/textMessage.ts

@@ -1,6 +1,7 @@
 import { TextMessageSendingOptions } from '../../types/messageSendingOptions';
 import { BotResponseTypes, IReplyMessage } from '../../types/response';
 import { IActionWithState } from '../../types/actionWithState';
+import { IActionState } from '../../types/actionState';
 
 export class TextMessage implements IReplyMessage<string> {
     kind = BotResponseTypes.text;
@@ -11,14 +12,14 @@ export class TextMessage implements IReplyMessage<string> {
     traceId: string | number;
     disableWebPreview: boolean;
     shouldPin: boolean;
-    action: IActionWithState;
+    action: IActionWithState<IActionState>;
 
     constructor(
         text: string,
         chatId: number,
         replyId: number | undefined,
         traceId: string | number,
-        action: IActionWithState,
+        action: IActionWithState<IActionState>,
         options?: TextMessageSendingOptions
     ) {
         this.content = text;