@dementevdev/maxbot-ts 1.0.0

package/dist/esm/bot/context/guards.d.ts

@@ -0,0 +1,69 @@
+import { BotStartedContext } from "./BotStartedContext.js";
+import { CallbackContext } from "./CallbackContext.js";
+import { ChatContext } from "./ChatContext.js";
+import { MessageContext } from "./MessageContext.js";
+import type { Context } from "../Bot.js";
+/**
+ * Type guard: проверяет, что контекст является `MessageContext`.
+ *
+ * Применяется в middleware для сужения типа:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isMessageContext(ctx)) {
+ *     console.log(ctx.text); // string | undefined — TS знает тип
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isMessageContext(ctx: Context): ctx is MessageContext;
+/**
+ * Type guard: проверяет, что контекст является `CallbackContext`.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isCallbackContext(ctx)) {
+ *     console.log(ctx.data); // payload кнопки
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isCallbackContext(ctx: Context): ctx is CallbackContext;
+/**
+ * Type guard: проверяет, что контекст является `ChatContext`.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isChatContext(ctx)) {
+ *     console.log(ctx.chatId); // number — всегда есть в ChatContext
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isChatContext(ctx: Context): ctx is ChatContext;
+/**
+ * Type guard: проверяет, что контекст является `BotStartedContext`.
+ *
+ * Используй для обработки нажатия Start или перехода по deep link:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isBotStartedContext(ctx)) {
+ *     console.log(ctx.startPayload); // payload из deep link или null
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isBotStartedContext(ctx: Context): ctx is BotStartedContext;
+/**
+ * Type guard: проверяет конкретный `update_type`.
+ *
+ * Используй когда нужно сузить тип внутри MessageContext или ChatContext:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isUpdateType(ctx, 'message_created')) {
+ *     // ctx — MessageContext с update_type === 'message_created'
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isUpdateType<T extends Context>(ctx: Context, updateType: T["raw"]["update_type"]): ctx is T;
+//# sourceMappingURL=guards.d.ts.map

package/dist/esm/bot/context/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../src/bot/context/guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAE9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,EAC5C,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,GAClC,GAAG,IAAI,CAAC,CAEV"}

package/dist/esm/bot/context/guards.js

@@ -0,0 +1,78 @@
+import { BotStartedContext } from "./BotStartedContext.js";
+import { CallbackContext } from "./CallbackContext.js";
+import { ChatContext } from "./ChatContext.js";
+import { MessageContext } from "./MessageContext.js";
+/**
+ * Type guard: проверяет, что контекст является `MessageContext`.
+ *
+ * Применяется в middleware для сужения типа:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isMessageContext(ctx)) {
+ *     console.log(ctx.text); // string | undefined — TS знает тип
+ *   }
+ *   await next();
+ * });
+ */
+export function isMessageContext(ctx) {
+    return ctx instanceof MessageContext;
+}
+/**
+ * Type guard: проверяет, что контекст является `CallbackContext`.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isCallbackContext(ctx)) {
+ *     console.log(ctx.data); // payload кнопки
+ *   }
+ *   await next();
+ * });
+ */
+export function isCallbackContext(ctx) {
+    return ctx instanceof CallbackContext;
+}
+/**
+ * Type guard: проверяет, что контекст является `ChatContext`.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isChatContext(ctx)) {
+ *     console.log(ctx.chatId); // number — всегда есть в ChatContext
+ *   }
+ *   await next();
+ * });
+ */
+export function isChatContext(ctx) {
+    return ctx instanceof ChatContext;
+}
+/**
+ * Type guard: проверяет, что контекст является `BotStartedContext`.
+ *
+ * Используй для обработки нажатия Start или перехода по deep link:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isBotStartedContext(ctx)) {
+ *     console.log(ctx.startPayload); // payload из deep link или null
+ *   }
+ *   await next();
+ * });
+ */
+export function isBotStartedContext(ctx) {
+    return ctx instanceof BotStartedContext;
+}
+/**
+ * Type guard: проверяет конкретный `update_type`.
+ *
+ * Используй когда нужно сузить тип внутри MessageContext или ChatContext:
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isUpdateType(ctx, 'message_created')) {
+ *     // ctx — MessageContext с update_type === 'message_created'
+ *   }
+ *   await next();
+ * });
+ */
+export function isUpdateType(ctx, updateType) {
+    return ctx.raw.update_type === updateType;
+}
+//# sourceMappingURL=guards.js.map

package/dist/esm/bot/context/index.d.ts

@@ -0,0 +1,6 @@
+export { MessageContext, type SendOptions, type ContextApi, } from "./MessageContext.js";
+export { CallbackContext, type AnswerOptions } from "./CallbackContext.js";
+export { ChatContext } from "./ChatContext.js";
+export { BotStartedContext } from "./BotStartedContext.js";
+export { isMessageContext, isCallbackContext, isChatContext, isBotStartedContext, isUpdateType, } from "./guards.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/bot/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bot/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/esm/bot/context/index.js

@@ -0,0 +1,6 @@
+export { MessageContext, } from "./MessageContext.js";
+export { CallbackContext } from "./CallbackContext.js";
+export { ChatContext } from "./ChatContext.js";
+export { BotStartedContext } from "./BotStartedContext.js";
+export { isMessageContext, isCallbackContext, isChatContext, isBotStartedContext, isUpdateType, } from "./guards.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/bot/dispatch.d.ts

@@ -0,0 +1,51 @@
+import { type ContextApi } from "./context/MessageContext.js";
+import type { Middleware } from "../middleware/types.js";
+import type { Update } from "../types/update.js";
+import type { BotMetrics } from "./metrics.js";
+import type { Context, EventHandler } from "./Bot.js";
+/**
+ * Слой диспетчеризации и семафора.
+ *
+ * Отвечает за:
+ * - Создание контекста из сырого обновления (`createContext`)
+ * - Запуск пайплайна middleware + handlers (`handleUpdate`, `runHandlersWithSemaphore`)
+ * - Backpressure (семафор: `acquireSemaphore` / `releaseSemaphore`)
+ * - Маршрутизацию ошибок (`handleError`)
+ *
+ * Не содержит бизнес-логики маршрутизации — она вынесена в {@link BotRouting}.
+ */
+export declare abstract class BotDispatch<Ctx extends Context> {
+    protected readonly handlers: Map<string, EventHandler<Ctx>[]>;
+    protected readonly middlewares: Middleware<Ctx>[];
+    protected contextApi: ContextApi;
+    protected _contextFactory: (base: Context) => Ctx;
+    protected concurrency: number;
+    protected errorHandler: ((error: Error) => void) | null;
+    protected slowHandler: ((ms: number, updateType: string) => void) | null;
+    protected slowThresholdMs: number;
+    protected unknownUpdateHandler: ((raw: Record<string, unknown>) => void) | null;
+    protected metricsHandler: ((metrics: BotMetrics) => void) | null;
+    private activeCount;
+    private readonly waitQueue;
+    protected handleUpdate(update: Update): void;
+    private runHandlersWithSemaphore;
+    /**
+     * Захватить слот семафора.
+     * Если свободных слотов нет — ждём в очереди.
+     */
+    private acquireSemaphore;
+    /**
+     * Освободить слот семафора и разбудить следующего в очереди.
+     */
+    private releaseSemaphore;
+    protected handleError(error: Error): void;
+    /**
+     * Создаёт типизированный контекст из сырого обновления.
+     *
+     * Возвращает `null` если `update_type` неизвестен SDK **и** задан хук
+     * `onUnknownUpdate` — хук уже вызван, update нужно пропустить.
+     * Если хук не задан — бросает ошибку через `assertNever` → `errorHandler`.
+     */
+    private createContext;
+}
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/esm/bot/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/bot/dispatch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,8BAAsB,WAAW,CAAC,GAAG,SAAS,OAAO;IAEnD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAa;IAC1E,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAM;IAKvD,SAAS,CAAC,UAAU,EAAG,UAAU,CAAC;IAClC,SAAS,CAAC,eAAe,EAAG,CAAC,IAAI,EAAE,OAAO,KAAK,GAAG,CAAC;IACnD,SAAS,CAAC,WAAW,EAAG,MAAM,CAAC;IAG/B,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC/D,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CACjE;IACP,SAAS,CAAC,eAAe,SAAK;IAC9B,SAAS,CAAC,oBAAoB,EAC1B,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GACxC,IAAI,CAAQ;IAChB,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAGxE,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAInD,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;YA6B9B,wBAAwB;IAoEtC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAczC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAkCtB"}

package/dist/esm/bot/dispatch.js

@@ -0,0 +1,197 @@
+import { CallbackContext } from "./context/CallbackContext.js";
+import { ChatContext } from "./context/ChatContext.js";
+import { BotStartedContext } from "./context/BotStartedContext.js";
+import { MessageContext } from "./context/MessageContext.js";
+import { assertNever } from "../utils/assertNever.js";
+import { compose, composeWithTiming } from "../middleware/compose.js";
+/**
+ * Слой диспетчеризации и семафора.
+ *
+ * Отвечает за:
+ * - Создание контекста из сырого обновления (`createContext`)
+ * - Запуск пайплайна middleware + handlers (`handleUpdate`, `runHandlersWithSemaphore`)
+ * - Backpressure (семафор: `acquireSemaphore` / `releaseSemaphore`)
+ * - Маршрутизацию ошибок (`handleError`)
+ *
+ * Не содержит бизнес-логики маршрутизации — она вынесена в {@link BotRouting}.
+ */
+export class BotDispatch {
+    // ── Хранилища маршрутов и middleware ──────────────────────────────────────
+    handlers = new Map();
+    middlewares = [];
+    // ── Поля, инициализируемые в конструкторе Bot ─────────────────────────────
+    // Используем ! (definite assignment assertion): TypeScript знает что поля
+    // будут присвоены до первого use (в конструкторе Bot, который вызывает super()).
+    contextApi;
+    _contextFactory;
+    concurrency;
+    // ── Наблюдатели (configurable через lifecycle-методы или config) ───────────
+    errorHandler = null;
+    slowHandler = null;
+    slowThresholdMs = 0;
+    unknownUpdateHandler = null;
+    metricsHandler = null;
+    // ── Семафор ───────────────────────────────────────────────────────────────
+    activeCount = 0;
+    waitQueue = [];
+    // ── Точка входа для транспорта ────────────────────────────────────────────
+    handleUpdate(update) {
+        let ctx;
+        try {
+            const base = this.createContext(update);
+            // null — знак что update_type неизвестен и хук onUnknownUpdate уже вызван;
+            // пропускаем update без ошибки
+            if (base === null)
+                return;
+            ctx = this._contextFactory(base);
+        }
+        catch (error) {
+            this.handleError(error instanceof Error ? error : new Error(String(error)));
+            return;
+        }
+        const handlers = this.handlers.get(update.update_type) ?? [];
+        // Пропускаем только если нет ни middleware, ни handlers — тогда обрабатывать
+        // буквально нечего и мы не занимаем слот семафора впустую.
+        // Если есть хотя бы middleware — запускаем пайплайн: глобальные middleware
+        // (логирование, трейсинг) должны видеть ВСЕ update типы.
+        if (this.middlewares.length === 0 && handlers.length === 0)
+            return;
+        // Запускаем обработку через семафор — гарантируем не более concurrency
+        // параллельных задач. Каждое обновление обрабатывается как единица:
+        // все его хендлеры выполняются параллельно внутри одного слота семафора.
+        void this.runHandlersWithSemaphore(ctx, handlers, update.update_type);
+    }
+    async runHandlersWithSemaphore(ctx, handlers, updateType) {
+        const needMetrics = this.metricsHandler !== null;
+        const needSlow = this.slowHandler !== null;
+        // Размер очереди ДО захвата слота — показывает реальное давление
+        const queueSizeAtStart = this.waitQueue.length;
+        await this.acquireSemaphore();
+        const start = needMetrics || needSlow ? Date.now() : 0;
+        let handlerErrors = 0;
+        const middlewareTimes = [];
+        try {
+            // Финальный обработчик — запускает все зарегистрированные handlers параллельно
+            const finalHandler = async (c) => {
+                await Promise.all(handlers.map(async (handler) => {
+                    try {
+                        await handler(c);
+                    }
+                    catch (error) {
+                        handlerErrors++;
+                        this.handleError(error instanceof Error ? error : new Error(String(error)));
+                    }
+                }));
+            };
+            // Весь пайплайн [middlewares... → handlers] выполняется внутри одного
+            // семафорного слота — backpressure применяется ко всему цепочке целиком.
+            const pipeline = needMetrics
+                ? composeWithTiming(this.middlewares, finalHandler, middlewareTimes)
+                : compose(this.middlewares, finalHandler);
+            await pipeline(ctx);
+        }
+        finally {
+            const elapsed = needMetrics || needSlow ? Date.now() - start : 0;
+            if (needSlow && elapsed >= this.slowThresholdMs) {
+                try {
+                    this.slowHandler?.(elapsed, updateType);
+                }
+                catch {
+                    // Ошибки наблюдателей не должны влиять на основной поток
+                }
+            }
+            if (needMetrics) {
+                try {
+                    this.metricsHandler?.({
+                        updateType,
+                        totalMs: elapsed,
+                        queueSizeAtStart,
+                        handlerErrors,
+                        middlewareTimes,
+                    });
+                }
+                catch {
+                    // Ошибки наблюдателей не должны влиять на основной поток
+                }
+            }
+            this.releaseSemaphore();
+        }
+    }
+    /**
+     * Захватить слот семафора.
+     * Если свободных слотов нет — ждём в очереди.
+     */
+    acquireSemaphore() {
+        if (this.activeCount < this.concurrency) {
+            this.activeCount++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.waitQueue.push(resolve);
+        });
+    }
+    /**
+     * Освободить слот семафора и разбудить следующего в очереди.
+     */
+    releaseSemaphore() {
+        const next = this.waitQueue.shift();
+        if (next) {
+            // Передаём слот напрямую — activeCount не меняется
+            next();
+        }
+        else {
+            this.activeCount--;
+        }
+    }
+    handleError(error) {
+        if (this.errorHandler) {
+            try {
+                this.errorHandler(error);
+            }
+            catch {
+                // Игнорируем ошибки в обработчике ошибок
+                console.error("Ошибка в обработчике ошибок:", error);
+            }
+        }
+        else {
+            // По умолчанию логируем в консоль
+            console.error("Ошибка бота:", error);
+        }
+    }
+    /**
+     * Создаёт типизированный контекст из сырого обновления.
+     *
+     * Возвращает `null` если `update_type` неизвестен SDK **и** задан хук
+     * `onUnknownUpdate` — хук уже вызван, update нужно пропустить.
+     * Если хук не задан — бросает ошибку через `assertNever` → `errorHandler`.
+     */
+    createContext(update) {
+        switch (update.update_type) {
+            case "message_callback":
+                return new CallbackContext(update, this.contextApi);
+            case "message_created":
+            case "message_edited":
+            case "message_removed":
+                return new MessageContext(update, this.contextApi);
+            case "bot_added":
+            case "bot_removed":
+            case "user_added":
+            case "user_removed":
+            case "chat_title_changed":
+                return new ChatContext(update);
+            case "bot_started":
+                return new BotStartedContext(update, this.contextApi);
+            default:
+                // TypeScript проверит здесь что все варианты UpdateType обработаны выше.
+                // Если появится новый update_type — будет ошибка компиляции, а не рантайм-краш.
+                if (this.unknownUpdateHandler) {
+                    // Хук вызван, возвращаем null — handleUpdate пропустит update без ошибки
+                    this.unknownUpdateHandler(update);
+                    return null;
+                }
+                // Хук не задан — бросаем ошибку, она уйдёт в errorHandler
+                return assertNever(update);
+        }
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/esm/bot/index.d.ts

@@ -0,0 +1,10 @@
+export { Bot, type BotConfig, type Context, type EventHandler } from "./Bot.js";
+export { Composer, type Filter } from "./Composer.js";
+export { type HearsTrigger, type CommandTrigger, matchCommand, } from "./triggers.js";
+export type { BotMetrics } from "./metrics.js";
+export { MessageContext, type ContextApi, type SendOptions, } from "./context/MessageContext.js";
+export { CallbackContext, type AnswerOptions, } from "./context/CallbackContext.js";
+export { ChatContext } from "./context/ChatContext.js";
+export { BotStartedContext } from "./context/BotStartedContext.js";
+export { isMessageContext, isCallbackContext, isChatContext, isBotStartedContext, isUpdateType, } from "./context/guards.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/bot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/dist/esm/bot/index.js

@@ -0,0 +1,9 @@
+export { Bot } from "./Bot.js";
+export { Composer } from "./Composer.js";
+export { matchCommand, } from "./triggers.js";
+export { MessageContext, } from "./context/MessageContext.js";
+export { CallbackContext, } from "./context/CallbackContext.js";
+export { ChatContext } from "./context/ChatContext.js";
+export { BotStartedContext } from "./context/BotStartedContext.js";
+export { isMessageContext, isCallbackContext, isChatContext, isBotStartedContext, isUpdateType, } from "./context/guards.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/bot/lifecycle.d.ts

@@ -0,0 +1,85 @@
+import type { IBotsApi, IChatsApi, IMessagesApi, ISubscriptionsApi, IUploadsApi } from "../api/interfaces.js";
+import type { IUpdateTransport } from "../transport/interfaces.js";
+import type { BotInfo } from "../types/bot.js";
+import type { Message } from "../types/message.js";
+import type { SubscriptionInfo } from "../types/subscription.js";
+import type { SendOptions } from "./context/MessageContext.js";
+import { BotRouting } from "./routing.js";
+import type { Context } from "./Bot.js";
+/**
+ * Слой жизненного цикла и удобных методов.
+ *
+ * Отвечает за:
+ * - Запуск / остановку бота (`start` / `stop`) с Promise-мьютексом
+ * - Управление webhook (`setWebhookUrl`, `deleteWebhook`, `getWebhookInfo`)
+ * - Высокоуровневые методы отправки (`sendMessage`, `sendPrivateMessage`, `getMe`)
+ * - Конфигурацию наблюдателей (`onError`, `onSlowHandler`)
+ *
+ * Расширяет {@link BotRouting} — использует маршруты и middleware из него.
+ *
+ * Поля `api` и `transport` объявлены как `abstract` — конкретные значения
+ * предоставляет конструктор `Bot`.
+ */
+export declare abstract class BotLifecycle<Ctx extends Context> extends BotRouting<Ctx> {
+    /** Доступ к низкоуровневым API для продвинутых сценариев */
+    abstract readonly api: {
+        readonly bots: IBotsApi;
+        readonly chats: IChatsApi;
+        readonly messages: IMessagesApi;
+        readonly subscriptions: ISubscriptionsApi;
+        readonly uploads: IUploadsApi;
+    };
+    /** Транспорт: LongPolling или Webhook */
+    protected abstract readonly transport: IUpdateTransport;
+    private startPromise;
+    /**
+     * Установить URL для webhook.
+     */
+    setWebhookUrl(url: string): Promise<void>;
+    /**
+     * Удалить webhook.
+     */
+    deleteWebhook(): Promise<void>;
+    /**
+     * Получить информацию о текущем webhook.
+     */
+    getWebhookInfo(): Promise<SubscriptionInfo>;
+    /**
+     * Зарегистрировать обработчик ошибок.
+     */
+    onError(handler: (error: Error) => void): this;
+    /**
+     * Назначить коллбэк для медленных обработчиков.
+     *
+     * Если обработка обновления заняла больше `thresholdMs` мс,
+     * вызывается `cb` с фактическим временем выполнения и типом обновления.
+     *
+     * @example
+     * bot.onSlowHandler(500, (ms, type) => {
+     *   log.warn({ ms, type }, 'slow handler detected');
+     * });
+     */
+    onSlowHandler(thresholdMs: number, cb: (ms: number, updateType: string) => void): this;
+    /**
+     * Получить информацию о боте.
+     */
+    getMe(): Promise<BotInfo>;
+    /**
+     * Отправить сообщение в чат.
+     */
+    sendMessage(chatId: number, text: string, options?: SendOptions): Promise<Message>;
+    /**
+     * Отправить личное сообщение пользователю.
+     */
+    sendPrivateMessage(userId: number, text: string, options?: SendOptions): Promise<Message>;
+    /**
+     * Запустить бота.
+     */
+    start(): Promise<void>;
+    /**
+     * Остановить бота.
+     */
+    stop(): Promise<void>;
+    private _doStart;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/esm/bot/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/bot/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,8BAAsB,YAAY,CAChC,GAAG,SAAS,OAAO,CACnB,SAAQ,UAAU,CAAC,GAAG,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;QAChC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;QAC1C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;KAC/B,CAAC;IAEF,yCAAyC;IACzC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAMxD,OAAO,CAAC,YAAY,CAA8B;IAIlD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAMjD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAK9C;;;;;;;;;;OAUG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAC3C,IAAI;IAQP;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC;IAgBnB;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC;IAkBnB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA8Bb,QAAQ;CAMvB"}