chz-telegram-bot 0.5.4 → 0.6.8

package/dist/entities/context/messageContext.js

@@ -0,0 +1,116 @@
+import { resolve } from 'path';
+import { ImageMessage } from '../../dtos/responses/imageMessage';
+import { Reaction } from '../../dtos/responses/reaction';
+import { TextMessage } from '../../dtos/responses/textMessage';
+import { VideoMessage } from '../../dtos/responses/videoMessage';
+import { ChatContextInternal } from './chatContext';
+import { ReplyInfo } from '../../dtos/replyInfo';
+/**
+ * Context of action executed in chat, in response to a message
+ */
+export class MessageContextInternal extends ChatContextInternal {
+    /** Information about the user that triggered this action */
+    userInfo;
+    /** Information about the message that triggered this action */
+    messageInfo;
+    /** Collection of Regexp match results on a message that triggered this action. Will be empty if trigger is not a Regexp. */
+    matchResults = [];
+    /** Indicates if cooldown should be started after action is executed. Set to `true` by default. */
+    startCooldown = true;
+    /** Bot info from Telegram */
+    botInfo;
+    customCooldown;
+    getQuotePart(quote) {
+        if (typeof quote != 'boolean')
+            return quote;
+        return this.matchResults.length == 0
+            ? this.messageInfo.text
+            : this.matchResults[0][1];
+    }
+    replyWithText(text, quote, options) {
+        const quotedPart = this.getQuotePart(quote);
+        const response = new TextMessage(text, this.chatInfo, this.traceId, this.action, new ReplyInfo(this.messageInfo.id, quote ? quotedPart : undefined), options);
+        this.responses.push(response);
+        return this.createCaptureController(response);
+    }
+    replyWithImage(name, quote, options) {
+        const quotedPart = this.getQuotePart(quote);
+        const response = new ImageMessage({ source: resolve(`./content/${name}.png`) }, this.chatInfo, this.traceId, this.action, new ReplyInfo(this.messageInfo.id, quote ? quotedPart : undefined), options);
+        this.responses.push(response);
+        return this.createCaptureController(response);
+    }
+    replyWithVideo(name, quote, options) {
+        const quotedPart = this.getQuotePart(quote);
+        const response = new VideoMessage({ source: resolve(`./content/${name}.mp4`) }, this.chatInfo, this.traceId, this.action, new ReplyInfo(this.messageInfo.id, quote ? quotedPart : undefined), options);
+        this.responses.push(response);
+        return this.createCaptureController(response);
+    }
+    skipCooldown() {
+        this.startCooldown = false;
+    }
+    startCustomCooldown(customCooldown) {
+        this.startCooldown = true;
+        this.customCooldown = customCooldown;
+    }
+    /**
+     * Collection of actions that can be done as a reply to a message that triggered this action
+     */
+    reply = {
+        /**
+         * Collection of actions that can be done as a reply to a message, quoting the part that triggered this action
+         * If regex is matched, first match will be quoted
+         */
+        andQuote: {
+            /**
+             * Reply with text message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withText: (text, quote, options) => this.replyWithText(text, quote ?? true, options),
+            /**
+             * Reply with image message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withImage: (name, quote, options) => this.replyWithImage(name, quote ?? true, options),
+            /**
+             * Reply with video/gif message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withVideo: (name, quote, options) => this.replyWithVideo(name, quote ?? true, options)
+        },
+        /**
+         * Reply with text message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withText: (text, options) => this.replyWithText(text, false, options),
+        /**
+         * Reply with image message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withImage: (name, options) => this.replyWithImage(name, false, options),
+        /**
+         * Reply with video/gif message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withVideo: (name, options) => this.replyWithVideo(name, false, options),
+        /**
+         * React to the message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param emoji Telegram emoji to react with.
+         */
+        withReaction: (emoji) => {
+            this.responses.push(new Reaction(this.traceId, this.chatInfo, this.messageInfo.id, emoji, this.action));
+        }
+    };
+}

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

@@ -0,0 +1,89 @@
+import { IActionState } from '../../types/actionState';
+import { TextMessageSendingOptions, MessageSendingOptions } from '../../types/messageSendingOptions';
+import { ReplyCaptureAction } from '../actions/replyCaptureAction';
+import { BaseContextInternal, BaseContextPropertiesToOmit } from './baseContext';
+import { UserInfo } from '../../dtos/userInfo';
+import { MessageInfo } from '../../dtos/messageInfo';
+import { TelegramUser, TelegramEmoji } from '../../types/externalAliases';
+export type ReplyContext<TActionState extends IActionState> = Omit<ReplyContextInternal<TActionState>, BaseContextPropertiesToOmit | 'messageId' | 'startCooldown' | 'customCooldown'>;
+export declare class ReplyContextInternal<TParentActionState extends IActionState> extends BaseContextInternal<ReplyCaptureAction<TParentActionState>> {
+    /** Collection of Regexp match results on a message that triggered this action. Will be empty if trigger is not a Regexp. */
+    matchResults: RegExpExecArray[];
+    /** Id of a message that triggered this action. */
+    replyMessageId: number | undefined;
+    /** Information about the user that triggered this action */
+    userInfo: UserInfo;
+    /** Information about the message that triggered this action */
+    messageInfo: MessageInfo;
+    /** Bot info from Telegram */
+    botInfo: TelegramUser;
+    isInitialized: boolean;
+    private getQuotePart;
+    private replyWithText;
+    private replyWithImage;
+    private replyWithVideo;
+    /**
+     * Stops capturing replies and removes this action
+     */
+    stopCapture(): void;
+    /**
+     * Collection of actions that can be done as a reply to a message that triggered this action
+     */
+    reply: {
+        /**
+         * Collection of actions that can be done as a reply to a message, quoting the part that triggered this action
+         * If regex is matched, first match will be quoted
+         */
+        andQuote: {
+            /**
+             * Reply with text message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withText: (text: string, quote?: string, options?: TextMessageSendingOptions) => import("../..").ICaptureController;
+            /**
+             * Reply with image message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withImage: (name: string, quote?: string, options?: MessageSendingOptions) => import("../..").ICaptureController;
+            /**
+             * Reply with video/gif message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withVideo: (name: string, quote?: string, options?: MessageSendingOptions) => import("../..").ICaptureController;
+        };
+        /**
+         * Reply with text message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withText: (text: string, options?: TextMessageSendingOptions) => import("../..").ICaptureController;
+        /**
+         * Reply with image message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withImage: (name: string, options?: MessageSendingOptions) => import("../..").ICaptureController;
+        /**
+         * Reply with video/gif message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withVideo: (name: string, options?: MessageSendingOptions) => import("../..").ICaptureController;
+        /**
+         * React to the message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param emoji Telegram emoji to react with.
+         */
+        withReaction: (emoji: TelegramEmoji) => void;
+    };
+}
+//# sourceMappingURL=replyContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replyContext.d.ts","sourceRoot":"","sources":["../../../entities/context/replyContext.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACH,yBAAyB,EACzB,qBAAqB,EACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EACH,mBAAmB,EACnB,2BAA2B,EAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE1E,MAAM,MAAM,YAAY,CAAC,YAAY,SAAS,YAAY,IAAI,IAAI,CAC9D,oBAAoB,CAAC,YAAY,CAAC,EAChC,2BAA2B,GAC3B,WAAW,GACX,eAAe,GACf,gBAAgB,CACrB,CAAC;AAEF,qBAAa,oBAAoB,CAC7B,kBAAkB,SAAS,YAAY,CACzC,SAAQ,mBAAmB,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;IACjE,4HAA4H;IAC5H,YAAY,EAAG,eAAe,EAAE,CAAC;IACjC,kDAAkD;IAClD,cAAc,EAAG,MAAM,GAAG,SAAS,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,EAAG,QAAQ,CAAC;IACpB,+DAA+D;IAC/D,WAAW,EAAG,WAAW,CAAC;IAC1B,6BAA6B;IAC7B,OAAO,EAAG,YAAY,CAAC;IAEvB,aAAa,UAAS;IAEtB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,WAAW;IAIX;;OAEG;IACH,KAAK;QACD;;;WAGG;;YAEC;;;;;eAKG;6BAEO,MAAM,UACJ,MAAM,YACJ,yBAAyB;YAIvC;;;;;eAKG;8BAEO,MAAM,UACJ,MAAM,YACJ,qBAAqB;YAKnC;;;;;eAKG;8BAEO,MAAM,UACJ,MAAM,YACJ,qBAAqB;;QAMvC;;;;;WAKG;yBACc,MAAM,YAAY,yBAAyB;QAG5D;;;;;WAKG;0BACe,MAAM,YAAY,qBAAqB;QAIzD;;;;;WAKG;0BACe,MAAM,YAAY,qBAAqB;QAIzD;;;;WAIG;8BACmB,aAAa;MAWrC;CACL"}

package/dist/entities/context/replyContext.js

@@ -0,0 +1,124 @@
+import { ReplyInfo } from '../../dtos/replyInfo';
+import { ImageMessage } from '../../dtos/responses/imageMessage';
+import { Reaction } from '../../dtos/responses/reaction';
+import { TextMessage } from '../../dtos/responses/textMessage';
+import { VideoMessage } from '../../dtos/responses/videoMessage';
+import { resolve } from 'path';
+import { BaseContextInternal } from './baseContext';
+export class ReplyContextInternal extends BaseContextInternal {
+    /** Collection of Regexp match results on a message that triggered this action. Will be empty if trigger is not a Regexp. */
+    matchResults;
+    /** Id of a message that triggered this action. */
+    replyMessageId;
+    /** Information about the user that triggered this action */
+    userInfo;
+    /** Information about the message that triggered this action */
+    messageInfo;
+    /** Bot info from Telegram */
+    botInfo;
+    isInitialized = false;
+    getQuotePart(quote) {
+        if (typeof quote != 'boolean')
+            return quote;
+        return this.matchResults.length == 0
+            ? this.messageInfo.text
+            : this.matchResults[0][1];
+    }
+    replyWithText(text, quote, options) {
+        const quotedPart = this.getQuotePart(quote);
+        const response = new TextMessage(text, this.chatInfo, this.traceId, this.action, new ReplyInfo(this.messageInfo.id, quote ? quotedPart : undefined), options);
+        this.responses.push(response);
+        return this.createCaptureController(response);
+    }
+    replyWithImage(name, quote, options) {
+        const quotedPart = this.getQuotePart(quote);
+        const response = new ImageMessage({ source: resolve(`./content/${name}.png`) }, this.chatInfo, this.traceId, this.action, new ReplyInfo(this.messageInfo.id, quote ? quotedPart : undefined), options);
+        this.responses.push(response);
+        return this.createCaptureController(response);
+    }
+    replyWithVideo(name, quote, options) {
+        const quotedPart = this.getQuotePart(quote);
+        const response = new VideoMessage({ source: resolve(`./content/${name}.mp4`) }, this.chatInfo, this.traceId, this.action, new ReplyInfo(this.messageInfo.id, quote ? quotedPart : undefined), options);
+        this.responses.push(response);
+        return this.createCaptureController(response);
+    }
+    /**
+     * Stops capturing replies and removes this action
+     */
+    stopCapture() {
+        this.action.abortController.abort();
+    }
+    /**
+     * Collection of actions that can be done as a reply to a message that triggered this action
+     */
+    reply = {
+        /**
+         * Collection of actions that can be done as a reply to a message, quoting the part that triggered this action
+         * If regex is matched, first match will be quoted
+         */
+        andQuote: {
+            /**
+             * Reply with text message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withText: (text, quote, options) => {
+                return this.replyWithText(text, quote ?? true, options);
+            },
+            /**
+             * Reply with image message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withImage: (name, quote, options) => {
+                return this.replyWithImage(name, quote ?? true, options);
+            },
+            /**
+             * Reply with video/gif message to message that triggered this action after action execution is finished.
+             * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+             * @param text Message contents.
+             * @param options Message sending option.
+             */
+            withVideo: (name, quote, options) => {
+                return this.replyWithVideo(name, quote ?? true, options);
+            }
+        },
+        /**
+         * Reply with text message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withText: (text, options) => {
+            return this.replyWithText(text, false, options);
+        },
+        /**
+         * Reply with image message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withImage: (name, options) => {
+            return this.replyWithImage(name, false, options);
+        },
+        /**
+         * Reply with video/gif message to message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param text Message contents.
+         * @param options Message sending option.
+         */
+        withVideo: (name, options) => {
+            return this.replyWithVideo(name, false, options);
+        },
+        /**
+         * React to the message that triggered this action after action execution is finished.
+         * If multiple responses are sent, they will be sent in the order they were added, with delay of at least 35ms as per Telegram rate-limit.
+         * @param emoji Telegram emoji to react with.
+         */
+        withReaction: (emoji) => {
+            this.responses.push(new Reaction(this.traceId, this.chatInfo, this.messageInfo.id, emoji, this.action));
+        }
+    };
+}

package/dist/entities/states/actionStateBase.d.ts

@@ -0,0 +1,6 @@
+import { IActionState } from '../../types/actionState';
+export declare class ActionStateBase implements IActionState {
+    pinnedMessages: number[];
+    lastExecutedDate: number;
+}
+//# sourceMappingURL=actionStateBase.d.ts.map

package/dist/entities/states/actionStateBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionStateBase.d.ts","sourceRoot":"","sources":["../../../entities/states/actionStateBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,qBAAa,eAAgB,YAAW,YAAY;IAChD,cAAc,EAAE,MAAM,EAAE,CAAM;IAC9B,gBAAgB,SAAK;CACxB"}

package/dist/entities/states/actionStateBase.js

@@ -0,0 +1,4 @@
+export class ActionStateBase {
+    pinnedMessages = [];
+    lastExecutedDate = 0;
+}

package/dist/entities/taskRecord.d.ts

@@ -0,0 +1,8 @@
+import { Milliseconds } from '../types/timeValues';
+export declare class TaskRecord {
+    readonly name: string;
+    readonly taskId: NodeJS.Timeout;
+    readonly interval: Milliseconds;
+    constructor(name: string, taskId: NodeJS.Timeout, interval: Milliseconds);
+}
+//# sourceMappingURL=taskRecord.d.ts.map

package/dist/entities/taskRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskRecord.d.ts","sourceRoot":"","sources":["../../entities/taskRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,qBAAa,UAAU;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;gBAEpB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY;CAK3E"}

package/dist/entities/taskRecord.js

@@ -0,0 +1,10 @@
+export class TaskRecord {
+    name;
+    taskId;
+    interval;
+    constructor(name, taskId, interval) {
+        this.name = name;
+        this.taskId = taskId;
+        this.interval = interval;
+    }
+}

package/dist/eslint.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@typescript-eslint/utils/ts-eslint").FlatConfig.ConfigArray;
+export default _default;
+//# sourceMappingURL=eslint.config.d.ts.map

package/dist/eslint.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.config.d.ts","sourceRoot":"","sources":["../eslint.config.ts"],"names":[],"mappings":";AAIA,wBAoDE"}

package/dist/eslint.config.js

@@ -0,0 +1,51 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import parser from '@typescript-eslint/parser';
+export default tseslint.config({
+    ignores: ['dist/**']
+}, eslint.configs.recommended, tseslint.configs.strictTypeChecked, {
+    languageOptions: {
+        parser,
+        parserOptions: {
+            project: './tsconfig.json',
+            tsconfigRootDir: __dirname,
+            sourceType: 'module',
+            projectService: true
+        }
+    },
+    plugins: { '@typescript-eslint': tseslint.plugin },
+    rules: {
+        '@typescript-eslint/switch-exhaustiveness-check': 'error',
+        '@typescript-eslint/no-unused-vars': [
+            'error',
+            {
+                args: 'all',
+                argsIgnorePattern: '^_',
+                caughtErrors: 'all',
+                caughtErrorsIgnorePattern: '^_',
+                destructuredArrayIgnorePattern: '^_',
+                varsIgnorePattern: '^_',
+                ignoreRestSiblings: true
+            }
+        ],
+        '@typescript-eslint/no-misused-promises': [
+            'error',
+            {
+                checksVoidReturn: true,
+                checksConditionals: true
+            }
+        ],
+        '@typescript-eslint/restrict-template-expressions': [
+            'error',
+            {
+                allowNumber: true
+            }
+        ],
+        '@typescript-eslint/unbound-method': [
+            'error',
+            {
+                ignoreStatic: true
+            }
+        ]
+    }
+});

package/dist/helpers/builders/commandActionBuilder.d.ts

@@ -0,0 +1,100 @@
+import { CommandHandler } from '../../types/handlers';
+import { CommandCondition } from '../../types/commandCondition';
+import { Seconds } from '../../types/timeValues';
+import { CommandAction } from '../../entities/actions/commandAction';
+import { ActionStateBase } from '../../entities/states/actionStateBase';
+import { IActionState } from '../../types/actionState';
+import { CommandTrigger } from '../../types/commandTrigger';
+import { CooldownInfo } from '../../dtos/cooldownInfo';
+import { CommandActionPropertyProvider } from '../../types/propertyProvider';
+/**
+ * Builder for `CommandAction` with state represented by `TActionState`
+ */
+export declare class CommandActionBuilderWithState<TActionState extends IActionState> {
+    private readonly name;
+    private trigger;
+    private activeProvider;
+    private cooldownSettingsProvider;
+    private blacklistProvider;
+    private whitelistProvider;
+    private allowedUsersProvider;
+    private readmeFactory;
+    private readonly stateConstructor;
+    private handler;
+    private condition;
+    private maxAllowedSimultaniousExecutions;
+    /**
+     * Builder for `CommandAction` with state represented by `TActionState`
+     * @param name Action name, will be used for logging and storage
+     * @param stateConstructor Function that creates default state object
+     */
+    constructor(name: string, stateConstructor: () => TActionState);
+    /**
+     * Defines action trigger
+     * @param 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.
+     */
+    on(trigger: CommandTrigger | CommandTrigger[]): this;
+    /** Defines id (or ids) of users that are allowed to trigger this action.
+     * @param id User id or ids
+     */
+    from(id: number | number[]): this;
+    /**
+     * Sets chats whitelist for this action.
+     * @param chatIds Chats ids to allow.
+     */
+    in(chatIds: number[]): this;
+    /**
+     * Sets chats blacklist for this action.
+     * @param chatIds Chats ids to ignore.
+     */
+    notIn(chatIds: number[]): this;
+    /** Defines action logic itself, will be executed on trigger.
+     * @param handler Callback that will be called on trigger
+     */
+    do(handler: CommandHandler<TActionState>): this;
+    /** Defines condition that will be checked before trigger match check is executed.
+     * @param condition Condition check predicate
+     */
+    when(condition: CommandCondition<TActionState>): this;
+    /**
+     * Sets factory method for readme (shown on /help) for this action.
+     * @param readmeFactory readme factory
+     */
+    withHelp(readmeFactory: (botName: string) => string): this;
+    /** If called during building, action is marked as disabled and never checked. */
+    disabled(): this;
+    /** Sets maximum number of simultaniously executing handlers for this command per chat. 0 is treated as unlimited. */
+    withRatelimit(maxAllowedSimultaniousExecutions: number): this;
+    /** Sets action cooldown settings.
+     * @param cooldownSettings Settings.
+     */
+    withCooldown(cooldownSettings: {
+        cooldown: Seconds;
+        message?: string;
+    }): this;
+    /**
+     * Configures action to use property value providers instead of static value to allow changes in runtime
+     */
+    withConfiguration(configuration: CommandActionProvidersConfiguration | (() => CommandActionProvidersConfiguration)): this;
+    /** Builds action */
+    build(): CommandAction<TActionState>;
+}
+export type CommandActionProvidersConfiguration = {
+    cooldownProvider?: CommandActionPropertyProvider<CooldownInfo>;
+    isActiveProvider?: CommandActionPropertyProvider<boolean>;
+    chatsBlacklistProvider?: CommandActionPropertyProvider<number[]>;
+    chatsWhitelistProvider?: CommandActionPropertyProvider<number[]>;
+    usersWhitelistProvider?: CommandActionPropertyProvider<number[]>;
+};
+/**
+ * Builder for `CommandAction` with state represented by default state (containing only last execution date).
+ */
+export declare class CommandActionBuilder extends CommandActionBuilderWithState<ActionStateBase> {
+    /**
+     * Builder for `CommandAction` with state represented by default state (containing only last execution date).
+     */
+    constructor(name: string);
+}
+//# sourceMappingURL=commandActionBuilder.d.ts.map

package/dist/helpers/builders/commandActionBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandActionBuilder.d.ts","sourceRoot":"","sources":["../../../helpers/builders/commandActionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAE7E;;GAEG;AACH,qBAAa,6BAA6B,CAAC,YAAY,SAAS,YAAY;IACxE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAyC;IAExD,OAAO,CAAC,cAAc,CAAsD;IAC5E,OAAO,CAAC,wBAAwB,CACS;IACzC,OAAO,CAAC,iBAAiB,CACZ;IACb,OAAO,CAAC,iBAAiB,CACZ;IACb,OAAO,CAAC,oBAAoB,CACf;IAEb,OAAO,CAAC,aAAa,CAAiD;IACtE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,gCAAgC,CAAa;IAErD;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,YAAY;IAK9D;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,EAAE;IAM7C;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE;IAO1B;;;OAGG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE;IAMpB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE;IAMvB;;OAEG;IACH,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC;IAMxC;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,YAAY,CAAC;IAM9C;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM;IAMnD,iFAAiF;IACjF,QAAQ;IAMR,qHAAqH;IACrH,aAAa,CAAC,gCAAgC,EAAE,MAAM;IAOtD;;OAEG;IACH,YAAY,CAAC,gBAAgB,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAUtE;;OAEG;IACH,iBAAiB,CACb,aAAa,EACP,mCAAmC,GACnC,CAAC,MAAM,mCAAmC,CAAC;IAwBrD,oBAAoB;IACpB,KAAK;CAkBR;AAED,MAAM,MAAM,mCAAmC,GAAG;IAC9C,gBAAgB,CAAC,EAAE,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAC/D,gBAAgB,CAAC,EAAE,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC1D,sBAAsB,CAAC,EAAE,6BAA6B,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,sBAAsB,CAAC,EAAE,6BAA6B,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,sBAAsB,CAAC,EAAE,6BAA6B,CAAC,MAAM,EAAE,CAAC,CAAC;CACpE,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,6BAA6B,CAAC,eAAe,CAAC;IACpF;;OAEG;gBACS,IAAI,EAAE,MAAM;CAG3B"}