@dementevdev/maxbot-ts 1.0.0

package/dist/esm/filters/predicates.d.ts

@@ -0,0 +1,85 @@
+import { CallbackContext } from "../bot/context/CallbackContext.js";
+import { MessageContext } from "../bot/context/MessageContext.js";
+import type { Context } from "../bot/Bot.js";
+/**
+ * Проверяет, что контекст является MessageContext **и** содержит непустой текст.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (hasText(ctx)) {
+ *     // ctx: MessageContext, ctx.text: string (не undefined)
+ *     console.log(ctx.text.toUpperCase());
+ *   }
+ *   await next();
+ * });
+ */
+export declare function hasText(ctx: Context): ctx is MessageContext & {
+    text: string;
+};
+/**
+ * Проверяет, что сообщение пришло из приватного чата (диалога с ботом).
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isPrivateChat(ctx)) {
+ *     await ctx.reply("Это личный чат 👋");
+ *   }
+ *   await next();
+ * });
+ */
+export declare function isPrivateChat(ctx: Context): ctx is MessageContext;
+/**
+ * Фабрика предикатов: проверяет, что сообщение — конкретная команда.
+ *
+ * Совпадает с точным текстом (`/cmd`) или текстом + аргументами (`/cmd arg`).
+ * Слэш можно не указывать — он добавляется автоматически.
+ *
+ * @param name Имя команды, например `"start"` или `"/help"`
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (commandIs("start")(ctx)) {
+ *     await ctx.reply("Привет!");
+ *     return; // не вызываем next — команда обработана
+ *   }
+ *   await next();
+ * });
+ */
+export declare function commandIs(name: string): (ctx: Context) => ctx is MessageContext & {
+    text: string;
+};
+/**
+ * Проверяет, что контекст является CallbackContext (нажатие кнопки)
+ * **и** payload не пустой.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (hasCallbackPayload(ctx)) {
+ *     // ctx: CallbackContext, ctx.data: непустая строка
+ *     console.log("payload:", ctx.data);
+ *   }
+ *   await next();
+ * });
+ */
+export declare function hasCallbackPayload(ctx: Context): ctx is CallbackContext & {
+    data: string;
+};
+/**
+ * Фабрика предикатов: проверяет, что payload кнопки совпадает с шаблоном.
+ *
+ * @param pattern Строка (точное совпадение) или RegExp
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (payloadIs(/^action:/)(ctx)) {
+ *     const [, action] = ctx.data.split(":");
+ *     await ctx.answer({ notification: `Действие: ${action}` });
+ *     return;
+ *   }
+ *   await next();
+ * });
+ */
+export declare function payloadIs(pattern: string | RegExp): (ctx: Context) => ctx is CallbackContext & {
+    data: string;
+};
+//# sourceMappingURL=predicates.d.ts.map

package/dist/esm/filters/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../../src/filters/predicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAM1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAKjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAO5D;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAE3C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAO7D"}

package/dist/esm/filters/predicates.js

@@ -0,0 +1,104 @@
+import { CallbackContext } from "../bot/context/CallbackContext.js";
+import { MessageContext } from "../bot/context/MessageContext.js";
+// ─── MessageContext predicates ───────────────────────────────────────────────
+/**
+ * Проверяет, что контекст является MessageContext **и** содержит непустой текст.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (hasText(ctx)) {
+ *     // ctx: MessageContext, ctx.text: string (не undefined)
+ *     console.log(ctx.text.toUpperCase());
+ *   }
+ *   await next();
+ * });
+ */
+export function hasText(ctx) {
+    return (ctx instanceof MessageContext &&
+        typeof ctx.text === "string" &&
+        ctx.text.length > 0);
+}
+/**
+ * Проверяет, что сообщение пришло из приватного чата (диалога с ботом).
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isPrivateChat(ctx)) {
+ *     await ctx.reply("Это личный чат 👋");
+ *   }
+ *   await next();
+ * });
+ */
+export function isPrivateChat(ctx) {
+    return (ctx instanceof MessageContext &&
+        ctx.raw.message.recipient.chat_type === "dialog");
+}
+/**
+ * Фабрика предикатов: проверяет, что сообщение — конкретная команда.
+ *
+ * Совпадает с точным текстом (`/cmd`) или текстом + аргументами (`/cmd arg`).
+ * Слэш можно не указывать — он добавляется автоматически.
+ *
+ * @param name Имя команды, например `"start"` или `"/help"`
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (commandIs("start")(ctx)) {
+ *     await ctx.reply("Привет!");
+ *     return; // не вызываем next — команда обработана
+ *   }
+ *   await next();
+ * });
+ */
+export function commandIs(name) {
+    const normalized = name.startsWith("/") ? name : `/${name}`;
+    return (ctx) => {
+        if (!(ctx instanceof MessageContext))
+            return false;
+        const text = ctx.text ?? "";
+        return text === normalized || text.startsWith(`${normalized} `);
+    };
+}
+// ─── CallbackContext predicates ──────────────────────────────────────────────
+/**
+ * Проверяет, что контекст является CallbackContext (нажатие кнопки)
+ * **и** payload не пустой.
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (hasCallbackPayload(ctx)) {
+ *     // ctx: CallbackContext, ctx.data: непустая строка
+ *     console.log("payload:", ctx.data);
+ *   }
+ *   await next();
+ * });
+ */
+export function hasCallbackPayload(ctx) {
+    return ctx instanceof CallbackContext && ctx.data.length > 0;
+}
+/**
+ * Фабрика предикатов: проверяет, что payload кнопки совпадает с шаблоном.
+ *
+ * @param pattern Строка (точное совпадение) или RegExp
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (payloadIs(/^action:/)(ctx)) {
+ *     const [, action] = ctx.data.split(":");
+ *     await ctx.answer({ notification: `Действие: ${action}` });
+ *     return;
+ *   }
+ *   await next();
+ * });
+ */
+export function payloadIs(pattern) {
+    return (ctx) => {
+        if (!(ctx instanceof CallbackContext))
+            return false;
+        const data = ctx.data;
+        if (data.length === 0)
+            return false;
+        return typeof pattern === "string" ? data === pattern : pattern.test(data);
+    };
+}
+//# sourceMappingURL=predicates.js.map

package/dist/esm/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./bot/index.js";
+export * from "./api/index.js";
+export * from "./transport/index.js";
+export * from "./core/http/index.js";
+export * from "./core/errors/index.js";
+export * from "./core/rate-limiter/RateLimiter.js";
+export * from "./types/index.js";
+export * from "./utils/index.js";
+export * from "./middleware/index.js";
+export * from "./filters/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,11 @@
+export * from "./bot/index.js";
+export * from "./api/index.js";
+export * from "./transport/index.js";
+export * from "./core/http/index.js";
+export * from "./core/errors/index.js";
+export * from "./core/rate-limiter/RateLimiter.js";
+export * from "./types/index.js";
+export * from "./utils/index.js";
+export * from "./middleware/index.js";
+export * from "./filters/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/middleware/compose.d.ts

@@ -0,0 +1,28 @@
+import type { Middleware } from "./types.js";
+/**
+ * Собирает массив middleware в единую async-функцию.
+ *
+ * Инварианты:
+ * - next() нельзя вызвать дважды в одном middleware — выброс Error.
+ * - Если middlewares пустой — вызывается `finalHandler` напрямую.
+ * - Ошибка в любом звене пробрасывается вверх по стеку (без перехвата).
+ *
+ * @param middlewares - Упорядоченный список middleware
+ * @param finalHandler - Вызывается после последнего middleware (например, диспетчер хендлеров)
+ * @returns Функция `(ctx) => Promise<void>`, которую можно awaited
+ */
+export declare function compose<Ctx>(middlewares: ReadonlyArray<Middleware<Ctx>>, finalHandler: (ctx: Ctx) => Promise<void>): (ctx: Ctx) => Promise<void>;
+/**
+ * Вариант `compose` с замером времени каждого middleware.
+ *
+ * Записывает в массив `timings` (по индексу) фактическое время выполнения
+ * каждого middleware в миллисекундах (включая вызов вложенных next()).
+ *
+ * Используется внутри `Bot` когда задан `onMetrics` колбэк.
+ *
+ * @param middlewares - Упорядоченный список middleware
+ * @param finalHandler - Вызывается после последнего middleware
+ * @param timings - Выходной массив: `timings[i]` — ms для i-го middleware
+ */
+export declare function composeWithTiming<Ctx>(middlewares: ReadonlyArray<Middleware<Ctx>>, finalHandler: (ctx: Ctx) => Promise<void>, timings: number[]): (ctx: Ctx) => Promise<void>;
+//# sourceMappingURL=compose.d.ts.map

package/dist/esm/middleware/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/middleware/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAU,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,GAAG,EACzB,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAC3C,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GACxC,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAkC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EACnC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAC3C,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,EACzC,OAAO,EAAE,MAAM,EAAE,GAChB,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CA+C7B"}

package/dist/esm/middleware/compose.js

@@ -0,0 +1,85 @@
+/**
+ * Собирает массив middleware в единую async-функцию.
+ *
+ * Инварианты:
+ * - next() нельзя вызвать дважды в одном middleware — выброс Error.
+ * - Если middlewares пустой — вызывается `finalHandler` напрямую.
+ * - Ошибка в любом звене пробрасывается вверх по стеку (без перехвата).
+ *
+ * @param middlewares - Упорядоченный список middleware
+ * @param finalHandler - Вызывается после последнего middleware (например, диспетчер хендлеров)
+ * @returns Функция `(ctx) => Promise<void>`, которую можно awaited
+ */
+export function compose(middlewares, finalHandler) {
+    return function dispatch(ctx) {
+        let index = -1;
+        function step(i) {
+            // Защита от двойного next(): i должен быть строго больше index при каждом шаге
+            if (i <= index) {
+                return Promise.reject(new Error("next() вызван повторно в одном middleware"));
+            }
+            index = i;
+            const fn = i < middlewares.length ? middlewares[i] : undefined;
+            if (fn === undefined) {
+                // Все middleware прошли — запускаем финальный обработчик
+                return finalHandler(ctx);
+            }
+            try {
+                const result = fn(ctx, () => step(i + 1));
+                // Если middleware синхронный (возвращает void) — оборачиваем в resolved Promise
+                return result instanceof Promise ? result : Promise.resolve();
+            }
+            catch (err) {
+                return Promise.reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        return step(0);
+    };
+}
+/**
+ * Вариант `compose` с замером времени каждого middleware.
+ *
+ * Записывает в массив `timings` (по индексу) фактическое время выполнения
+ * каждого middleware в миллисекундах (включая вызов вложенных next()).
+ *
+ * Используется внутри `Bot` когда задан `onMetrics` колбэк.
+ *
+ * @param middlewares - Упорядоченный список middleware
+ * @param finalHandler - Вызывается после последнего middleware
+ * @param timings - Выходной массив: `timings[i]` — ms для i-го middleware
+ */
+export function composeWithTiming(middlewares, finalHandler, timings) {
+    return function dispatch(ctx) {
+        let index = -1;
+        function step(i) {
+            if (i <= index) {
+                return Promise.reject(new Error("next() вызван повторно в одном middleware"));
+            }
+            index = i;
+            const fn = i < middlewares.length ? middlewares[i] : undefined;
+            if (fn === undefined) {
+                return finalHandler(ctx);
+            }
+            const t0 = Date.now();
+            try {
+                const result = fn(ctx, () => step(i + 1));
+                if (result instanceof Promise) {
+                    return result.then(() => {
+                        timings[i] = Date.now() - t0;
+                    }, (err) => {
+                        timings[i] = Date.now() - t0;
+                        return Promise.reject(err instanceof Error ? err : new Error(String(err)));
+                    });
+                }
+                timings[i] = Date.now() - t0;
+                return Promise.resolve();
+            }
+            catch (err) {
+                timings[i] = Date.now() - t0;
+                return Promise.reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        return step(0);
+    };
+}
+//# sourceMappingURL=compose.js.map

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

@@ -0,0 +1,3 @@
+export type { Middleware, NextFn } from "./types.js";
+export { compose, composeWithTiming } from "./compose.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/middleware/index.js

@@ -0,0 +1,2 @@
+export { compose, composeWithTiming } from "./compose.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/middleware/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Функция-переход к следующему middleware.
+ * Вызов next() дважды в одном middleware — программная ошибка.
+ */
+export type NextFn = () => Promise<void>;
+/**
+ * Middleware — асинхронная функция, получающая контекст и переход to следующему звену.
+ *
+ * @example
+ * const logger: Middleware<Context> = async (ctx, next) => {
+ *   console.log('incoming update');
+ *   await next();
+ *   console.log('handlers done');
+ * };
+ */
+export type Middleware<Ctx> = (ctx: Ctx, next: NextFn) => Promise<void> | void;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/middleware/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/middleware/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC"}

package/dist/esm/middleware/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/transport/LongPollingTransport.d.ts

@@ -0,0 +1,33 @@
+import type { ISubscriptionsApi } from "../api/interfaces.js";
+import type { ErrorHandler, IUpdateTransport, LongPollingConfig, UpdateHandler } from "./interfaces.js";
+/**
+ * Транспорт на основе Long Polling.
+ *
+ * Long Polling проще в настройке — не нужен публичный IP и SSL.
+ * Подходит для разработки и небольших ботов.
+ */
+export declare class LongPollingTransport implements IUpdateTransport {
+    private readonly subscriptionsApi;
+    private readonly timeout;
+    private readonly limit;
+    private readonly retryDelay;
+    private readonly resetMarkerOnRestart;
+    private readonly allowedUpdates;
+    private isRunning;
+    private marker;
+    private updateHandler;
+    private errorHandler;
+    private abortController;
+    private pollPromise;
+    constructor(subscriptionsApi: ISubscriptionsApi, config?: LongPollingConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    onUpdate(handler: UpdateHandler): void;
+    onError(handler: ErrorHandler): void;
+    private poll;
+    private isAbortError;
+    private emitUpdate;
+    private emitError;
+    private delay;
+}
+//# sourceMappingURL=LongPollingTransport.d.ts.map

package/dist/esm/transport/LongPollingTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LongPollingTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/LongPollingTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAmBzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAlBnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAE1D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAA6B;IAIjD,OAAO,CAAC,eAAe,CAAgC;IAEvD,OAAO,CAAC,WAAW,CAA8B;gBAG9B,gBAAgB,EAAE,iBAAiB,EACpD,MAAM,CAAC,EAAE,iBAAiB;IAStB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAItC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;YAItB,IAAI;IAyDlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,KAAK;CAkBd"}

package/dist/esm/transport/LongPollingTransport.js

@@ -0,0 +1,149 @@
+import { ApiError } from "../core/errors/index.js";
+/**
+ * Транспорт на основе Long Polling.
+ *
+ * Long Polling проще в настройке — не нужен публичный IP и SSL.
+ * Подходит для разработки и небольших ботов.
+ */
+export class LongPollingTransport {
+    subscriptionsApi;
+    timeout;
+    limit;
+    retryDelay;
+    resetMarkerOnRestart;
+    allowedUpdates;
+    isRunning = false;
+    marker = null;
+    updateHandler = null;
+    errorHandler = null;
+    // AbortController живёт на протяжении одного сеанса polling —
+    // позволяет мгновенно прервать текущий fetch-запрос при вызове stop()
+    abortController = null;
+    // Храним Promise от poll() чтобы stop() мог дождаться чистого завершения цикла
+    pollPromise = null;
+    constructor(subscriptionsApi, config) {
+        this.subscriptionsApi = subscriptionsApi;
+        this.timeout = config?.timeout ?? 25;
+        this.limit = config?.limit ?? 100;
+        this.retryDelay = config?.retryDelay ?? 5000;
+        this.resetMarkerOnRestart = config?.resetMarkerOnRestart ?? false;
+        this.allowedUpdates = config?.allowedUpdates;
+    }
+    async start() {
+        // Отписка от webhook перед стартом polling —
+        // MAX API не позволяет использовать оба метода одновременно
+        try {
+            await this.subscriptionsApi.unsubscribe();
+        }
+        catch {
+            // Игнорируем ошибку — webhook мог быть не установлен
+        }
+        this.isRunning = true;
+        this.abortController = new AbortController();
+        // Запуск в отдельном "потоке" — не блокируем возврат из start()
+        this.pollPromise = this.poll();
+    }
+    async stop() {
+        this.isRunning = false;
+        // Прерываем текущий getUpdates или delay немедленно —
+        // без этого пришлось бы ждать до 25 секунд завершения long-poll запроса
+        this.abortController?.abort();
+        this.abortController = null;
+        // Дожидаемся завершения poll() — гарантируем чистую остановку
+        await this.pollPromise;
+        this.pollPromise = null;
+        // Сбрасываем маркер если настройка включена —
+        // следующий start() стартует с самых свежих обновлений
+        if (this.resetMarkerOnRestart) {
+            this.marker = null;
+        }
+    }
+    onUpdate(handler) {
+        this.updateHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+    async poll() {
+        while (this.isRunning) {
+            try {
+                const response = await this.subscriptionsApi.getUpdates({
+                    timeout: this.timeout,
+                    limit: this.limit,
+                    marker: this.marker ?? undefined,
+                    update_types: this.allowedUpdates,
+                }, this.abortController?.signal);
+                // Marker сохраняется между запросами —
+                // без него API вернёт те же обновления повторно
+                if (response.marker !== null) {
+                    this.marker = response.marker;
+                }
+                for (const update of response.updates) {
+                    // Fire-and-forget: один зависший обработчик не блокирует остальные.
+                    // Ошибки в обработчике логируются, но не останавливают polling.
+                    this.emitUpdate(update);
+                }
+            }
+            catch (error) {
+                // AbortError означает намеренную остановку через stop() — не ошибка
+                if (this.isAbortError(error)) {
+                    break;
+                }
+                // API вернул 400/404 — маркер устарел или невалиден.
+                // Сбрасываем маркер и сразу повторяем запрос без паузы —
+                // бот продолжит работу автономно даже после долгой остановки.
+                if (error instanceof ApiError &&
+                    (error.statusCode === 400 || error.statusCode === 404)) {
+                    this.marker = null;
+                    this.emitError(new Error(`Маркер устарел или невалиден (HTTP ${error.statusCode}), сброс позиции`));
+                    continue;
+                }
+                this.emitError(error instanceof Error ? error : new Error(String(error)));
+                // Пауза перед retry — защита от спама сервера при ошибках сети.
+                // delay тоже прерывается по сигналу, чтобы stop() не ждал retryDelay.
+                await this.delay(this.retryDelay, this.abortController?.signal);
+            }
+        }
+    }
+    isAbortError(error) {
+        return (error instanceof Error &&
+            (error.name === "AbortError" || error.name === "TimeoutError"));
+    }
+    emitUpdate(update) {
+        if (this.updateHandler) {
+            try {
+                this.updateHandler(update);
+            }
+            catch (error) {
+                // Ошибки в обработчике не должны ломать polling
+                this.emitError(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    }
+    emitError(error) {
+        if (this.errorHandler) {
+            try {
+                this.errorHandler(error);
+            }
+            catch {
+                // Игнорируем ошибки в обработчике ошибок
+            }
+        }
+    }
+    // delay с поддержкой AbortSignal — stop() прерывает ожидание мгновенно,
+    // а не ждёт истечения retryDelay (до 5 секунд)
+    delay(ms, signal) {
+        return new Promise((resolve) => {
+            if (signal?.aborted) {
+                resolve();
+                return;
+            }
+            const tid = setTimeout(resolve, ms);
+            signal?.addEventListener("abort", () => {
+                clearTimeout(tid);
+                resolve();
+            }, { once: true });
+        });
+    }
+}
+//# sourceMappingURL=LongPollingTransport.js.map

package/dist/esm/transport/WebhookTransport.d.ts

@@ -0,0 +1,40 @@
+import { type IncomingMessage, type ServerResponse } from "node:http";
+import type { ISubscriptionsApi } from "../api/interfaces.js";
+import type { ErrorHandler, IUpdateTransport, UpdateHandler, WebhookConfig } from "./interfaces.js";
+/**
+ * Транспорт на основе Webhook.
+ *
+ * Webhook эффективнее для production — MAX сам присылает обновления.
+ * Требует публичный HTTPS endpoint.
+ */
+export declare class WebhookTransport implements IUpdateTransport {
+    private readonly subscriptionsApi;
+    private readonly path;
+    private readonly port;
+    private readonly host;
+    private readonly secretToken;
+    private readonly webhookUrl;
+    private readonly autoRegister;
+    private server;
+    private startPromise;
+    private updateHandler;
+    private errorHandler;
+    constructor(subscriptionsApi: ISubscriptionsApi, config?: WebhookConfig);
+    start(): Promise<void>;
+    private _doStart;
+    stop(): Promise<void>;
+    onUpdate(handler: UpdateHandler): void;
+    onError(handler: ErrorHandler): void;
+    /**
+     * Получить middleware для интеграции с Express/Fastify/Koa.
+     *
+     * Позволяет встроить webhook в существующий сервер разработчика.
+     */
+    getMiddleware(): (req: IncomingMessage, res: ServerResponse, next?: () => void) => void;
+    private handleRequest;
+    private verifyToken;
+    private parseBody;
+    private emitUpdate;
+    private emitError;
+}
+//# sourceMappingURL=WebhookTransport.d.ts.map

package/dist/esm/transport/WebhookTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/WebhookTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,iBAAiB,CAAC;AAKzB;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IAgBrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAfnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IAEvC,OAAO,CAAC,MAAM,CAAuB;IAGrC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAA6B;gBAG9B,gBAAgB,EAAE,iBAAiB,EACpD,MAAM,CAAC,EAAE,aAAa;IAUlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAWd,QAAQ;IAmBhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD3B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAItC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIpC;;;;OAIG;IACH,aAAa,IAAI,CACf,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,CAAC,EAAE,MAAM,IAAI,KACd,IAAI;IAeT,OAAO,CAAC,aAAa;IAiDrB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,SAAS;IAgCjB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,SAAS;CASlB"}