chz-telegram-bot 0.5.4 → 0.6.8

package/dist/helpers/builders/commandActionBuilder.js

@@ -0,0 +1,146 @@
+import { CommandAction } from '../../entities/actions/commandAction';
+import { ActionStateBase } from '../../entities/states/actionStateBase';
+import { toArray } from '../toArray';
+import { Noop } from '../noop';
+import { CooldownInfo } from '../../dtos/cooldownInfo';
+/**
+ * Builder for `CommandAction` with state represented by `TActionState`
+ */
+export class CommandActionBuilderWithState {
+    name;
+    trigger = [];
+    activeProvider = () => true;
+    cooldownSettingsProvider = () => new CooldownInfo(0);
+    blacklistProvider = () => [];
+    whitelistProvider = () => [];
+    allowedUsersProvider = () => [];
+    readmeFactory = Noop.emptyString;
+    stateConstructor;
+    handler = Noop.call;
+    condition = Noop.true;
+    maxAllowedSimultaniousExecutions = 0;
+    /**
+     * 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, stateConstructor) {
+        this.name = name;
+        this.stateConstructor = stateConstructor;
+    }
+    /**
+     * 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) {
+        this.trigger = trigger;
+        return this;
+    }
+    /** Defines id (or ids) of users that are allowed to trigger this action.
+     * @param id User id or ids
+     */
+    from(id) {
+        const ids = toArray(id);
+        this.allowedUsersProvider = () => ids;
+        return this;
+    }
+    /**
+     * Sets chats whitelist for this action.
+     * @param chatIds Chats ids to allow.
+     */
+    in(chatIds) {
+        this.whitelistProvider = () => chatIds;
+        return this;
+    }
+    /**
+     * Sets chats blacklist for this action.
+     * @param chatIds Chats ids to ignore.
+     */
+    notIn(chatIds) {
+        this.blacklistProvider = () => chatIds;
+        return this;
+    }
+    /** Defines action logic itself, will be executed on trigger.
+     * @param handler Callback that will be called on trigger
+     */
+    do(handler) {
+        this.handler = handler;
+        return this;
+    }
+    /** Defines condition that will be checked before trigger match check is executed.
+     * @param condition Condition check predicate
+     */
+    when(condition) {
+        this.condition = condition;
+        return this;
+    }
+    /**
+     * Sets factory method for readme (shown on /help) for this action.
+     * @param readmeFactory readme factory
+     */
+    withHelp(readmeFactory) {
+        this.readmeFactory = readmeFactory;
+        return this;
+    }
+    /** If called during building, action is marked as disabled and never checked. */
+    disabled() {
+        this.activeProvider = () => false;
+        return this;
+    }
+    /** Sets maximum number of simultaniously executing handlers for this command per chat. 0 is treated as unlimited. */
+    withRatelimit(maxAllowedSimultaniousExecutions) {
+        this.maxAllowedSimultaniousExecutions =
+            maxAllowedSimultaniousExecutions;
+        return this;
+    }
+    /** Sets action cooldown settings.
+     * @param cooldownSettings Settings.
+     */
+    withCooldown(cooldownSettings) {
+        const settings = new CooldownInfo(cooldownSettings.cooldown, cooldownSettings.message);
+        this.cooldownSettingsProvider = () => settings;
+        return this;
+    }
+    /**
+     * Configures action to use property value providers instead of static value to allow changes in runtime
+     */
+    withConfiguration(configuration) {
+        if (typeof configuration == 'function') {
+            configuration = configuration();
+        }
+        if (configuration.cooldownProvider)
+            this.cooldownSettingsProvider = configuration.cooldownProvider;
+        if (configuration.chatsWhitelistProvider)
+            this.whitelistProvider = configuration.chatsWhitelistProvider;
+        if (configuration.chatsBlacklistProvider)
+            this.blacklistProvider = configuration.chatsBlacklistProvider;
+        if (configuration.usersWhitelistProvider)
+            this.allowedUsersProvider = configuration.usersWhitelistProvider;
+        if (configuration.isActiveProvider)
+            this.activeProvider = configuration.isActiveProvider;
+        return this;
+    }
+    /** Builds action */
+    build() {
+        return new CommandAction(this.trigger, this.handler, this.name, {
+            cooldownProvider: this.cooldownSettingsProvider,
+            isActiveProvider: this.activeProvider,
+            chatsBlacklistProvider: this.blacklistProvider,
+            chatsWhitelistProvider: this.whitelistProvider,
+            usersWhitelistProvider: this.allowedUsersProvider
+        }, this.maxAllowedSimultaniousExecutions, this.condition, this.stateConstructor, this.readmeFactory);
+    }
+}
+/**
+ * Builder for `CommandAction` with state represented by default state (containing only last execution date).
+ */
+export class CommandActionBuilder extends CommandActionBuilderWithState {
+    /**
+     * Builder for `CommandAction` with state represented by default state (containing only last execution date).
+     */
+    constructor(name) {
+        super(name, () => new ActionStateBase());
+    }
+}

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

@@ -0,0 +1,37 @@
+import { InlineQueryHandler } from '../../types/handlers';
+import { InlineQueryAction } from '../../entities/actions/inlineQueryAction';
+import { InlineActionPropertyProvider } from '../../types/propertyProvider';
+/**
+ * Builder for `InlineQueryAction`
+ */
+export declare class InlineQueryActionBuilder {
+    private readonly name;
+    private pattern;
+    private activeProvider;
+    private handler;
+    /**
+     * Builder for `InlineQueryAction`
+     * @param name Action name, will be used for logging and storage
+     */
+    constructor(name: string);
+    /**
+     * Defines action pattern to check if action should be executed, if not setup, check will default to true
+     * @param trigger RegExp to check
+     */
+    on(pattern: RegExp): this;
+    /** Defines action logic itself, will be executed.
+     * @param handler Callback that will be called
+     */
+    do(handler: InlineQueryHandler): this;
+    /** If called during building, action is marked as disabled and never checked. */
+    disabled(): this;
+    /**
+     * Configures action to use property value providers instead of static value to allow changes in runtime
+     */
+    withConfiguration(configuration: {
+        isActiveProvider?: InlineActionPropertyProvider<boolean>;
+    }): this;
+    /** Builds action */
+    build(): InlineQueryAction;
+}
+//# sourceMappingURL=inlineQueryActionBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inlineQueryActionBuilder.d.ts","sourceRoot":"","sources":["../../../helpers/builders/inlineQueryActionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAE5E;;GAEG;AACH,qBAAa,wBAAwB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO,CAAC,cAAc,CAAqD;IAC3E,OAAO,CAAC,OAAO,CAAiC;IAEhD;;;OAGG;gBACS,IAAI,EAAE,MAAM;IAIxB;;;OAGG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM;IAMlB;;OAEG;IACH,EAAE,CAAC,OAAO,EAAE,kBAAkB;IAM9B,iFAAiF;IACjF,QAAQ;IAMR;;OAEG;IACH,iBAAiB,CAAC,aAAa,EAAE;QAC7B,gBAAgB,CAAC,EAAE,4BAA4B,CAAC,OAAO,CAAC,CAAC;KAC5D;IAOD,oBAAoB;IACpB,KAAK;CAQR"}

package/dist/helpers/builders/inlineQueryActionBuilder.js

@@ -0,0 +1,50 @@
+import { Noop } from '../noop';
+import { InlineQueryAction } from '../../entities/actions/inlineQueryAction';
+/**
+ * Builder for `InlineQueryAction`
+ */
+export class InlineQueryActionBuilder {
+    name;
+    pattern = /.+/gi;
+    activeProvider = () => true;
+    handler = Noop.call;
+    /**
+     * Builder for `InlineQueryAction`
+     * @param name Action name, will be used for logging and storage
+     */
+    constructor(name) {
+        this.name = name;
+    }
+    /**
+     * Defines action pattern to check if action should be executed, if not setup, check will default to true
+     * @param trigger RegExp to check
+     */
+    on(pattern) {
+        this.pattern = pattern;
+        return this;
+    }
+    /** Defines action logic itself, will be executed.
+     * @param handler Callback that will be called
+     */
+    do(handler) {
+        this.handler = handler;
+        return this;
+    }
+    /** If called during building, action is marked as disabled and never checked. */
+    disabled() {
+        this.activeProvider = () => false;
+        return this;
+    }
+    /**
+     * Configures action to use property value providers instead of static value to allow changes in runtime
+     */
+    withConfiguration(configuration) {
+        if (configuration.isActiveProvider)
+            this.activeProvider = configuration.isActiveProvider;
+        return this;
+    }
+    /** Builds action */
+    build() {
+        return new InlineQueryAction(this.handler, this.name, this.activeProvider, this.pattern);
+    }
+}

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

@@ -0,0 +1,68 @@
+import { ScheduledAction } from '../../entities/actions/scheduledAction';
+import { ActionStateBase } from '../../entities/states/actionStateBase';
+import { IActionState } from '../../types/actionState';
+import { ScheduledHandler } from '../../types/handlers';
+import { ScheduledActionPropertyProvider } from '../../types/propertyProvider';
+import { Hours, HoursOfDay } from '../../types/timeValues';
+/**
+ * Builder for `ScheduledAction` with state represented by `TActionState`
+ */
+export declare class ScheduledActionBuilderWithState<TActionState extends IActionState> {
+    private readonly name;
+    private readonly cachedStateFactories;
+    private readonly stateConstructor;
+    private handler;
+    private whitelistProvider;
+    private activeProvider;
+    private timeinHoursProvider;
+    /**
+     * Builder for `ScheduledAction` 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);
+    /**
+     * Sets whitelist for this action.
+     * @param chatIds Chat ids to execute in.
+     */
+    in(chatIds: number[]): this;
+    /**
+     * Defines time for scheduled item execution.
+     * @param time Time of day (0 - 23) to execute action.
+     */
+    runAt(time: HoursOfDay): this;
+    /** Defines action logic itself, will be executed on timer.
+     * @param handler Callback that will be called on timer.
+     */
+    do(handler: ScheduledHandler<TActionState>): this;
+    /**
+     * Defines process-wide cache, that is shared by all actions of this type (even in different bot instances).
+     * Can be used for fetch request de-duping, etc.
+     * @param key Key that will be used to retrieve value from cache.
+     * @param itemFactory Callback that will be executed once to create cached value.
+     * @param invalidationTimeoutInHours Timeout for cache invalidation.
+     */
+    withSharedCache(key: string, itemFactory: () => Promise<unknown>, invalidationTimeoutInHours?: Hours): this;
+    /** If called during building, action is marked as disabled and never checked. */
+    disabled(): this;
+    /**
+     * Configures action to use property value providers instead of static value to allow changes in runtime
+     */
+    withConfiguration(configuration: {
+        timeinHoursProvider?: ScheduledActionPropertyProvider<HoursOfDay>;
+        isActiveProvider?: ScheduledActionPropertyProvider<boolean>;
+        chatsWhitelistProvider?: ScheduledActionPropertyProvider<number[]>;
+    }): this;
+    /** Builds action */
+    build(): ScheduledAction<TActionState>;
+}
+/**
+ * Builder for `ScheduledAction` with state represented by default state (containing only last execution date).
+ */
+export declare class ScheduledActionBuilder extends ScheduledActionBuilderWithState<ActionStateBase> {
+    /**
+     * Builder for `ScheduledAction` with state represented by default state (containing only last execution date).
+     */
+    constructor(name: string);
+}
+//# sourceMappingURL=scheduledActionBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduledActionBuilder.d.ts","sourceRoot":"","sources":["../../../helpers/builders/scheduledActionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;GAEG;AACH,qBAAa,+BAA+B,CACxC,YAAY,SAAS,YAAY;IAEjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGjC;IACJ,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,OAAO,CAA6C;IAE5D,OAAO,CAAC,iBAAiB,CACZ;IACb,OAAO,CAAC,cAAc,CACb;IACT,OAAO,CAAC,mBAAmB,CACf;IAEZ;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,YAAY;IAK9D;;;OAGG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE;IAMpB;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU;IAMtB;;OAEG;IACH,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC;IAM1C;;;;;;OAMG;IACH,eAAe,CACX,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACnC,0BAA0B,GAAE,KAAmB;IAUnD,iFAAiF;IACjF,QAAQ;IAMR;;OAEG;IACH,iBAAiB,CAAC,aAAa,EAAE;QAC7B,mBAAmB,CAAC,EAAE,+BAA+B,CAAC,UAAU,CAAC,CAAC;QAClE,gBAAgB,CAAC,EAAE,+BAA+B,CAAC,OAAO,CAAC,CAAC;QAC5D,sBAAsB,CAAC,EAAE,+BAA+B,CAAC,MAAM,EAAE,CAAC,CAAC;KACtE;IAaD,oBAAoB;IACpB,KAAK;CAaR;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,+BAA+B,CAAC,eAAe,CAAC;IACxF;;OAEG;gBACS,IAAI,EAAE,MAAM;CAG3B"}

package/dist/helpers/builders/scheduledActionBuilder.js

@@ -0,0 +1,95 @@
+import { ScheduledAction } from '../../entities/actions/scheduledAction';
+import { CachedStateFactory } from '../../entities/cachedStateFactory';
+import { ActionStateBase } from '../../entities/states/actionStateBase';
+import { Noop } from '../noop';
+/**
+ * Builder for `ScheduledAction` with state represented by `TActionState`
+ */
+export class ScheduledActionBuilderWithState {
+    name;
+    cachedStateFactories = new Map();
+    stateConstructor;
+    handler = Noop.call;
+    whitelistProvider = () => [];
+    activeProvider = () => true;
+    timeinHoursProvider = () => 0;
+    /**
+     * Builder for `ScheduledAction` 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, stateConstructor) {
+        this.name = name;
+        this.stateConstructor = stateConstructor;
+    }
+    /**
+     * Sets whitelist for this action.
+     * @param chatIds Chat ids to execute in.
+     */
+    in(chatIds) {
+        this.whitelistProvider = () => chatIds;
+        return this;
+    }
+    /**
+     * Defines time for scheduled item execution.
+     * @param time Time of day (0 - 23) to execute action.
+     */
+    runAt(time) {
+        this.timeinHoursProvider = () => time;
+        return this;
+    }
+    /** Defines action logic itself, will be executed on timer.
+     * @param handler Callback that will be called on timer.
+     */
+    do(handler) {
+        this.handler = handler;
+        return this;
+    }
+    /**
+     * Defines process-wide cache, that is shared by all actions of this type (even in different bot instances).
+     * Can be used for fetch request de-duping, etc.
+     * @param key Key that will be used to retrieve value from cache.
+     * @param itemFactory Callback that will be executed once to create cached value.
+     * @param invalidationTimeoutInHours Timeout for cache invalidation.
+     */
+    withSharedCache(key, itemFactory, invalidationTimeoutInHours = 20) {
+        this.cachedStateFactories.set(key, new CachedStateFactory(itemFactory, invalidationTimeoutInHours));
+        return this;
+    }
+    /** If called during building, action is marked as disabled and never checked. */
+    disabled() {
+        this.activeProvider = () => false;
+        return this;
+    }
+    /**
+     * Configures action to use property value providers instead of static value to allow changes in runtime
+     */
+    withConfiguration(configuration) {
+        if (configuration.chatsWhitelistProvider)
+            this.whitelistProvider = configuration.chatsWhitelistProvider;
+        if (configuration.timeinHoursProvider)
+            this.timeinHoursProvider = configuration.timeinHoursProvider;
+        if (configuration.isActiveProvider)
+            this.activeProvider = configuration.isActiveProvider;
+        return this;
+    }
+    /** Builds action */
+    build() {
+        return new ScheduledAction(this.name, this.handler, {
+            chatsWhitelistProvider: this.whitelistProvider,
+            isActiveProvider: this.activeProvider,
+            timeinHoursProvider: this.timeinHoursProvider
+        }, this.cachedStateFactories, this.stateConstructor);
+    }
+}
+/**
+ * Builder for `ScheduledAction` with state represented by default state (containing only last execution date).
+ */
+export class ScheduledActionBuilder extends ScheduledActionBuilderWithState {
+    /**
+     * Builder for `ScheduledAction` with state represented by default state (containing only last execution date).
+     */
+    constructor(name) {
+        super(name, () => new ActionStateBase());
+    }
+}

package/dist/helpers/mapUtils.d.ts

@@ -0,0 +1,10 @@
+type KeyedReadonlyCollection<K, V> = {
+    get: (key: K) => V | undefined;
+};
+type KeyedWriteableCollection<K, V> = KeyedReadonlyCollection<K, V> & {
+    set: (key: K, value: V) => KeyedWriteableCollection<K, V>;
+};
+export declare function getOrSetIfNotExists<K, V>(map: KeyedWriteableCollection<K, V>, key: K, fallback: V): V;
+export declare function getOrThrow<K, V>(map: KeyedReadonlyCollection<K, V>, key: K, error?: string): NonNullable<V>;
+export {};
+//# sourceMappingURL=mapUtils.d.ts.map

package/dist/helpers/mapUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapUtils.d.ts","sourceRoot":"","sources":["../../helpers/mapUtils.ts"],"names":[],"mappings":"AAAA,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI;IAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;CAAE,CAAC;AACxE,KAAK,wBAAwB,CAAC,CAAC,EAAE,CAAC,IAAI,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAClE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC7D,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACpC,GAAG,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,EACnC,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,CAAC,KAQd;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAC3B,GAAG,EAAE,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,EAClC,GAAG,EAAE,CAAC,EACN,KAAK,GAAE,MAAsC,kBAMhD"}

package/dist/helpers/mapUtils.js

@@ -0,0 +1,13 @@
+export function getOrSetIfNotExists(map, key, fallback) {
+    const existingValue = map.get(key);
+    if (existingValue)
+        return existingValue;
+    map.set(key, fallback);
+    return fallback;
+}
+export function getOrThrow(map, key, error = 'Key not found in collection') {
+    const existingValue = map.get(key);
+    if (existingValue)
+        return existingValue;
+    throw new Error(error);
+}

package/dist/helpers/noop.d.ts

@@ -0,0 +1,9 @@
+import { BotResponse } from '../types/response';
+export declare class Noop {
+    static readonly NoResponse: BotResponse[];
+    static true(arg1: unknown): boolean;
+    static false(arg1: unknown): boolean;
+    static emptyString(): string;
+    static call(arg1: unknown): Promise<void>;
+}
+//# sourceMappingURL=noop.d.ts.map

package/dist/helpers/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../helpers/noop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,qBAAa,IAAI;IACb,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,CAAM;IAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO;IAGzB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO;IAG1B,MAAM,CAAC,WAAW;WAGL,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAIlD"}

package/dist/helpers/noop.js

@@ -0,0 +1,17 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+export class Noop {
+    static NoResponse = [];
+    static true(arg1) {
+        return true;
+    }
+    static false(arg1) {
+        return false;
+    }
+    static emptyString() {
+        return '';
+    }
+    static async call(arg1, arg2) {
+        return Promise.resolve();
+    }
+}

package/dist/helpers/objectFromEntries.d.ts

@@ -0,0 +1,2 @@
+export declare const typeSafeObjectFromEntries: <const T extends ReadonlyArray<readonly [PropertyKey, unknown]>>(entries: T) => { [K in T[number] as K[0]]: K[1]; };
+//# sourceMappingURL=objectFromEntries.d.ts.map

package/dist/helpers/objectFromEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectFromEntries.d.ts","sourceRoot":"","sources":["../../helpers/objectFromEntries.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,GAClC,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,EAE9D,SAAS,CAAC,KACX,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAElC,CAAC"}

package/dist/helpers/objectFromEntries.js

@@ -0,0 +1,3 @@
+export const typeSafeObjectFromEntries = (entries) => {
+    return Object.fromEntries(entries);
+};

package/dist/helpers/timeConvertions.d.ts

@@ -0,0 +1,5 @@
+import { Hours, Milliseconds, Seconds } from '../types/timeValues';
+export declare function secondsToMilliseconds(value: Seconds): Milliseconds;
+export declare function hoursToMilliseconds(value: Hours): Milliseconds;
+export declare function hoursToSeconds(value: Hours): Seconds;
+//# sourceMappingURL=timeConvertions.d.ts.map

package/dist/helpers/timeConvertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeConvertions.d.ts","sourceRoot":"","sources":["../../helpers/timeConvertions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAElE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAE9D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEpD"}

package/dist/helpers/timeConvertions.js

@@ -0,0 +1,9 @@
+export function secondsToMilliseconds(value) {
+    return (value * 1000);
+}
+export function hoursToMilliseconds(value) {
+    return (value * 60 * 60 * 1000);
+}
+export function hoursToSeconds(value) {
+    return (value * 60 * 60);
+}

package/dist/helpers/toArray.d.ts

@@ -0,0 +1,2 @@
+export declare function toArray<TType>(value: TType | TType[]): TType[];
+//# sourceMappingURL=toArray.d.ts.map

package/dist/helpers/toArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toArray.d.ts","sourceRoot":"","sources":["../../helpers/toArray.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,WAEpD"}

package/dist/helpers/toArray.js

@@ -0,0 +1,3 @@
+export function toArray(value) {
+    return Array.isArray(value) ? value : [value];
+}

package/dist/helpers/traceFactory.d.ts

@@ -0,0 +1,3 @@
+import { TraceId } from '../types/trace';
+export declare function createTrace(traceOwner: object | string, botName: string, traceName: string): TraceId;
+//# sourceMappingURL=traceFactory.d.ts.map

package/dist/helpers/traceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceFactory.d.ts","sourceRoot":"","sources":["../../helpers/traceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,wBAAgB,WAAW,CACvB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAIa,OAAO,CACxC"}

package/dist/helpers/traceFactory.js

@@ -0,0 +1,3 @@
+export function createTrace(traceOwner, botName, traceName) {
+    return `${typeof traceOwner == 'string' ? traceOwner : traceOwner.constructor.name}:${botName}-${traceName}`;
+}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export * from './main';
+export * from './helpers/builders/inlineQueryActionBuilder';
+export * from './helpers/builders/commandActionBuilder';
+export * from './helpers/builders/scheduledActionBuilder';
+export * from './types/actionState';
+export * from './entities/states/actionStateBase';
+export * from './types/messageTypes';
+export * from './helpers/timeConvertions';
+export * from './types/action';
+export * from './types/externalAliases';
+export * from './types/storage';
+export * from './types/scheduler';
+export { CommandAction } from './entities/actions/commandAction';
+export { InlineQueryAction } from './entities/actions/inlineQueryAction';
+export { ReplyCaptureAction } from './entities/actions/replyCaptureAction';
+export { ScheduledAction } from './entities/actions/scheduledAction';
+export { Hours, Milliseconds, Seconds } from './types/timeValues';
+export { ChatContext } from './entities/context/chatContext';
+export { InlineQueryContext } from './entities/context/inlineQueryContext';
+export { MessageContext } from './entities/context/messageContext';
+export { ReplyContext } from './entities/context/replyContext';
+export { ICaptureController } from './types/capture';
+export { ChatInfo } from './dtos/chatInfo';
+export { MessageInfo } from './dtos/messageInfo';
+export { UserInfo } from './dtos/userInfo';
+export { BotEventType } from './types/events';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qBAAqB,CAAC;AACpC,cAAc,mCAAmC,CAAC;AAClD,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+export * from './main';
+export * from './helpers/builders/inlineQueryActionBuilder';
+export * from './helpers/builders/commandActionBuilder';
+export * from './helpers/builders/scheduledActionBuilder';
+export * from './types/actionState';
+export * from './entities/states/actionStateBase';
+export * from './types/messageTypes';
+export * from './helpers/timeConvertions';
+export * from './types/action';
+export * from './types/externalAliases';
+export * from './types/storage';
+export * from './types/scheduler';
+export { CommandAction } from './entities/actions/commandAction';
+export { InlineQueryAction } from './entities/actions/inlineQueryAction';
+export { ReplyCaptureAction } from './entities/actions/replyCaptureAction';
+export { ScheduledAction } from './entities/actions/scheduledAction';
+export { ChatInfo } from './dtos/chatInfo';
+export { MessageInfo } from './dtos/messageInfo';
+export { UserInfo } from './dtos/userInfo';
+export { BotEventType } from './types/events';

package/dist/main.d.ts

@@ -0,0 +1,49 @@
+import { IStorageClient } from './types/storage';
+import { CommandAction } from './entities/actions/commandAction';
+import { ScheduledAction } from './entities/actions/scheduledAction';
+import { BotInstance } from './entities/botInstance';
+import { Seconds } from './types/timeValues';
+import { IScheduler } from './types/scheduler';
+import { InlineQueryAction } from './entities/actions/inlineQueryAction';
+import { IActionState } from './types/actionState';
+declare class BotOrchestrator {
+    bots: BotInstance[];
+    /**
+     * Starts bot
+     */
+    startBot(options: {
+        /** Bot name, used in logging */
+        name: string;
+        /** Path to file containing Telegram Bot token. */
+        tokenFilePath: string;
+        actions: {
+            /** Collection of actions that will be executed as a response to message from used. Created using `CommandActionBuilder`.*/
+            commands: CommandAction<IActionState>[];
+            /** Collection of actions that will be executed on timer. Created using `ScheduledActionBuilder`.*/
+            scheduled: ScheduledAction<IActionState>[];
+            /** Collection of actions that will handle inline queries */
+            inlineQueries: InlineQueryAction[];
+        };
+        /** Object containing chat name and chat id pairs. Used for logging and execution of scheduled action. */
+        chats: Record<string, number>;
+        /** Storage path for default `JsonFileStorage` client. Will be used only if `storageClient` is not provided. If not provided, default value of `./storage/` will be used.*/
+        storagePath?: string;
+        /** Period of time between execution of scheduled actions. */
+        scheduledPeriod?: Seconds;
+        /** If true, telegram API objects will be logged instead of message content. */
+        verboseLoggingForIncomingMessage?: boolean;
+        services?: {
+            /** Storage client for bot state storage. If not provided, default `JsonFileStorage` will be used. */
+            storageClient?: IStorageClient;
+            /** Scheduler client for bot scheduling. If not provided, default `NodeTimeoutScheduler` will be used. */
+            scheduler?: IScheduler;
+        };
+    }): Promise<BotInstance>;
+    /**
+     * Terminates all scheduled tasks, closes storage connections and stops all bots.
+     */
+    stopBots(): Promise<void>;
+}
+export declare const botOrchestrator: BotOrchestrator;
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,cAAM,eAAe;IACjB,IAAI,EAAE,WAAW,EAAE,CAAM;IAEzB;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE;QACpB,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,kDAAkD;QAClD,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE;YACL,2HAA2H;YAC3H,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,mGAAmG;YACnG,SAAS,EAAE,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3C,4DAA4D;YAC5D,aAAa,EAAE,iBAAiB,EAAE,CAAC;SACtC,CAAC;QACF,yGAAyG;QACzG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,2KAA2K;QAC3K,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,6DAA6D;QAC7D,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,+EAA+E;QAC/E,gCAAgC,CAAC,EAAE,OAAO,CAAC;QAC3C,QAAQ,CAAC,EAAE;YACP,qGAAqG;YACrG,aAAa,CAAC,EAAE,cAAc,CAAC;YAC/B,yGAAyG;YACzG,SAAS,CAAC,EAAE,UAAU,CAAC;SAC1B,CAAC;KACL;IAoBD;;OAEG;IACG,QAAQ;CAKjB;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}