chz-telegram-bot 0.1.0 → 0.1.2

package/README.md

@@ -1,7 +1,7 @@
-
 # chz-bot-Framework
 
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/AlexSolari/botFramework)
+
 ## Overview
 
 botFramework is a TypeScript library that provides a structured approach to building Telegram bots. It handles the complexities of bot lifecycle management, message processing, scheduled tasks, and state persistence.
@@ -9,8 +9,8 @@ botFramework is a TypeScript library that provides a structured approach to buil
 ## Installation
 
 ```
-npm install chz-bot-framework  
-# or  
+npm install chz-bot-framework
+# or
 bun install chz-bot-framework
 ```
 
@@ -19,54 +19,59 @@ bun install chz-bot-framework
 ### 1. Create a new bot project
 
 ```
-mkdir my-telegram-bot  
-cd my-telegram-bot  
-npm init -y  
+mkdir my-telegram-bot
+cd my-telegram-bot
+npm init -y
 npm install chz-telegram-bot
 ```
 
 ### 2. Create a token file
 
-Create a file named  `token.txt`  in your project and paste your Telegram Bot token obtained from BotFather.
+Create a file named `token.txt` in your project and paste your Telegram Bot token obtained from BotFather.
 
 ### 3. Create a basic bot
 
-Create an  `index.ts`  file with the following content:
+Create an `index.ts` file with the following content:
 
 ```typescript
-import { startBot, stopBots, CommandActionBuilder, Seconds } from 'chz-telegram-bot';  
-  
-// Define your command actions  
-const commands = [  
-  new CommandActionBuilder('HelloWorld')  
-    .on('/hello')  
-    .do(async (ctx) => {  
-      ctx.replyWithText('Hello, world!');  
-    })  
-    .build()  
-];  
-  
-// Define scheduled actions (if needed)  
-const scheduled = [];  
-  
-async function main() {  
-  // Start the bot  
-  startBot({
-    name:  'MyFirstBot',
-    tokenFilePath:  './token.txt',
-    commands:  commands,
-    scheduled:  scheduled,
-    chats: {
-        MyChat:  -1001234567890 // Replace with your actual chat ID,
-    },
-    scheduledPeriod: (60  *  5) as  Seconds
-  });
-  
-  // Set up graceful shutdown  
-  process.on('SIGINT', () => stopBots('SIGINT'));  
-  process.on('SIGTERM', () => stopBots('SIGTERM'));  
-}  
-  
+import {
+    startBot,
+    stopBots,
+    CommandActionBuilder,
+    Seconds
+} from 'chz-telegram-bot';
+
+// Define your command actions
+const commands = [
+    new CommandActionBuilder('HelloWorld')
+        .on('/hello')
+        .do(async (ctx) => {
+            ctx.replyWithText('Hello, world!');
+        })
+        .build()
+];
+
+// Define scheduled actions (if needed)
+const scheduled = [];
+
+async function main() {
+    // Start the bot
+    startBot({
+        name: 'MyFirstBot',
+        tokenFilePath: './token.txt',
+        commands: commands,
+        scheduled: scheduled,
+        chats: {
+            MyChat: -1001234567890 // Replace with your actual chat ID,
+        },
+        scheduledPeriod: (60 * 5) as Seconds
+    });
+
+    // Set up graceful shutdown
+    process.on('SIGINT', () => stopBots('SIGINT'));
+    process.on('SIGTERM', () => stopBots('SIGTERM'));
+}
+
 main().catch(console.error);
 ```
 
@@ -83,25 +88,27 @@ bun index.ts
 Command actions are triggered by user messages that match specific patterns:
 
 ```typescript
-import { CommandActionBuilder } from 'chz-telegram-bot';  
-  
-const myCommand = new CommandActionBuilder('StartCommand')  
-  .on('/start')  
-  .do(async (ctx) => {  
-    ctx.replyWithText('Welcome to my bot!');  
-  })  
-  .build();
+import { CommandActionBuilder } from 'chz-telegram-bot';
+
+const myCommand = new CommandActionBuilder('StartCommand')
+    .on('/start')
+    .do(async (ctx) => {
+        ctx.replyWithText('Welcome to my bot!');
+    })
+    .build();
 ```
+
 Message types are also can trigger commands:
+
 ```typescript
-import { CommandActionBuilder, MessageType } from 'chz-telegram-bot';  
-  
-const myCommand = new CommandActionBuilder('WelcomeMessage')  
-  .on(MessageType.NewChatMember)  
-  .do(async (ctx) => {  
-    ctx.replyWithText('Welcome to my group chat!');  
-  })  
-  .build();
+import { CommandActionBuilder, MessageType } from 'chz-telegram-bot';
+
+const myCommand = new CommandActionBuilder('WelcomeMessage')
+    .on(MessageType.NewChatMember)
+    .do(async (ctx) => {
+        ctx.replyWithText('Welcome to my group chat!');
+    })
+    .build();
 ```
 
 ### Scheduled Actions
@@ -109,63 +116,64 @@ const myCommand = new CommandActionBuilder('WelcomeMessage')
 Scheduled actions run periodically without user interaction:
 
 ```typescript
-import { ScheduledActionBuilder, Hours } from 'chz-telegram-bot';  
-  
-const dailyNotification = new ScheduledActionBuilder('GM')  
-  .runAt(9 as Hours) // Run at 9 AM  
-  .do(async (ctx) => {  
-    await ctx.sendTextToChat('Good morning!');  
-  })  
-  .build();
+import { ScheduledActionBuilder, Hours } from 'chz-telegram-bot';
+
+const dailyNotification = new ScheduledActionBuilder('GM')
+    .runAt(9 as Hours) // Run at 9 AM
+    .do(async (ctx) => {
+        ctx.sendTextToChat('Good morning!');
+    })
+    .build();
 ```
 
 ### Replies and message sending
-Depending on a type of action, you will have access to following interaction options:
-
-| Method | Action type | Description
-|----------|----------------|-------
-|`sendTextToChat`|Both|Send text to chat as a standalone message
-|`sendImageToChat`|Both|Send image to chat as a standalone message
-|`sendVideoToChat`|Both|Send video/gif to chat as a standalone message
-|`unpinMessage`|Both|Unpins message by its ID
-|`delayNextResponse`|Both|Delays next reply action my given amount of ms
-|`replyWithText`|Command|Replies with text to a message that triggered an action
-|`replyWithImage`|Command|Replies with image to a message that triggered an action
-|`replyWithVideo`|Command|Replies with video/gif to a message that triggered an action
-|`react`|Command|Sets an emoji reaction to a message that triggered an action
 
+Depending on a type of action, you will have access to following interaction options:
 
-Keep in mind that reply sending is deferred until action execution finished and will be done in order of calling in action handler. 
+| Method            | Action type | Description                                                  |
+| ----------------- | ----------- | ------------------------------------------------------------ |
+| `sendTextToChat`  | Both        | Send text to chat as a standalone message                    |
+| `sendImageToChat` | Both        | Send image to chat as a standalone message                   |
+| `sendVideoToChat` | Both        | Send video/gif to chat as a standalone message               |
+| `unpinMessage`    | Both        | Unpins message by its ID                                     |
+| `wait`            | Both        | Delays next replies from this action by given amount of ms   |
+| `replyWithText`   | Command     | Replies with text to a message that triggered an action      |
+| `replyWithImage`  | Command     | Replies with image to a message that triggered an action     |
+| `replyWithVideo`  | Command     | Replies with video/gif to a message that triggered an action |
+| `react`           | Command     | Sets an emoji reaction to a message that triggered an action |
+
+Keep in mind that reply sending is deferred until action execution finished and will be done in order of calling in action handler.
 Ex:
+
 ```typescript
-ctx.sendTextToChat('Message 1')
-ctx.delayNextResponse(5000 as Millisecond)
-ctx.sendTextToChat('Message 2')
+ctx.sendTextToChat('Message 1');
+ctx.wait(5000 as Millisecond);
+ctx.sendTextToChat('Message 2');
 ```
+
 This will result in `Message 1` text being send, followed by `Message 2` after 5 second delay.
 
 ## Configuration Options
 
 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                                                |
+| `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                                        |
 
 Services object should have following structure:
-| Option           | Type                     | Required | Description                                                   |
+| 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`) | Persistance state provide |
+| `logger` | `ILogger` | No (will default to `JsonLogger`) | Logger service |
+| `scheduler` | `IScheduler` | No (will default to `NodeTimeoutScheduler`) | Scheduler used to scheduled action|
 
 ## Advanced Usage
 
@@ -174,23 +182,24 @@ Services object should have following structure:
 The framework allows you to create custom state for your actions:
 
 ```typescript
-import { ActionStateBase } from 'chz-telegram-bot';  
-  
-class MyCustomState extends ActionStateBase {  
-  counter: number = 0;  
-}  
-  
+import { ActionStateBase } from 'chz-telegram-bot';
+
+class MyCustomState extends ActionStateBase {
+    counter: number = 0;
+}
+
 const counterCommand = new CommandActionBuilderWithState<MyCustomState>(
-	'Counter', 
-	 () => new MyCustomState()
-  )  
-  .on('/count')
-  .do(async (ctx, state) => {  
-    state.counter++;  
-    await ctx.replyWithText(`Count: ${state.counter}`);  
-  })  
-  .build();
+    'Counter',
+    () => new MyCustomState()
+)
+    .on('/count')
+    .do(async (ctx, state) => {
+        state.counter++;
+        ctx.replyWithText(`Count: ${state.counter}`);
+    })
+    .build();
 ```
+
 State is mutable and all changes to it will be saved after execution of action is finished.
 
 ## Stopping the Bot
@@ -198,8 +207,8 @@ State is mutable and all changes to it will be saved after execution of action i
 To properly terminate your bot and clean up resources:
 
 ```typescript
-import { stopBots } from 'chz-telegram-bot';  
-  
-// Call when your application is shutting down  
+import { stopBots } from 'chz-telegram-bot';
+
+// Call when your application is shutting down
 await stopBots('SHUTDOWN');
 ```

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

@@ -6,6 +6,7 @@ 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;

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

@@ -1 +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,6BAA6B,CAAC;AAC/D,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;IAEvC,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"}
+{"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,6BAA6B,CAAC;AAC/D,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

@@ -5,6 +5,7 @@ const response_1 = require("../../types/response");
 class DelayResponse {
     constructor(delay, chatInfo, traceId, action) {
         this.kind = response_1.BotResponseTypes.delay;
+        this.createdAt = Date.now();
         this.chatInfo = chatInfo;
         this.delay = delay;
         this.traceId = traceId;

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

@@ -7,6 +7,7 @@ import { ChatInfo } from '../chatInfo';
 import { TraceId } from '../../types/trace';
 export declare class ImageMessage implements IReplyMessage<InputFile> {
     readonly kind: "image";
+    readonly createdAt: number;
     readonly content: InputFile;
     readonly chatInfo: ChatInfo;
     readonly replyId: number | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"imageMessage.d.ts","sourceRoot":"","sources":["../../../dtos/responses/imageMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,YAAa,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,QAAQ,CAAC,IAAI,UAA0B;IAEvC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,SAAS;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,OAAO,CAAC,EAAE,qBAAqB;CAStC"}
+{"version":3,"file":"imageMessage.d.ts","sourceRoot":"","sources":["../../../dtos/responses/imageMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,YAAa,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,QAAQ,CAAC,IAAI,UAA0B;IACvC,QAAQ,CAAC,SAAS,SAAc;IAEhC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,SAAS;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,OAAO,CAAC,EAAE,qBAAqB;CAStC"}

package/dist/dtos/responses/imageMessage.js

@@ -5,6 +5,7 @@ const response_1 = require("../../types/response");
 class ImageMessage {
     constructor(image, chatInfo, replyId, traceId, action, options) {
         this.kind = response_1.BotResponseTypes.image;
+        this.createdAt = Date.now();
         this.disableWebPreview = false;
         this.content = image;
         this.chatInfo = chatInfo;

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

@@ -6,6 +6,7 @@ import { ChatInfo } from '../chatInfo';
 import { TraceId } from '../../types/trace';
 export declare class Reaction implements IChatResponse {
     readonly kind: "react";
+    readonly createdAt: number;
     readonly chatInfo: ChatInfo;
     readonly messageId: number;
     readonly traceId: TraceId;

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

@@ -1 +1 @@
-{"version":3,"file":"reaction.d.ts","sourceRoot":"","sources":["../../../dtos/responses/reaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,QAAS,YAAW,aAAa;IAC1C,QAAQ,CAAC,IAAI,UAA0B;IAEvC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC;CAQ7C"}
+{"version":3,"file":"reaction.d.ts","sourceRoot":"","sources":["../../../dtos/responses/reaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,QAAS,YAAW,aAAa;IAC1C,QAAQ,CAAC,IAAI,UAA0B;IACvC,QAAQ,CAAC,SAAS,SAAc;IAEhC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC;CAQ7C"}

package/dist/dtos/responses/reaction.js

@@ -5,6 +5,7 @@ const response_1 = require("../../types/response");
 class Reaction {
     constructor(traceId, chatInfo, messageId, emoji, action) {
         this.kind = response_1.BotResponseTypes.react;
+        this.createdAt = Date.now();
         this.chatInfo = chatInfo;
         this.messageId = messageId;
         this.emoji = emoji;

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

@@ -6,6 +6,7 @@ import { ChatInfo } from '../chatInfo';
 import { TraceId } from '../../types/trace';
 export declare class TextMessage implements IReplyMessage<string> {
     readonly kind: "text";
+    readonly createdAt: number;
     readonly content: string;
     readonly chatInfo: ChatInfo;
     readonly replyId: number | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"textMessage.d.ts","sourceRoot":"","sources":["../../../dtos/responses/textMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,WAAY,YAAW,aAAa,CAAC,MAAM,CAAC;IACrD,QAAQ,CAAC,IAAI,SAAyB;IAEtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,OAAO,CAAC,EAAE,yBAAyB;CAU1C"}
+{"version":3,"file":"textMessage.d.ts","sourceRoot":"","sources":["../../../dtos/responses/textMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,WAAY,YAAW,aAAa,CAAC,MAAM,CAAC;IACrD,QAAQ,CAAC,IAAI,SAAyB;IACtC,QAAQ,CAAC,SAAS,SAAc;IAEhC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,OAAO,CAAC,EAAE,yBAAyB;CAU1C"}

package/dist/dtos/responses/textMessage.js

@@ -5,6 +5,7 @@ const response_1 = require("../../types/response");
 class TextMessage {
     constructor(text, chatInfo, replyId, traceId, action, options) {
         this.kind = response_1.BotResponseTypes.text;
+        this.createdAt = Date.now();
         this.content = text;
         this.chatInfo = chatInfo;
         this.replyId = replyId;

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

@@ -5,6 +5,7 @@ import { ChatInfo } from '../chatInfo';
 import { TraceId } from '../../types/trace';
 export declare class UnpinResponse implements IChatResponse {
     readonly kind: "unpin";
+    readonly createdAt: number;
     readonly messageId: number;
     readonly chatInfo: ChatInfo;
     readonly traceId: TraceId;

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

@@ -1 +1 @@
-{"version":3,"file":"unpin.d.ts","sourceRoot":"","sources":["../../../dtos/responses/unpin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,aAAc,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,UAA0B;IAEvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC;CAO7C"}
+{"version":3,"file":"unpin.d.ts","sourceRoot":"","sources":["../../../dtos/responses/unpin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,aAAc,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,UAA0B;IACvC,QAAQ,CAAC,SAAS,SAAc;IAEhC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC;CAO7C"}

package/dist/dtos/responses/unpin.js

@@ -5,6 +5,7 @@ const response_1 = require("../../types/response");
 class UnpinResponse {
     constructor(messageId, chatInfo, traceId, action) {
         this.kind = response_1.BotResponseTypes.unpin;
+        this.createdAt = Date.now();
         this.messageId = messageId;
         this.chatInfo = chatInfo;
         this.traceId = traceId;

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

@@ -7,6 +7,7 @@ import { ChatInfo } from '../chatInfo';
 import { TraceId } from '../../types/trace';
 export declare class VideoMessage implements IReplyMessage<InputFile> {
     readonly kind: "video";
+    readonly createdAt: number;
     readonly content: InputFile;
     readonly chatInfo: ChatInfo;
     readonly replyId: number | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"videoMessage.d.ts","sourceRoot":"","sources":["../../../dtos/responses/videoMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,YAAa,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,QAAQ,CAAC,IAAI,UAA0B;IAEvC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,SAAS;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,OAAO,CAAC,EAAE,qBAAqB;CAStC"}
+{"version":3,"file":"videoMessage.d.ts","sourceRoot":"","sources":["../../../dtos/responses/videoMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,YAAa,YAAW,aAAa,CAAC,SAAS,CAAC;IACzD,QAAQ,CAAC,IAAI,UAA0B;IACvC,QAAQ,CAAC,SAAS,SAAc;IAEhC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,SAAS;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAG5C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,OAAO,CAAC,EAAE,qBAAqB;CAStC"}

package/dist/dtos/responses/videoMessage.js

@@ -5,6 +5,7 @@ const response_1 = require("../../types/response");
 class VideoMessage {
     constructor(video, chatInfo, replyId, traceId, action, options) {
         this.kind = response_1.BotResponseTypes.video;
+        this.createdAt = Date.now();
         this.disableWebPreview = false;
         this.content = video;
         this.chatInfo = chatInfo;

package/dist/entities/botInstance.js

@@ -97,7 +97,7 @@ class BotInstance {
                 }
             }
         }
-        await this.api.flushResponses();
+        this.api.flushResponses();
     }
     async processMessage(msg) {
         const ctx = new messageContext_1.MessageContext(this.storage, this.logger, this.scheduler);
@@ -112,7 +112,7 @@ class BotInstance {
                 this.logger.errorWithTraceId(ctx.botName, ctx.traceId, ctx.chatInfo.name, error, ctx);
             }
         }
-        await this.api.flushResponses();
+        this.api.flushResponses();
     }
 }
 exports.BotInstance = BotInstance;

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

@@ -58,9 +58,9 @@ export declare class ChatContext<TActionState extends IActionState> {
      */
     unpinMessage(messageId: number): void;
     /**
-     * Delays next response by specified amount of time.
+     * Delays next responses by specified amount of time.
      * @param delay Delay in milliseconds.
      */
-    delayNextResponse(delay: Milliseconds): void;
+    wait(delay: Milliseconds): void;
 }
 //# sourceMappingURL=chatContext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chatContext.d.ts","sourceRoot":"","sources":["../../../entities/context/chatContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;GAEG;AACH,qBAAa,WAAW,CAAC,YAAY,SAAS,YAAY;IACtD,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAElD,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAG,cAAc,CAAC;IAClC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAG,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAG,UAAU,CAAC;IAEhC,sCAAsC;IACtC,OAAO,EAAG,OAAO,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAG,MAAM,CAAC;IACjB,wBAAwB;IACxB,QAAQ,EAAG,QAAQ,CAAC;IACpB,uDAAuD;IACvD,SAAS,EAAE,WAAW,EAAE,CAAM;IAE9B,aAAa,UAAS;gBAGlB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,UAAU;IAOzB,qBAAqB,CACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO;IAapB;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAahE;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAc7D;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAc7D;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM;IAW9B;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,YAAY;CAKxC"}
+{"version":3,"file":"chatContext.d.ts","sourceRoot":"","sources":["../../../entities/context/chatContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;GAEG;AACH,qBAAa,WAAW,CAAC,YAAY,SAAS,YAAY;IACtD,SAAS,CAAC,MAAM,EAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAElD,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAG,cAAc,CAAC;IAClC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAG,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAG,UAAU,CAAC;IAEhC,sCAAsC;IACtC,OAAO,EAAG,OAAO,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAG,MAAM,CAAC;IACjB,wBAAwB;IACxB,QAAQ,EAAG,QAAQ,CAAC;IACpB,uDAAuD;IACvD,SAAS,EAAE,WAAW,EAAE,CAAM;IAE9B,aAAa,UAAS;gBAGlB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,UAAU;IAOzB,qBAAqB,CACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,EACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO;IAapB;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAahE;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAc7D;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAc7D;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM;IAW9B;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,YAAY;CAK3B"}

package/dist/entities/context/chatContext.js

@@ -66,10 +66,10 @@ class ChatContext {
         this.responses.push(new unpin_1.UnpinResponse(messageId, this.chatInfo, this.traceId, this.action));
     }
     /**
-     * Delays next response by specified amount of time.
+     * Delays next responses by specified amount of time.
      * @param delay Delay in milliseconds.
      */
-    delayNextResponse(delay) {
+    wait(delay) {
         this.responses.push(new delay_1.DelayResponse(delay, this.chatInfo, this.traceId, this.action));
     }
 }

package/dist/services/responseProcessingQueue.d.ts

@@ -0,0 +1,12 @@
+export type QueueItem = {
+    priority: number;
+    callback: () => Promise<void>;
+};
+export declare class ResponseProcessingQueue {
+    items: QueueItem[];
+    isFlushing: boolean;
+    enqueue(item: QueueItem): void;
+    flushReadyItems(): Promise<void>;
+    private peek;
+}
+//# sourceMappingURL=responseProcessingQueue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responseProcessingQueue.d.ts","sourceRoot":"","sources":["../../services/responseProcessingQueue.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AAIF,qBAAa,uBAAuB;IAChC,KAAK,EAAE,SAAS,EAAE,CAAM;IACxB,UAAU,UAAS;IAEnB,OAAO,CAAC,IAAI,EAAE,SAAS;IAmBjB,eAAe;IAoBrB,OAAO,CAAC,IAAI;CAGf"}

package/dist/services/responseProcessingQueue.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseProcessingQueue = void 0;
+const promises_1 = require("timers/promises");
+const TELEGRAM_RATELIMIT_DELAY = 35;
+class ResponseProcessingQueue {
+    constructor() {
+        this.items = [];
+        this.isFlushing = false;
+    }
+    enqueue(item) {
+        if (this.items.length === 0 ||
+            item.priority >= this.items[this.items.length - 1].priority) {
+            this.items.push(item);
+            return;
+        }
+        let insertIndex = this.items.length;
+        while (insertIndex > 0 &&
+            this.items[insertIndex - 1].priority > item.priority) {
+            insertIndex--;
+        }
+        this.items.splice(insertIndex, 0, item);
+    }
+    async flushReadyItems() {
+        if (this.isFlushing)
+            return;
+        this.isFlushing = true;
+        while (this.items.length) {
+            if (Date.now() >= this.peek().priority) {
+                const item = this.items.shift();
+                if (!item)
+                    return;
+                await item.callback();
+            }
+            else {
+                await (0, promises_1.setTimeout)(TELEGRAM_RATELIMIT_DELAY);
+            }
+        }
+        this.isFlushing = false;
+    }
+    peek() {
+        return this.items[0];
+    }
+}
+exports.ResponseProcessingQueue = ResponseProcessingQueue;

package/dist/services/telegramApi.d.ts

@@ -3,15 +3,14 @@ import { BotResponse } from '../types/response';
 import { Telegram } from 'telegraf/typings/telegram';
 import { ILogger } from '../types/logger';
 export declare class TelegramApiService {
+    private readonly queue;
     private readonly telegram;
     private readonly storage;
     private readonly logger;
     private readonly botName;
-    private readonly messageQueue;
-    isFlushing: boolean;
     constructor(botName: string, telegram: Telegram, storage: IStorageClient, logger: ILogger);
     enqueueBatchedResponses(responses: BotResponse[]): void;
-    flushResponses(): Promise<void>;
+    flushResponses(): void;
     private pinIfShould;
     private processResponse;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"telegramApi.d.ts","sourceRoot":"","sources":["../../services/telegramApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI1C,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,UAAU,UAAS;gBAGf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,OAAO;IAQnB,uBAAuB,CAAC,SAAS,EAAE,WAAW,EAAE;IAM1C,cAAc;YA2BN,WAAW;YAqBX,eAAe;CA8EhC"}
+{"version":3,"file":"telegramApi.d.ts","sourceRoot":"","sources":["../../services/telegramApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG1C,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAG7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,OAAO;IAQnB,uBAAuB,CAAC,SAAS,EAAE,WAAW,EAAE;IA4BhD,cAAc;YAIA,WAAW;YAqBX,eAAe;CA4EhC"}

package/dist/services/telegramApi.js

@@ -1,39 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TelegramApiService = void 0;
-const promises_1 = require("timers/promises");
-const TELEGRAM_RATELIMIT_DELAY = 35;
+const responseProcessingQueue_1 = require("./responseProcessingQueue");
 class TelegramApiService {
     constructor(botName, telegram, storage, logger) {
-        this.messageQueue = [];
-        this.isFlushing = false;
+        this.queue = new responseProcessingQueue_1.ResponseProcessingQueue();
         this.telegram = telegram;
         this.botName = botName;
         this.storage = storage;
         this.logger = logger;
     }
     enqueueBatchedResponses(responses) {
+        let offset = 0;
         for (const response of responses) {
-            this.messageQueue.push(response);
-        }
-    }
-    async flushResponses() {
-        if (this.isFlushing)
-            return;
-        this.isFlushing = true;
-        while (this.messageQueue.length) {
-            const message = this.messageQueue.shift();
-            if (!message)
-                break;
-            try {
-                await this.processResponse(message);
-                await (0, promises_1.setTimeout)(TELEGRAM_RATELIMIT_DELAY);
-            }
-            catch (error) {
-                this.logger.errorWithTraceId(this.botName, message.traceId, message.chatInfo.name, error, message);
+            if (response.kind == 'delay') {
+                offset += response.delay;
+                continue;
             }
+            const queueItem = {
+                callback: async () => {
+                    try {
+                        await this.processResponse(response);
+                    }
+                    catch (error) {
+                        this.logger.errorWithTraceId(this.botName, response.traceId, response.chatInfo.name, error, response);
+                    }
+                },
+                priority: response.createdAt + offset
+            };
+            this.queue.enqueue(queueItem);
         }
-        this.isFlushing = false;
+    }
+    flushResponses() {
+        this.queue.flushReadyItems();
     }
     async pinIfShould(response, sentMessage) {
         if (response.shouldPin) {
@@ -84,9 +83,7 @@ class TelegramApiService {
                 });
                 break;
             case 'delay':
-                if (response.delay > TELEGRAM_RATELIMIT_DELAY) {
-                    await (0, promises_1.setTimeout)(response.delay - TELEGRAM_RATELIMIT_DELAY);
-                }
+                break;
         }
     }
 }

package/dist/types/response.d.ts

@@ -21,6 +21,7 @@ export interface IChatResponse {
     readonly kind: keyof typeof BotResponseTypes;
     readonly chatInfo: ChatInfo;
     readonly traceId: TraceId;
+    readonly createdAt: number;
     readonly action: IActionWithState<IActionState>;
 }
 export interface IReplyMessage<TType> extends IChatResponse {

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

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../types/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,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,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAEX,MAAM,MAAM,WAAW,GACjB,aAAa,GACb,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,CAAE,SAAQ,aAAa;IACvD,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B"}
+{"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,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,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAEX,MAAM,MAAM,WAAW,GACjB,aAAa,GACb,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC1B,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,gBAAgB,CAAC,YAAY,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,CAAE,SAAQ,aAAa;IACvD,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B"}

package/dtos/responses/delay.ts

@@ -7,6 +7,7 @@ import { ChatInfo } from '../chatInfo';
 
 export class DelayResponse implements IChatResponse {
     readonly kind = BotResponseTypes.delay;
+    readonly createdAt = Date.now();
 
     readonly chatInfo: ChatInfo;
     readonly traceId: TraceId;

package/dtos/responses/imageMessage.ts

@@ -8,6 +8,7 @@ import { TraceId } from '../../types/trace';
 
 export class ImageMessage implements IReplyMessage<InputFile> {
     readonly kind = BotResponseTypes.image;
+    readonly createdAt = Date.now();
 
     readonly content: InputFile;
     readonly chatInfo: ChatInfo;

package/dtos/responses/reaction.ts

@@ -7,6 +7,7 @@ import { TraceId } from '../../types/trace';
 
 export class Reaction implements IChatResponse {
     readonly kind = BotResponseTypes.react;
+    readonly createdAt = Date.now();
 
     readonly chatInfo: ChatInfo;
     readonly messageId: number;

package/dtos/responses/textMessage.ts

@@ -7,6 +7,7 @@ import { TraceId } from '../../types/trace';
 
 export class TextMessage implements IReplyMessage<string> {
     readonly kind = BotResponseTypes.text;
+    readonly createdAt = Date.now();
 
     readonly content: string;
     readonly chatInfo: ChatInfo;

package/dtos/responses/unpin.ts

@@ -6,6 +6,7 @@ import { TraceId } from '../../types/trace';
 
 export class UnpinResponse implements IChatResponse {
     readonly kind = BotResponseTypes.unpin;
+    readonly createdAt = Date.now();
 
     readonly messageId: number;
     readonly chatInfo: ChatInfo;

package/dtos/responses/videoMessage.ts

@@ -8,6 +8,7 @@ import { TraceId } from '../../types/trace';
 
 export class VideoMessage implements IReplyMessage<InputFile> {
     readonly kind = BotResponseTypes.video;
+    readonly createdAt = Date.now();
 
     readonly content: InputFile;
     readonly chatInfo: ChatInfo;

package/entities/botInstance.ts

@@ -212,7 +212,7 @@ export class BotInstance {
             }
         }
 
-        await this.api.flushResponses();
+        this.api.flushResponses();
     }
 
     private async processMessage(msg: IncomingMessage) {
@@ -240,6 +240,6 @@ export class BotInstance {
             }
         }
 
-        await this.api.flushResponses();
+        this.api.flushResponses();
     }
 }

package/entities/context/chatContext.ts

@@ -145,10 +145,10 @@ export class ChatContext<TActionState extends IActionState> {
     }
 
     /**
-     * Delays next response by specified amount of time.
+     * Delays next responses by specified amount of time.
      * @param delay Delay in milliseconds.
      */
-    delayNextResponse(delay: Milliseconds) {
+    wait(delay: Milliseconds) {
         this.responses.push(
             new DelayResponse(delay, this.chatInfo, this.traceId, this.action)
         );

package/package.json

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

package/services/responseProcessingQueue.ts

@@ -0,0 +1,57 @@
+import { setTimeout } from 'timers/promises';
+import { Milliseconds } from '../types/timeValues';
+
+export type QueueItem = {
+    priority: number;
+    callback: () => Promise<void>;
+};
+
+const TELEGRAM_RATELIMIT_DELAY = 35 as Milliseconds;
+
+export class ResponseProcessingQueue {
+    items: QueueItem[] = [];
+    isFlushing = false;
+
+    enqueue(item: QueueItem) {
+        if (
+            this.items.length === 0 ||
+            item.priority >= this.items[this.items.length - 1]!.priority
+        ) {
+            this.items.push(item);
+            return;
+        }
+
+        let insertIndex = this.items.length;
+        while (
+            insertIndex > 0 &&
+            this.items[insertIndex - 1]!.priority > item.priority
+        ) {
+            insertIndex--;
+        }
+        this.items.splice(insertIndex, 0, item);
+    }
+
+    async flushReadyItems() {
+        if (this.isFlushing) return;
+
+        this.isFlushing = true;
+
+        while (this.items.length) {
+            if (Date.now() >= this.peek()!.priority) {
+                const item = this.items.shift();
+
+                if (!item) return;
+
+                await item.callback();
+            } else {
+                await setTimeout(TELEGRAM_RATELIMIT_DELAY);
+            }
+        }
+
+        this.isFlushing = false;
+    }
+
+    private peek() {
+        return this.items[0];
+    }
+}

package/services/telegramApi.ts

@@ -2,20 +2,16 @@ import { Message } from 'telegraf/types';
 import { IStorageClient } from '../types/storage';
 import { BotResponse, IReplyMessage } from '../types/response';
 import { Telegram } from 'telegraf/typings/telegram';
-import { setTimeout } from 'timers/promises';
-import { Milliseconds } from '../types/timeValues';
 import { ILogger } from '../types/logger';
-
-const TELEGRAM_RATELIMIT_DELAY = 35 as Milliseconds;
+import { QueueItem, ResponseProcessingQueue } from './responseProcessingQueue';
 
 export class TelegramApiService {
+    private readonly queue = new ResponseProcessingQueue();
     private readonly telegram: Telegram;
     private readonly storage: IStorageClient;
     private readonly logger: ILogger;
 
     private readonly botName: string;
-    private readonly messageQueue: BotResponse[] = [];
-    isFlushing = false;
 
     constructor(
         botName: string,
@@ -30,36 +26,35 @@ export class TelegramApiService {
     }
 
     enqueueBatchedResponses(responses: BotResponse[]) {
+        let offset = 0;
         for (const response of responses) {
-            this.messageQueue.push(response);
-        }
-    }
-
-    async flushResponses() {
-        if (this.isFlushing) return;
-
-        this.isFlushing = true;
-
-        while (this.messageQueue.length) {
-            const message = this.messageQueue.shift();
-
-            if (!message) break;
-
-            try {
-                await this.processResponse(message);
-                await setTimeout(TELEGRAM_RATELIMIT_DELAY);
-            } catch (error) {
-                this.logger.errorWithTraceId(
-                    this.botName,
-                    message.traceId,
-                    message.chatInfo.name,
-                    error,
-                    message
-                );
+            if (response.kind == 'delay') {
+                offset += response.delay;
+                continue;
             }
+
+            const queueItem: QueueItem = {
+                callback: async () => {
+                    try {
+                        await this.processResponse(response);
+                    } catch (error) {
+                        this.logger.errorWithTraceId(
+                            this.botName,
+                            response.traceId,
+                            response.chatInfo.name,
+                            error,
+                            response
+                        );
+                    }
+                },
+                priority: response.createdAt + offset
+            };
+            this.queue.enqueue(queueItem);
         }
+    }
 
-        this.isFlushing = false;
+    flushResponses() {
+        this.queue.flushReadyItems();
     }
 
     private async pinIfShould<T>(
@@ -156,9 +151,7 @@ export class TelegramApiService {
                 );
                 break;
             case 'delay':
-                if (response.delay > TELEGRAM_RATELIMIT_DELAY) {
-                    await setTimeout(response.delay - TELEGRAM_RATELIMIT_DELAY);
-                }
+                break;
         }
     }
 }

package/types/response.ts

@@ -30,6 +30,7 @@ export interface IChatResponse {
     readonly kind: keyof typeof BotResponseTypes;
     readonly chatInfo: ChatInfo;
     readonly traceId: TraceId;
+    readonly createdAt: number;
 
     readonly action: IActionWithState<IActionState>;
 }