chz-telegram-bot 0.5.4 → 0.5.5

package/dist/services/telegramApi.js

@@ -0,0 +1,133 @@
+import { ResponseProcessingQueue } from './responseProcessingQueue';
+export const TELEGRAM_ERROR_QUOTE_INVALID = 'QUOTE_TEXT_INVALID';
+export class TelegramApiService {
+    queue = new ResponseProcessingQueue();
+    telegram;
+    storage;
+    logger;
+    captureRegistrationCallback;
+    botName;
+    constructor(botName, telegram, storage, logger, captureRegistrationCallback) {
+        this.telegram = telegram;
+        this.botName = botName;
+        this.storage = storage;
+        this.logger = logger;
+        this.captureRegistrationCallback = captureRegistrationCallback;
+    }
+    enqueueBatchedResponses(responses) {
+        let offset = 0;
+        for (const response of responses) {
+            if (response.kind == 'delay') {
+                offset += response.delay;
+                continue;
+            }
+            const queueItem = {
+                callback: async () => {
+                    const scopedLogger = this.logger.createScope(this.botName, response.traceId, 'chatInfo' in response
+                        ? response.chatInfo.name
+                        : 'Unknown');
+                    try {
+                        await this.processResponse(response);
+                    }
+                    catch (error) {
+                        if ('message' in error) {
+                            const telegramResponse = error;
+                            if (telegramResponse.message.includes(TELEGRAM_ERROR_QUOTE_INVALID)) {
+                                scopedLogger.logWithTraceId('Quote error recieved, retrying without quote');
+                                try {
+                                    await this.processResponse(response, true);
+                                }
+                                catch (error) {
+                                    scopedLogger.errorWithTraceId(error, response);
+                                }
+                                return;
+                            }
+                        }
+                        scopedLogger.errorWithTraceId(error, response);
+                    }
+                },
+                priority: response.createdAt + offset
+            };
+            this.queue.enqueue(queueItem);
+        }
+    }
+    flushResponses() {
+        void this.queue.flushReadyItems();
+    }
+    async pinIfShould(response, message) {
+        if (response.shouldPin) {
+            await this.telegram.pinChatMessage(response.chatInfo.id, message.message_id, { disable_notification: true });
+            await this.storage.updateStateFor(response.action, response.chatInfo.id, (state) => {
+                state.pinnedMessages.push(message.message_id);
+            });
+        }
+    }
+    async processResponse(response, ignoreQuote = false) {
+        const sentMessage = await this.sendApiRequest(response, ignoreQuote);
+        if (sentMessage && 'content' in response) {
+            await this.pinIfShould(response, sentMessage);
+            for (const capture of response.captures) {
+                this.captureRegistrationCallback(capture, sentMessage.message_id, response.chatInfo, response.traceId);
+            }
+        }
+    }
+    async sendApiRequest(response, ignoreQuote) {
+        switch (response.kind) {
+            case 'text':
+                return await this.telegram.sendMessage(response.chatInfo.id, response.content, {
+                    reply_parameters: response.replyInfo
+                        ? {
+                            message_id: response.replyInfo.id,
+                            quote: ignoreQuote
+                                ? undefined
+                                : response.replyInfo.quote
+                        }
+                        : undefined,
+                    parse_mode: 'MarkdownV2',
+                    link_preview_options: {
+                        is_disabled: response.disableWebPreview
+                    },
+                    reply_markup: response.keyboard
+                        ? {
+                            inline_keyboard: response.keyboard
+                        }
+                        : undefined
+                });
+            case 'image':
+                return await this.telegram.sendPhoto(response.chatInfo.id, response.content, 
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                response.replyInfo?.id
+                    ? {
+                        reply_to_message_id: response.replyInfo.id // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    }
+                    : undefined);
+            case 'video':
+                return await this.telegram.sendVideo(response.chatInfo.id, response.content, 
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                response.replyInfo?.id
+                    ? {
+                        reply_to_message_id: response.replyInfo.id // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    }
+                    : undefined);
+            case 'react':
+                await this.telegram.setMessageReaction(response.chatInfo.id, response.messageId, [
+                    {
+                        type: 'emoji',
+                        emoji: response.emoji
+                    }
+                ]);
+                return null;
+            case 'unpin':
+                await this.telegram.unpinChatMessage(response.chatInfo.id, response.messageId);
+                await this.storage.updateStateFor(response.action, response.chatInfo.id, (state) => {
+                    state.pinnedMessages = state.pinnedMessages.filter((x) => x != response.messageId);
+                });
+                return null;
+            case 'inlineQuery':
+                await this.telegram.answerInlineQuery(response.queryId, response.queryResults, { cache_time: 0 });
+                return null;
+            case 'delay':
+                return null;
+        }
+    }
+}

package/dist/types/action.d.ts

@@ -0,0 +1,14 @@
+import { BaseContextInternal } from '../entities/context/baseContext';
+import { IActionState } from './actionState';
+import { BotResponse } from './response';
+export type ActionKey = string & {
+    __brand: 'actionKey';
+};
+export interface IActionWithState<TActionState extends IActionState> extends IAction {
+    readonly stateConstructor: () => TActionState;
+}
+export interface IAction {
+    readonly key: ActionKey;
+    exec(ctx: BaseContextInternal<IAction>): Promise<BotResponse[]>;
+}
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../types/action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,gBAAgB,CAAC,YAAY,SAAS,YAAY,CAC/D,SAAQ,OAAO;IACf,QAAQ,CAAC,gBAAgB,EAAE,MAAM,YAAY,CAAC;CACjD;AAED,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACnE"}

package/dist/types/action.js

@@ -0,0 +1 @@
+export {};

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 @@
+export {};

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 @@
+export {};

package/dist/types/capture.d.ts

@@ -0,0 +1,24 @@
+import { ReplyContext, ReplyContextInternal } from '../entities/context/replyContext';
+import { IActionState } from './actionState';
+import { CommandTrigger } from './commandTrigger';
+import { IAction } from './action';
+export interface ICaptureController {
+    captureReplies: <TParentActionState extends IActionState>(
+    /**
+     * Defines action trigger.
+     * If `string` or `string[]` is provided, will be triggered only on exact message match.
+     * If `RegExp` or `RegExp[]` is provided, will be triggered on successful match.
+     */
+    trigger: CommandTrigger[], 
+    /** Callback that will be called on trigger */
+    handler: (replyContext: ReplyContext<TParentActionState>) => Promise<void>, 
+    /** Abort controller to abort capturing manually */
+    abortController?: AbortController) => void;
+}
+export interface IReplyCapture {
+    trigger: CommandTrigger[];
+    handler: (replyContext: ReplyContextInternal<IActionState>) => Promise<void>;
+    abortController: AbortController;
+    action: IAction;
+}
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../types/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,oBAAoB,EACvB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,CAAC,kBAAkB,SAAS,YAAY;IACpD;;;;OAIG;IACH,OAAO,EAAE,cAAc,EAAE;IACzB,8CAA8C;IAC9C,OAAO,EAAE,CACL,YAAY,EAAE,YAAY,CAAC,kBAAkB,CAAC,KAC7C,OAAO,CAAC,IAAI,CAAC;IAClB,mDAAmD;IACnD,eAAe,CAAC,EAAE,eAAe,KAChC,IAAI,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,CACL,YAAY,EAAE,oBAAoB,CAAC,YAAY,CAAC,KAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/capture.js

@@ -0,0 +1 @@
+export {};

package/dist/types/commandCondition.d.ts

@@ -0,0 +1,8 @@
+import { MessageContext } from '../entities/context/messageContext';
+import { IActionState } from './actionState';
+export type CommandCondition<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) => 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;AAC9D,oEAAoE;AACpE,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC;AACjC,yCAAyC;AACzC,KAAK,EAAE,YAAY,KAClB,OAAO,CAAC"}

package/dist/types/commandCondition.js

@@ -0,0 +1 @@
+export {};

package/dist/types/commandTrigger.d.ts

@@ -0,0 +1,2 @@
+export type CommandTrigger = 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,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/dist/types/commandTrigger.js

@@ -0,0 +1 @@
+export {};

package/dist/types/externalAliases.d.ts

@@ -0,0 +1,11 @@
+import { Telegram, Telegraf } from 'telegraf';
+import { User, Message, InlineQueryResult, UserFromGetMe, TelegramEmoji as Emoji, InlineKeyboardButton } from 'telegraf/types';
+export type TelegramUser = User;
+export type TelegramMessage = Message;
+export type TelegramInlineQueryResult = InlineQueryResult;
+export type TelegramEmoji = Emoji;
+export type TelegramApiClient = Telegram;
+export type BotInfo = UserFromGetMe;
+export type TelegramBot = Telegraf;
+export type TelegramInlineKeyboardButton = InlineKeyboardButton;
+//# sourceMappingURL=externalAliases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"externalAliases.d.ts","sourceRoot":"","sources":["../../types/externalAliases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EACH,IAAI,EACJ,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,aAAa,IAAI,KAAK,EACtB,oBAAoB,EACvB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC;AAChC,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC;AACtC,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC;AAClC,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AACzC,MAAM,MAAM,OAAO,GAAG,aAAa,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AACnC,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC"}

package/dist/types/externalAliases.js

@@ -0,0 +1 @@
+export {};

package/dist/types/handlers.d.ts

@@ -0,0 +1,21 @@
+import { ChatContext } from '../entities/context/chatContext';
+import { InlineQueryContext } from '../entities/context/inlineQueryContext';
+import { MessageContext } from '../entities/context/messageContext';
+import { IActionState } from './actionState';
+import { CachedValueAccessor } from './cachedValueAccessor';
+export type InlineQueryHandler = (
+/** Context of inline query executed in chat, in response to a message. */
+ctx: InlineQueryContext) => Promise<void>;
+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> | 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,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,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,kBAAkB,GAAG;AAC7B,0EAA0E;AAC1E,GAAG,EAAE,kBAAkB,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,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,GAAG,IAAI,CAAC;AAE1B,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 @@
+export {};

package/dist/types/inputFile.d.ts

@@ -0,0 +1,5 @@
+export interface InputFile {
+    source: string;
+    filename?: string;
+}
+//# sourceMappingURL=inputFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputFile.d.ts","sourceRoot":"","sources":["../../types/inputFile.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/inputFile.js

@@ -0,0 +1 @@
+export {};

package/dist/types/logger.d.ts

@@ -0,0 +1,13 @@
+import { TraceId } from './trace';
+export interface IScopedLogger {
+    logObjectWithTraceId(data: unknown): void;
+    logWithTraceId(text: string): void;
+    errorWithTraceId(errorObj: unknown, extraData?: unknown): void;
+}
+export interface ILogger {
+    createScope(botName: string, traceId: TraceId, chatName: string): IScopedLogger;
+    logObjectWithTraceId(botName: string, traceId: TraceId, chatName: string, data: unknown): void;
+    logWithTraceId(botName: string, traceId: TraceId, chatName: string, text: string): void;
+    errorWithTraceId(botName: string, traceId: TraceId, chatName: string, errorObj: unknown, extraData?: unknown): void;
+}
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../types/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,WAAW,aAAa;IAC1B,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,OAAO;IACpB,WAAW,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACjB,aAAa,CAAC;IAEjB,oBAAoB,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACd,IAAI,CAAC;IAER,cAAc,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACb,IAAI,CAAC;IAER,gBAAgB,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,SAAS,CAAC,EAAE,OAAO,GACpB,IAAI,CAAC;CACX"}

package/dist/types/logger.js

@@ -0,0 +1 @@
+export {};

package/dist/types/messageSendingOptions.d.ts

@@ -0,0 +1,9 @@
+import { TelegramInlineKeyboardButton } from './externalAliases';
+export interface MessageSendingOptions {
+    pin?: boolean;
+}
+export interface TextMessageSendingOptions extends MessageSendingOptions {
+    disableWebPreview?: boolean;
+    keyboard?: TelegramInlineKeyboardButton[][];
+}
+//# 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,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,4BAA4B,EAAE,EAAE,CAAC;CAC/C"}

package/dist/types/messageSendingOptions.js

@@ -0,0 +1 @@
+export {};

package/dist/types/messageTypes.d.ts

@@ -0,0 +1,20 @@
+export declare const INTERNAL_MESSAGE_TYPE_PREFIX = "__msg:";
+export declare const MessageType: {
+    readonly Any: "__msg:Any";
+    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 Forward: "__msg:Forward";
+    readonly Video: "__msg:Video";
+    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,4BAA4B,WAAW,CAAC;AAErD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;CAgBd,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}

package/dist/types/messageTypes.js

@@ -0,0 +1,18 @@
+export const INTERNAL_MESSAGE_TYPE_PREFIX = `__msg:`;
+export const MessageType = {
+    Any: `${INTERNAL_MESSAGE_TYPE_PREFIX}Any`,
+    Text: `${INTERNAL_MESSAGE_TYPE_PREFIX}Text`,
+    Sticker: `${INTERNAL_MESSAGE_TYPE_PREFIX}Sticker`,
+    Animation: `${INTERNAL_MESSAGE_TYPE_PREFIX}Animation`,
+    Document: `${INTERNAL_MESSAGE_TYPE_PREFIX}Document`,
+    Voice: `${INTERNAL_MESSAGE_TYPE_PREFIX}Voice`,
+    Audio: `${INTERNAL_MESSAGE_TYPE_PREFIX}Audio`,
+    LeftChatMember: `${INTERNAL_MESSAGE_TYPE_PREFIX}LeftChatMember`,
+    NewChatMember: `${INTERNAL_MESSAGE_TYPE_PREFIX}NewChatMember`,
+    Poll: `${INTERNAL_MESSAGE_TYPE_PREFIX}Poll`,
+    Location: `${INTERNAL_MESSAGE_TYPE_PREFIX}Location`,
+    Photo: `${INTERNAL_MESSAGE_TYPE_PREFIX}Photo`,
+    Forward: `${INTERNAL_MESSAGE_TYPE_PREFIX}Forward`,
+    Video: `${INTERNAL_MESSAGE_TYPE_PREFIX}Video`,
+    Unknown: `${INTERNAL_MESSAGE_TYPE_PREFIX}Unknown`
+};

package/dist/types/propertyProvider.d.ts

@@ -0,0 +1,8 @@
+import { ChatContext } from '../entities/context/chatContext';
+import { InlineQueryContext } from '../entities/context/inlineQueryContext';
+import { MessageContext } from '../entities/context/messageContext';
+import { IActionState } from './actionState';
+export type CommandActionPropertyProvider<T> = (ctx: MessageContext<IActionState>) => T;
+export type InlineActionPropertyProvider<T> = (ctx: InlineQueryContext) => T;
+export type ScheduledActionPropertyProvider<T> = (ctx: ChatContext<IActionState>) => T;
+//# sourceMappingURL=propertyProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propertyProvider.d.ts","sourceRoot":"","sources":["../../types/propertyProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,6BAA6B,CAAC,CAAC,IAAI,CAC3C,GAAG,EAAE,cAAc,CAAC,YAAY,CAAC,KAChC,CAAC,CAAC;AAEP,MAAM,MAAM,4BAA4B,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,KAAK,CAAC,CAAC;AAE7E,MAAM,MAAM,+BAA+B,CAAC,CAAC,IAAI,CAC7C,GAAG,EAAE,WAAW,CAAC,YAAY,CAAC,KAC7B,CAAC,CAAC"}

package/dist/types/propertyProvider.js

@@ -0,0 +1 @@
+export {};

package/dist/types/response.d.ts

@@ -0,0 +1,39 @@
+import { ChatInfo } from '../dtos/chatInfo';
+import { DelayResponse } from '../dtos/responses/delay';
+import { ImageMessage } from '../dtos/responses/imageMessage';
+import { InlineQueryResponse } from '../dtos/responses/inlineQueryResponse';
+import { Reaction } from '../dtos/responses/reaction';
+import { TextMessage } from '../dtos/responses/textMessage';
+import { UnpinResponse } from '../dtos/responses/unpin';
+import { VideoMessage } from '../dtos/responses/videoMessage';
+import { IReplyCapture } from './capture';
+import { ReplyInfo } from '../dtos/replyInfo';
+import { TraceId } from './trace';
+import { IAction } from './action';
+export declare const BotResponseTypes: {
+    readonly unpin: "unpin";
+    readonly text: "text";
+    readonly image: "image";
+    readonly video: "video";
+    readonly react: "react";
+    readonly delay: "delay";
+    readonly inlineQuery: "inlineQuery";
+};
+export type BotResponse = UnpinResponse | Reaction | TextMessage | VideoMessage | DelayResponse | InlineQueryResponse | ImageMessage;
+export interface IChatResponse {
+    readonly kind: keyof typeof BotResponseTypes;
+    readonly chatInfo: ChatInfo;
+    readonly traceId: TraceId;
+    readonly createdAt: number;
+    readonly action: IAction;
+}
+export interface IReplyResponse extends IChatResponse {
+    readonly captures: IReplyCapture[];
+    readonly replyInfo: ReplyInfo | undefined;
+    readonly disableWebPreview: boolean;
+    readonly shouldPin: boolean;
+}
+export interface IReplyResponseWithContent<TType> extends IReplyResponse {
+    readonly content: TType;
+}
+//# 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,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC;AAEX,MAAM,MAAM,WAAW,GACjB,aAAa,GACb,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,aAAa,GACb,mBAAmB,GACnB,YAAY,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACjD,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB,CAAC,KAAK,CAAE,SAAQ,cAAc;IACpE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;CAC3B"}

package/dist/types/response.js

@@ -0,0 +1,9 @@
+export const BotResponseTypes = {
+    unpin: 'unpin',
+    text: 'text',
+    image: 'image',
+    video: 'video',
+    react: 'react',
+    delay: 'delay',
+    inlineQuery: 'inlineQuery'
+};

package/dist/types/scheduler.d.ts

@@ -0,0 +1,7 @@
+import { Milliseconds } from './timeValues';
+export interface IScheduler {
+    stopAll(): void;
+    createTask(name: string, action: () => unknown, interval: Milliseconds, executeRightAway: boolean, ownerName: string): void;
+    createOnetimeTask(name: string, action: () => unknown, delay: Milliseconds, ownerName: string): void;
+}
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../types/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,UAAU;IACvB,OAAO,IAAI,IAAI,CAAC;IAEhB,UAAU,CACN,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,OAAO,EACrB,QAAQ,EAAE,YAAY,EACtB,gBAAgB,EAAE,OAAO,EACzB,SAAS,EAAE,MAAM,GAClB,IAAI,CAAC;IAER,iBAAiB,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,OAAO,EACrB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,GAClB,IAAI,CAAC;CACX"}

package/dist/types/scheduler.js

@@ -0,0 +1 @@
+export {};

package/dist/types/storage.d.ts

@@ -0,0 +1,11 @@
+import { IActionState } from './actionState';
+import { ActionKey, IActionWithState } from './action';
+export interface IStorageClient {
+    updateStateFor<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number, update: (state: TActionState) => Promise<void> | void): Promise<void>;
+    close(): Promise<void>;
+    load<TActionState extends IActionState>(key: ActionKey): Promise<Record<number, TActionState | undefined>>;
+    saveMetadata<TActionState extends IActionState>(actions: IActionWithState<TActionState>[]): Promise<void>;
+    getActionState<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number): Promise<TActionState>;
+    saveActionExecutionResult<TActionState extends IActionState>(action: IActionWithState<TActionState>, chatId: number, state: 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,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEvD,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,GAAG,IAAI,GACtD,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,GAAG,SAAS,CAAC,CAAC,CAAC;IACrD,YAAY,CAAC,YAAY,SAAS,YAAY,EAC1C,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,EAAE,GAC1C,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,KAAK,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB"}

package/dist/types/storage.js

@@ -0,0 +1 @@
+export {};

package/dist/types/timeValues.d.ts

@@ -0,0 +1,15 @@
+declare const millisecondsSymbol: unique symbol;
+declare const secondsSymbol: unique symbol;
+declare const hoursSymbol: unique symbol;
+export type Milliseconds = number & {
+    [millisecondsSymbol]: never;
+};
+export type Seconds = number & {
+    [secondsSymbol]: never;
+};
+export type Hours = number & {
+    [hoursSymbol]: never;
+};
+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;
+export {};
+//# 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,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAChD,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AACpE,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAC1D,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAAE,CAAC,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtD,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 @@
+export {};

package/dist/types/trace.d.ts

@@ -0,0 +1,6 @@
+declare const traceSymbol: unique symbol;
+export type TraceId = `${string}:${string}-${string}` & {
+    [traceSymbol]: never;
+};
+export {};
+//# sourceMappingURL=trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../types/trace.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AAEzC,MAAM,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,GAAG;IACpD,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;CACxB,CAAC"}

package/dist/types/trace.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,38 +1,38 @@
-{
-    "name": "chz-telegram-bot",
-    "description": "Opinionated TypeScript framework that provides a structured approach to building Telegram bots.",
-    "author": {
-        "name": "Alex Halanin",
-        "url": "https://github.com/AlexSolari"
-    },
-    "license": "MIT",
-    "keywords": [
-        "telegram",
-        "telegram bot"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/AlexSolari/botFramework.git"
-    },
-    "version": "0.5.4",
-    "type": "module",
-    "dependencies": {
-        "async-sema": "^3.1.1",
-        "moment": "^2.29.4",
-        "telegraf": "^4.16.3"
-    },
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "devDependencies": {
-        "@eslint/js": "^9.29.0",
-        "@types/node": "^22.5.5",
-        "eslint": "^9.29.0",
-        "jiti": "^2.6.1",
-        "typescript": "^5.9.0-beta",
-        "typescript-eslint": "^8.34.1"
-    },
-    "scripts": {
-        "build": "tsc",
-        "lint": "npx eslint && tsc --noEmit"
-    }
-}
+{
+    "name": "chz-telegram-bot",
+    "description": "Opinionated TypeScript framework that provides a structured approach to building Telegram bots.",
+    "author": {
+        "name": "Alex Halanin",
+        "url": "https://github.com/AlexSolari"
+    },
+    "license": "MIT",
+    "keywords": [
+        "telegram",
+        "telegram bot"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/AlexSolari/botFramework.git"
+    },
+    "version": "0.5.5",
+    "type": "module",
+    "dependencies": {
+        "async-sema": "^3.1.1",
+        "moment": "^2.29.4",
+        "telegraf": "^4.16.3"
+    },
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "devDependencies": {
+        "@eslint/js": "^9.29.0",
+        "@types/node": "^22.5.5",
+        "eslint": "^9.29.0",
+        "jiti": "^2.6.1",
+        "typescript": "^5.9.0-beta",
+        "typescript-eslint": "^8.34.1"
+    },
+    "scripts": {
+        "build": "tsc",
+        "lint": "npx eslint && tsc --noEmit"
+    }
+}