chz-telegram-bot 0.5.4 → 0.6.8

package/README.md

@@ -1,4 +1,4 @@
-# chz-bot-Framework
+# chz-telegram-bot
 
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/AlexSolari/botFramework)
 
@@ -8,19 +8,19 @@ botFramework is a TypeScript library that provides a structured approach to buil
 
 ## Features
 
--   **Type-Safe Command Building**: Fully TypeScript-supported command builders
--   **Stateful Actions**: Built-in state management for commands, scheduled actions, and inline queries
--   **Flexible Triggering**: Support for exact matches, regex patterns, and message types
--   **Scheduled Tasks**: Time-based actions with customizable execution schedules
--   **Access Control**: Built-in user and chat-based permissions
--   **Cooldown Management**: Configurable cooldown periods for commands
--   **Cached Values**: Process-wide caching system for optimizing resource usage
--   **Custom State Types**: Extensible state system for complex bot logic
--   **Comprehensive Logging**: Built-in logging system with trace IDs
--   **Persistent Storage**: JSON-based file storage with automatic state management
--   **Inline Query Support**: Handle inline queries with type-safe builders
--   **Response Queue**: Managed response processing queue for reliable message delivery
--   **Rich Media Support**: Built-in support for text, images, videos, reactions, and inline results
+- **Type-Safe Command Building**: Fully TypeScript-supported command builders
+- **Stateful Actions**: Built-in state management for commands, scheduled actions, and inline queries
+- **Flexible Triggering**: Support for exact matches, regex patterns, and message types
+- **Scheduled Tasks**: Time-based actions with customizable execution schedules
+- **Access Control**: Built-in user and chat-based permissions
+- **Cooldown Management**: Configurable cooldown periods for commands
+- **Cached Values**: Process-wide caching system for optimizing resource usage
+- **Custom State Types**: Extensible state system for complex bot logic
+- **Comprehensive Logging**: Built-in logging system with trace IDs
+- **Persistent Storage**: JSON-based file storage with automatic state management
+- **Inline Query Support**: Handle inline queries with type-safe builders
+- **Response Queue**: Managed response processing queue for reliable message delivery
+- **Rich Media Support**: Built-in support for text, images, videos, reactions, and inline results
 
 ## Installation
 
@@ -85,8 +85,11 @@ async function main() {
         const bot = await botOrchestrator.startBot({
             name: 'MyFirstBot',
             tokenFilePath: './token.txt',
-            commands,
-            scheduled: [], // Add scheduled actions if needed
+            actions: {
+                commands,
+                scheduled: [], // Add scheduled actions if needed
+                inlineQueries: []
+            },
             chats: {
                 MyChat: -1001234567890 // Replace with your chat ID
             },
@@ -96,6 +99,15 @@ async function main() {
             verboseLoggingForIncomingMessage: false
         });
 
+        // Add logging
+        bot.eventEmitter.onEach(
+            (e: string, timestamp: number, data: unknown) => {
+                console.log(
+                    `${new Date(timestamp).toISOString()} - ${e} - ${JSON.stringify(data)}`
+                );
+            }
+        );
+
         // Proper cleanup on shutdown
         const cleanup = async (signal: string) => {
             console.log(`Received ${signal}, cleaning up...`);
@@ -199,23 +211,21 @@ This will result in `Message 1` being sent, followed by `Message 2` after a 5 se
 
 When starting a bot, you can provide the following configuration:
 
-| Option            | Type                     | Required                    | Description                                                                               |
-| ----------------- | ------------------------ | --------------------------- | ----------------------------------------------------------------------------------------- |
-| `name`            | `string`                 | Yes                         | Bot name used in logging                                                                  |
-| `tokenFilePath`   | `string`                 | Yes                         | Path to file containing Telegram Bot token                                                |
-| `commands`        | `CommandAction[]  `      | Yes (can be empty)          | Collection of command actions                                                             |
-| `scheduled`       | `ScheduledAction[]`      | Yes (can be empty)          | Collection of scheduled actions                                                           |
-| `chats`           | `Record<string, number>` | Yes                         | Object containing chat name-id pairs. Used for logging and execution of scheduled action. |
-| `storagePath`     | `string`                 | No                          | Custom storage path for default JsonFileStorage client                                    |
-| `scheduledPeriod` | `Seconds`                | No (will default to 1 hour) | Period between scheduled action executions                                                |
-| `services`        |                          | No                          | Custom services to be used instead of default ones                                        |
+| Option            | Type                                                                                              | Required                    | Description                                                                                  |
+| ----------------- | ------------------------------------------------------------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------- |
+| `name`            | `string`                                                                                          | Yes                         | Bot name used in logging                                                                     |
+| `tokenFilePath`   | `string`                                                                                          | Yes                         | Path to file containing Telegram Bot token                                                   |
+| `actions`         | `{ commands: CommandAction[], scheduled: ScheduledAction[], inlineQueries: InlineQueryAction[] }` | Yes (can be empty)          | Collection of actions grouped under `actions` — `commands`, `scheduled`, and `inlineQueries` |
+| `chats`           | `Record<string, number>`                                                                          | Yes                         | Object containing chat name-id pairs. Used for logging and execution of scheduled action.    |
+| `storagePath`     | `string`                                                                                          | No                          | Custom storage path for default JsonFileStorage client                                       |
+| `scheduledPeriod` | `Seconds`                                                                                         | No (will default to 1 hour) | Period between scheduled action executions                                                   |
+| `services`        |                                                                                                   | No                          | Custom services to be used instead of default ones                                           |
 
 Services object should have following structure:
 | Option | Type | Required | Description |
 |------------------|--------------------------|----------|---------------------------------------------------------------|
-| `storageClient` | `IStorageClient` | No (will default to `JsonFileStorage`) | Persistance state provide |
-| `logger` | `ILogger` | No (will default to `JsonLogger`) | Logger service |
-| `scheduler` | `IScheduler` | No (will default to `NodeTimeoutScheduler`) | Scheduler used to scheduled action|
+| `storageClient` | `IStorageClient` | No (will default to `JsonFileStorage`) | Persistence state provider |
+| `scheduler` | `IScheduler` | No (will default to `NodeTimeoutScheduler`) | Scheduler used to schedule actions |
 
 ## Advanced Usage
 
@@ -287,8 +297,8 @@ All responses are queued and processed in order, ensuring proper sequencing of m
 To properly terminate your bot and clean up resources:
 
 ```typescript
-import { stopBots } from 'chz-telegram-bot';
+import { botOrchestrator } from 'chz-telegram-bot';
 
 // Call when your application is shutting down
-await stopBots();
+await botOrchestrator.stopBots();
 ```

package/dist/builtin/helpAction.d.ts

@@ -0,0 +1,2 @@
+export declare function buildHelpCommand(readmes: string[], botUsername: string): import("..").CommandAction<import("..").ActionStateBase>;
+//# sourceMappingURL=helpAction.d.ts.map

package/dist/builtin/helpAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpAction.d.ts","sourceRoot":"","sources":["../../builtin/helpAction.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,4DAatE"}

package/dist/builtin/helpAction.js

@@ -0,0 +1,14 @@
+import { CommandActionBuilder } from '../helpers/builders/commandActionBuilder';
+export function buildHelpCommand(readmes, botUsername) {
+    const helpCommandBuilder = new CommandActionBuilder('Reaction.Help')
+        .on(['/help', `/help@${botUsername}`])
+        .do((ctx) => {
+        ctx.reply.withText(readmes.join('\n\n'));
+    })
+        .withCooldown({
+        cooldown: 60
+    });
+    if (readmes.length == 0)
+        helpCommandBuilder.disabled();
+    return helpCommandBuilder.build();
+}

package/dist/dtos/chatHistoryMessage.d.ts

@@ -0,0 +1,35 @@
+import { TelegramUser } from '../types/externalAliases';
+import { MessageTypeValue } from '../types/messageTypes';
+import { TraceId } from '../types/trace';
+export declare class ChatHistoryMessage {
+    /** The unique identifier for the message */
+    readonly id: number;
+    /** The user who sent the message */
+    readonly from: TelegramUser | undefined;
+    /** The content of the message */
+    readonly text: string;
+    /** The type of the message */
+    readonly type: MessageTypeValue;
+    /** The trace identifier for the message */
+    readonly traceId: TraceId;
+    /** The identifier for the message this message is replying to */
+    readonly replyToId: number | undefined;
+    /** The date the message was sent, represented as a Unix timestamp */
+    readonly date: number;
+    constructor(
+    /** The unique identifier for the message */
+    id: number, 
+    /** The user who sent the message */
+    from: TelegramUser | undefined, 
+    /** The content of the message */
+    text: string, 
+    /** The type of the message */
+    type: MessageTypeValue, 
+    /** The trace identifier for the message */
+    traceId: TraceId, 
+    /** The identifier for the message this message is replying to */
+    replyToId: number | undefined, 
+    /** The date the message was sent, represented as a Unix timestamp */
+    date: number);
+}
+//# sourceMappingURL=chatHistoryMessage.d.ts.map

package/dist/dtos/chatHistoryMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatHistoryMessage.d.ts","sourceRoot":"","sources":["../../dtos/chatHistoryMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,qBAAa,kBAAkB;IAEvB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS;IACvC,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,gBAAgB;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO;IACzB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IACtC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM;;IAbrB,4CAA4C;IACnC,EAAE,EAAE,MAAM;IACnB,oCAAoC;IAC3B,IAAI,EAAE,YAAY,GAAG,SAAS;IACvC,iCAAiC;IACxB,IAAI,EAAE,MAAM;IACrB,8BAA8B;IACrB,IAAI,EAAE,gBAAgB;IAC/B,2CAA2C;IAClC,OAAO,EAAE,OAAO;IACzB,iEAAiE;IACxD,SAAS,EAAE,MAAM,GAAG,SAAS;IACtC,qEAAqE;IAC5D,IAAI,EAAE,MAAM;CAE5B"}

package/dist/dtos/chatHistoryMessage.js

@@ -0,0 +1,32 @@
+export class ChatHistoryMessage {
+    id;
+    from;
+    text;
+    type;
+    traceId;
+    replyToId;
+    date;
+    constructor(
+    /** The unique identifier for the message */
+    id, 
+    /** The user who sent the message */
+    from, 
+    /** The content of the message */
+    text, 
+    /** The type of the message */
+    type, 
+    /** The trace identifier for the message */
+    traceId, 
+    /** The identifier for the message this message is replying to */
+    replyToId, 
+    /** The date the message was sent, represented as a Unix timestamp */
+    date) {
+        this.id = id;
+        this.from = from;
+        this.text = text;
+        this.type = type;
+        this.traceId = traceId;
+        this.replyToId = replyToId;
+        this.date = date;
+    }
+}

package/dist/dtos/chatInfo.d.ts

@@ -0,0 +1,17 @@
+import { ChatHistoryMessage } from './chatHistoryMessage';
+export declare class ChatInfo {
+    /** Id of a chat that action is executed in. */
+    readonly id: number;
+    /** Name of a chat that action is executed in. */
+    readonly name: string;
+    /** Last 100 messages in chat where action is executed */
+    readonly messageHistory: ChatHistoryMessage[];
+    constructor(
+    /** Id of a chat that action is executed in. */
+    id: number, 
+    /** Name of a chat that action is executed in. */
+    name: string, 
+    /** Last 100 messages in chat where action is executed */
+    messageHistory: ChatHistoryMessage[]);
+}
+//# sourceMappingURL=chatInfo.d.ts.map

package/dist/dtos/chatInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatInfo.d.ts","sourceRoot":"","sources":["../../dtos/chatInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,qBAAa,QAAQ;IAEb,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,kBAAkB,EAAE;;IAL7C,+CAA+C;IACtC,EAAE,EAAE,MAAM;IACnB,iDAAiD;IACxC,IAAI,EAAE,MAAM;IACrB,yDAAyD;IAChD,cAAc,EAAE,kBAAkB,EAAE;CAEpD"}

package/dist/dtos/chatInfo.js

@@ -0,0 +1,16 @@
+export class ChatInfo {
+    id;
+    name;
+    messageHistory;
+    constructor(
+    /** Id of a chat that action is executed in. */
+    id, 
+    /** Name of a chat that action is executed in. */
+    name, 
+    /** Last 100 messages in chat where action is executed */
+    messageHistory) {
+        this.id = id;
+        this.name = name;
+        this.messageHistory = messageHistory;
+    }
+}

package/dist/dtos/commandTriggerCheckResult.d.ts

@@ -0,0 +1,24 @@
+declare const _SkipTriggerReasonsObject: {
+    readonly UserIdMissing: "UserIdMissing";
+    readonly UserForbidden: "UserForbidden";
+    readonly OnCooldown: "OnCooldown";
+    readonly CustomConditionNotMet: "CustomConditionNotMet";
+    readonly TriggerNotSatisfied: "TriggerNotSatisfied";
+    readonly Other: "Other";
+    readonly ActionDisabled: "ActionDisabled";
+    readonly ChatForbidden: "ChatForbidden";
+};
+export type SkipTriggerReasons = keyof typeof _SkipTriggerReasonsObject;
+export declare class CommandTriggerCheckResult {
+    readonly shouldExecute: boolean;
+    readonly matchResults: RegExpExecArray[];
+    readonly skipCooldown: boolean;
+    readonly reason?: SkipTriggerReasons | undefined;
+    static DontTriggerAndSkipCooldown(reason: SkipTriggerReasons): CommandTriggerCheckResult;
+    static DoNotTrigger(reason: SkipTriggerReasons): CommandTriggerCheckResult;
+    static Trigger(): CommandTriggerCheckResult;
+    constructor(shouldExecute: boolean, matchResults: RegExpExecArray[], skipCooldown: boolean, reason?: SkipTriggerReasons | undefined);
+    mergeWith(other: CommandTriggerCheckResult): CommandTriggerCheckResult;
+}
+export {};
+//# sourceMappingURL=commandTriggerCheckResult.d.ts.map

package/dist/dtos/commandTriggerCheckResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandTriggerCheckResult.d.ts","sourceRoot":"","sources":["../../dtos/commandTriggerCheckResult.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,yBAAyB;;;;;;;;;CASrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,yBAAyB,CAAC;AAExE,qBAAa,yBAAyB;IAY9B,QAAQ,CAAC,aAAa,EAAE,OAAO;IAC/B,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE;IACxC,QAAQ,CAAC,YAAY,EAAE,OAAO;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB;IAdxC,MAAM,CAAC,0BAA0B,CAAC,MAAM,EAAE,kBAAkB;IAG5D,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB;IAG9C,MAAM,CAAC,OAAO;gBAKD,aAAa,EAAE,OAAO,EACtB,YAAY,EAAE,eAAe,EAAE,EAC/B,YAAY,EAAE,OAAO,EACrB,MAAM,CAAC,EAAE,kBAAkB,YAAA;IAGxC,SAAS,CAAC,KAAK,EAAE,yBAAyB;CAQ7C"}

package/dist/dtos/commandTriggerCheckResult.js

@@ -0,0 +1,34 @@
+const _SkipTriggerReasonsObject = {
+    UserIdMissing: 'UserIdMissing',
+    UserForbidden: 'UserForbidden',
+    OnCooldown: 'OnCooldown',
+    CustomConditionNotMet: 'CustomConditionNotMet',
+    TriggerNotSatisfied: 'TriggerNotSatisfied',
+    Other: 'Other',
+    ActionDisabled: 'ActionDisabled',
+    ChatForbidden: 'ChatForbidden'
+};
+export class CommandTriggerCheckResult {
+    shouldExecute;
+    matchResults;
+    skipCooldown;
+    reason;
+    static DontTriggerAndSkipCooldown(reason) {
+        return new CommandTriggerCheckResult(false, [], true, reason);
+    }
+    static DoNotTrigger(reason) {
+        return new CommandTriggerCheckResult(false, [], false, reason);
+    }
+    static Trigger() {
+        return new CommandTriggerCheckResult(true, [], false);
+    }
+    constructor(shouldExecute, matchResults, skipCooldown, reason) {
+        this.shouldExecute = shouldExecute;
+        this.matchResults = matchResults;
+        this.skipCooldown = skipCooldown;
+        this.reason = reason;
+    }
+    mergeWith(other) {
+        return new CommandTriggerCheckResult(this.shouldExecute || other.shouldExecute, this.matchResults.concat(other.matchResults), this.skipCooldown || other.skipCooldown, other.reason);
+    }
+}

package/dist/dtos/cooldownInfo.d.ts

@@ -0,0 +1,13 @@
+import { Seconds } from '../types/timeValues';
+export declare class CooldownInfo {
+    /** Cooldown configuration */
+    readonly cooldown: Seconds;
+    /** Cooldown message to be shown */
+    readonly message?: string | undefined;
+    constructor(
+    /** Cooldown configuration */
+    cooldown: Seconds, 
+    /** Cooldown message to be shown */
+    message?: string | undefined);
+}
+//# sourceMappingURL=cooldownInfo.d.ts.map

package/dist/dtos/cooldownInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldownInfo.d.ts","sourceRoot":"","sources":["../../dtos/cooldownInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,qBAAa,YAAY;IAEjB,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM;;IAHzB,6BAA6B;IACpB,QAAQ,EAAE,OAAO;IAC1B,mCAAmC;IAC1B,OAAO,CAAC,EAAE,MAAM,YAAA;CAEhC"}

package/dist/dtos/cooldownInfo.js

@@ -0,0 +1,12 @@
+export class CooldownInfo {
+    cooldown;
+    message;
+    constructor(
+    /** Cooldown configuration */
+    cooldown, 
+    /** Cooldown message to be shown */
+    message) {
+        this.cooldown = cooldown;
+        this.message = message;
+    }
+}

package/dist/dtos/incomingMessage.d.ts

@@ -0,0 +1,19 @@
+import { MessageTypeValue } from '../types/messageTypes';
+import { ChatInfo } from './chatInfo';
+import { TraceId } from '../types/trace';
+import { ChatHistoryMessage } from './chatHistoryMessage';
+import { TelegramMessage, TelegramUser } from '../types/externalAliases';
+export declare class IncomingMessage {
+    readonly messageId: number;
+    readonly chatInfo: ChatInfo;
+    readonly from: TelegramUser | undefined;
+    readonly text: string;
+    readonly type: MessageTypeValue;
+    readonly traceId: TraceId;
+    readonly replyToMessageId: number | undefined;
+    readonly updateObject: TelegramMessage;
+    private detectMessageType;
+    constructor(ctxMessage: TelegramMessage, botName: string, history: ChatHistoryMessage[]);
+    private getMessageText;
+}
+//# sourceMappingURL=incomingMessage.d.ts.map

package/dist/dtos/incomingMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incomingMessage.d.ts","sourceRoot":"","sources":["../../dtos/incomingMessage.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEzE,qBAAa,eAAe;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9C,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IAEvC,OAAO,CAAC,iBAAiB;gBAmBrB,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAAE;IAyBjC,OAAO,CAAC,cAAc;CAKzB"}

package/dist/dtos/incomingMessage.js

@@ -0,0 +1,63 @@
+import { randomInt } from 'crypto';
+import { MessageType } from '../types/messageTypes';
+import { ChatInfo } from './chatInfo';
+import { createTrace } from '../helpers/traceFactory';
+export class IncomingMessage {
+    messageId;
+    chatInfo;
+    from;
+    text;
+    type;
+    traceId;
+    replyToMessageId;
+    updateObject;
+    detectMessageType(message) {
+        if ('forward_origin' in message)
+            return MessageType.Forward;
+        if ('text' in message)
+            return MessageType.Text;
+        if ('video' in message)
+            return MessageType.Video;
+        if ('photo' in message)
+            return MessageType.Photo;
+        if ('sticker' in message)
+            return MessageType.Sticker;
+        if ('animation' in message)
+            return MessageType.Animation;
+        if ('voice' in message)
+            return MessageType.Voice;
+        if ('audio' in message)
+            return MessageType.Audio;
+        if ('document' in message)
+            return MessageType.Document;
+        if ('left_chat_member' in message)
+            return MessageType.LeftChatMember;
+        if ('new_chat_member' in message)
+            return MessageType.NewChatMember;
+        if ('poll' in message)
+            return MessageType.Poll;
+        if ('location' in message)
+            return MessageType.Location;
+        return MessageType.Unknown;
+    }
+    constructor(ctxMessage, botName, history) {
+        this.traceId = createTrace(this, botName, randomInt(10000, 99999).toString());
+        this.messageId = ctxMessage.message_id;
+        this.replyToMessageId =
+            'reply_to_message' in ctxMessage
+                ? ctxMessage.reply_to_message?.message_id
+                : undefined;
+        this.from = ctxMessage.from;
+        this.text = this.getMessageText(ctxMessage);
+        this.chatInfo = new ChatInfo(ctxMessage.chat.id, 'title' in ctxMessage.chat
+            ? `${ctxMessage.chat.title} ${ctxMessage.chat.id}`
+            : 'DM', history);
+        this.type = this.detectMessageType(ctxMessage);
+        this.updateObject = ctxMessage;
+    }
+    getMessageText(ctxMessage) {
+        if ('text' in ctxMessage)
+            return ctxMessage.text;
+        return 'caption' in ctxMessage ? ctxMessage.caption ?? '' : '';
+    }
+}

package/dist/dtos/incomingQuery.d.ts

@@ -0,0 +1,10 @@
+import { TraceId } from '../types/trace';
+export declare class IncomingInlineQuery {
+    readonly queryId: string;
+    readonly query: string;
+    readonly userId: number;
+    readonly traceId: TraceId;
+    readonly abortController: AbortController;
+    constructor(queryId: string, query: string, userId: number, traceId: TraceId);
+}
+//# sourceMappingURL=incomingQuery.d.ts.map

package/dist/dtos/incomingQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incomingQuery.d.ts","sourceRoot":"","sources":["../../dtos/incomingQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,qBAAa,mBAAmB;IAIxB,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO;IAN7B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO;CAIhC"}

package/dist/dtos/incomingQuery.js

@@ -0,0 +1,14 @@
+export class IncomingInlineQuery {
+    queryId;
+    query;
+    userId;
+    traceId;
+    abortController;
+    constructor(queryId, query, userId, traceId) {
+        this.queryId = queryId;
+        this.query = query;
+        this.userId = userId;
+        this.traceId = traceId;
+        this.abortController = new AbortController();
+    }
+}

package/dist/dtos/messageInfo.d.ts

@@ -0,0 +1,22 @@
+import { TelegramMessage } from '../types/externalAliases';
+import { MessageTypeValue } from '../types/messageTypes';
+export declare class MessageInfo {
+    /** Id of a message that triggered this action. */
+    readonly id: number;
+    /** Text of a message that triggered this action. */
+    readonly text: string;
+    /** Type of message being received */
+    readonly type: MessageTypeValue;
+    /** Message object recieved from Telegram */
+    readonly telegramUpdateObject: TelegramMessage;
+    constructor(
+    /** Id of a message that triggered this action. */
+    id: number, 
+    /** Text of a message that triggered this action. */
+    text: string, 
+    /** Type of message being received */
+    type: MessageTypeValue, 
+    /** Message object recieved from Telegram */
+    telegramUpdateObject: TelegramMessage);
+}
+//# sourceMappingURL=messageInfo.d.ts.map

package/dist/dtos/messageInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageInfo.d.ts","sourceRoot":"","sources":["../../dtos/messageInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,qBAAa,WAAW;IAEhB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,eAAe;;IAP9C,kDAAkD;IACzC,EAAE,EAAE,MAAM;IACnB,oDAAoD;IAC3C,IAAI,EAAE,MAAM;IACrB,qCAAqC;IAC5B,IAAI,EAAE,gBAAgB;IAC/B,4CAA4C;IACnC,oBAAoB,EAAE,eAAe;CAErD"}

package/dist/dtos/messageInfo.js

@@ -0,0 +1,20 @@
+export class MessageInfo {
+    id;
+    text;
+    type;
+    telegramUpdateObject;
+    constructor(
+    /** Id of a message that triggered this action. */
+    id, 
+    /** Text of a message that triggered this action. */
+    text, 
+    /** Type of message being received */
+    type, 
+    /** Message object recieved from Telegram */
+    telegramUpdateObject) {
+        this.id = id;
+        this.text = text;
+        this.type = type;
+        this.telegramUpdateObject = telegramUpdateObject;
+    }
+}

package/dist/dtos/propertyProviderSets.d.ts

@@ -0,0 +1,16 @@
+import { CooldownInfo } from './cooldownInfo';
+import { CommandActionPropertyProvider, ScheduledActionPropertyProvider } from '../types/propertyProvider';
+import { HoursOfDay } from '../types/timeValues';
+export type CommandActionProviders = {
+    cooldownProvider: CommandActionPropertyProvider<CooldownInfo>;
+    isActiveProvider: CommandActionPropertyProvider<boolean>;
+    chatsBlacklistProvider: CommandActionPropertyProvider<number[]>;
+    chatsWhitelistProvider: CommandActionPropertyProvider<number[]>;
+    usersWhitelistProvider: CommandActionPropertyProvider<number[]>;
+};
+export type ScheduledActionProviders = {
+    timeinHoursProvider: ScheduledActionPropertyProvider<HoursOfDay>;
+    isActiveProvider: ScheduledActionPropertyProvider<boolean>;
+    chatsWhitelistProvider: ScheduledActionPropertyProvider<number[]>;
+};
+//# sourceMappingURL=propertyProviderSets.d.ts.map

package/dist/dtos/propertyProviderSets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propertyProviderSets.d.ts","sourceRoot":"","sources":["../../dtos/propertyProviderSets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACH,6BAA6B,EAC7B,+BAA+B,EAClC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,MAAM,sBAAsB,GAAG;IACjC,gBAAgB,EAAE,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAC9D,gBAAgB,EAAE,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACzD,sBAAsB,EAAE,6BAA6B,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,sBAAsB,EAAE,6BAA6B,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,sBAAsB,EAAE,6BAA6B,CAAC,MAAM,EAAE,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACnC,mBAAmB,EAAE,+BAA+B,CAAC,UAAU,CAAC,CAAC;IACjE,gBAAgB,EAAE,+BAA+B,CAAC,OAAO,CAAC,CAAC;IAC3D,sBAAsB,EAAE,+BAA+B,CAAC,MAAM,EAAE,CAAC,CAAC;CACrE,CAAC"}

package/dist/dtos/propertyProviderSets.js

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

package/dist/dtos/replyInfo.d.ts

@@ -0,0 +1,6 @@
+export declare class ReplyInfo {
+    readonly id: number;
+    readonly quote: string | undefined;
+    constructor(id: number, quote?: string);
+}
+//# sourceMappingURL=replyInfo.d.ts.map

package/dist/dtos/replyInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replyInfo.d.ts","sourceRoot":"","sources":["../../dtos/replyInfo.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAS;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEvB,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAIzC"}

package/dist/dtos/replyInfo.js

@@ -0,0 +1,8 @@
+export class ReplyInfo {
+    id;
+    quote;
+    constructor(id, quote) {
+        this.id = id;
+        this.quote = quote;
+    }
+}

package/dist/dtos/responses/delay.d.ts

@@ -0,0 +1,16 @@
+import { IActionState } from '../../types/actionState';
+import { IActionWithState } from '../../types/action';
+import { IChatResponse } from '../../types/response';
+import { Milliseconds } from '../../types/timeValues';
+import { TraceId } from '../../types/trace';
+import { ChatInfo } from '../chatInfo';
+export declare class DelayResponse implements IChatResponse {
+    readonly kind: "delay";
+    readonly createdAt: number;
+    readonly chatInfo: ChatInfo;
+    readonly traceId: TraceId;
+    readonly delay: Milliseconds;
+    readonly action: IActionWithState<IActionState>;
+    constructor(delay: Milliseconds, chatInfo: ChatInfo, traceId: TraceId, action: IActionWithState<IActionState>);
+}
+//# sourceMappingURL=delay.d.ts.map

package/dist/dtos/responses/delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../../dtos/responses/delay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,qBAAa,aAAc,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,UAA0B;IACvC,QAAQ,CAAC,SAAS,SAAc;IAEhC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC;CAO7C"}

package/dist/dtos/responses/delay.js

@@ -0,0 +1,15 @@
+import { BotResponseTypes } from '../../types/response';
+export class DelayResponse {
+    kind = BotResponseTypes.delay;
+    createdAt = Date.now();
+    chatInfo;
+    traceId;
+    delay;
+    action;
+    constructor(delay, chatInfo, traceId, action) {
+        this.chatInfo = chatInfo;
+        this.delay = delay;
+        this.traceId = traceId;
+        this.action = action;
+    }
+}

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

@@ -0,0 +1,22 @@
+import { IReplyResponseWithContent } from '../../types/response';
+import { MessageSendingOptions } from '../../types/messageSendingOptions';
+import { IAction } from '../../types/action';
+import { ChatInfo } from '../chatInfo';
+import { TraceId } from '../../types/trace';
+import { ReplyInfo } from '../replyInfo';
+import { IReplyCapture } from '../../types/capture';
+import { InputFile } from '../../types/inputFile';
+export declare class ImageMessage implements IReplyResponseWithContent<InputFile> {
+    readonly kind: "image";
+    readonly createdAt: number;
+    readonly captures: IReplyCapture[];
+    readonly content: InputFile;
+    readonly chatInfo: ChatInfo;
+    readonly replyInfo: ReplyInfo | undefined;
+    readonly traceId: TraceId;
+    readonly disableWebPreview = false;
+    readonly shouldPin: boolean;
+    readonly action: IAction;
+    constructor(image: InputFile, chatInfo: ChatInfo, traceId: TraceId, action: IAction, replyInfo: ReplyInfo | undefined, options?: MessageSendingOptions);
+}
+//# sourceMappingURL=imageMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imageMessage.d.ts","sourceRoot":"","sources":["../../../dtos/responses/imageMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,yBAAyB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,qBAAa,YAAa,YAAW,yBAAyB,CAAC,SAAS,CAAC;IACrE,QAAQ,CAAC,IAAI,UAA0B;IACvC,QAAQ,CAAC,SAAS,SAAc;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAM;IAExC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,SAAS;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAGrB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,qBAAqB;CAStC"}