@dementevdev/maxbot-ts 1.0.0

package/dist/cjs/core/rate-limiter/RateLimiter.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+/**
+ * Rate Limiter на основе алгоритма Token Bucket.
+ *
+ * Token Bucket позволяет накапливать "запас" запросов при простое,
+ * что даёт возможность burst-запросов без превышения среднего лимита.
+ */
+class RateLimiter {
+    maxTokens;
+    refillRate;
+    tokens;
+    lastRefill;
+    queue = [];
+    processing = false;
+    /**
+     * @param maxTokens - Максимальное количество токенов (по умолчанию 30)
+     * @param refillRate - Скорость восполнения токенов в секунду (по умолчанию 30)
+     */
+    constructor(maxTokens = 30, refillRate = 30) {
+        if (!Number.isFinite(maxTokens) || maxTokens <= 0) {
+            throw new Error("Параметр maxTokens должен быть положительным числом");
+        }
+        if (!Number.isFinite(refillRate) || refillRate <= 0) {
+            throw new Error("Параметр refillRate должен быть положительным числом");
+        }
+        this.maxTokens = maxTokens;
+        this.refillRate = refillRate;
+        this.tokens = maxTokens;
+        this.lastRefill = Date.now();
+    }
+    async acquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return;
+        }
+        // Запрос ждёт в очереди — не отбрасываем, а откладываем.
+        // Это избавляет разработчика от необходимости реализовывать retry-логику самостоятельно.
+        return new Promise((resolve) => {
+            // Вычисляем точное время готовности: позиция в очереди × интервал между токенами.
+            // Это позволяет scheduleQueue() поставить ровно один setTimeout на каждый элемент
+            // вместо общего слип-цикла, который вызывал задержку даже когда токен уже готов.
+            const msPerToken = 1000 / this.refillRate;
+            const position = this.queue.length; // 0-based: текущий элемент — первый ожидающий
+            const readyAt = Date.now() +
+                Math.ceil((1 - this.tokens) * msPerToken) +
+                position * msPerToken;
+            this.queue.push({ resolve, readyAt });
+            this.scheduleNext();
+        });
+    }
+    /**
+     * Восполняет токены пропорционально прошедшему времени
+     */
+    refill() {
+        const now = Date.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        // Добавляем токены пропорционально времени, но не больше максимума
+        this.tokens = Math.min(this.maxTokens, this.tokens + elapsed * this.refillRate);
+        this.lastRefill = now;
+    }
+    /**
+     * Планирует ровно один setTimeout для первого элемента очереди.
+     *
+     * Вместо слип-цикла (sleep → refill → check → sleep …) каждый элемент
+     * получает свой точный таймер: setTimeout срабатывает ровно в момент
+     * когда токен готов, без дополнительного ожидания.
+     *
+     * processing-флаг гарантирует единственный активный таймер на очередь —
+     * новые вызовы scheduleNext() от acquire() не создают лишних таймеров.
+     */
+    scheduleNext() {
+        if (this.processing || this.queue.length === 0) {
+            return;
+        }
+        this.processing = true;
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- queue.length > 0 проверен выше
+        const item = this.queue[0];
+        const delay = Math.max(0, item.readyAt - Date.now());
+        setTimeout(() => {
+            this.processing = false;
+            // Обновляем токены на момент срабатывания таймера
+            this.refill();
+            if (this.tokens >= 1) {
+                this.tokens -= 1;
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- queue непустая: item гарантированно существует
+                this.queue.shift().resolve();
+            }
+            else {
+                // Edge case: таймер мог сработать чуть раньше фактической готовности токена
+                // (погрешность clock/timer). Пересчитываем readyAt для головы очереди,
+                // чтобы следующий таймер был точным и не создавал цепочку setTimeout(0).
+                const head = this.queue[0];
+                if (head) {
+                    const msPerToken = 1000 / this.refillRate;
+                    head.readyAt = Date.now() + Math.ceil((1 - this.tokens) * msPerToken);
+                }
+            }
+            // Если токен всё ещё не готов (unlikely — системный таймер мог сработать
+            // чуть раньше), элемент остаётся в очереди и scheduleNext() поставит
+            // новый точный таймер.
+            // Запускаем следующий элемент, если очередь не пуста
+            this.scheduleNext();
+        }, delay);
+    }
+}
+exports.RateLimiter = RateLimiter;
+//# sourceMappingURL=RateLimiter.js.map

package/dist/cjs/core/rate-limiter/index.d.ts

@@ -0,0 +1,3 @@
+export { RateLimiter } from "./RateLimiter.js";
+export type { IRateLimiter } from "./RateLimiter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/core/rate-limiter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/rate-limiter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cjs/core/rate-limiter/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+var RateLimiter_js_1 = require("./RateLimiter.js");
+Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return RateLimiter_js_1.RateLimiter; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/filters/index.d.ts

@@ -0,0 +1,2 @@
+export { hasText, isPrivateChat, commandIs, hasCallbackPayload, payloadIs, } from "./predicates.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/filters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/filters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,SAAS,GACV,MAAM,iBAAiB,CAAC"}

package/dist/cjs/filters/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.payloadIs = exports.hasCallbackPayload = exports.commandIs = exports.isPrivateChat = exports.hasText = void 0;
+var predicates_js_1 = require("./predicates.js");
+Object.defineProperty(exports, "hasText", { enumerable: true, get: function () { return predicates_js_1.hasText; } });
+Object.defineProperty(exports, "isPrivateChat", { enumerable: true, get: function () { return predicates_js_1.isPrivateChat; } });
+Object.defineProperty(exports, "commandIs", { enumerable: true, get: function () { return predicates_js_1.commandIs; } });
+Object.defineProperty(exports, "hasCallbackPayload", { enumerable: true, get: function () { return predicates_js_1.hasCallbackPayload; } });
+Object.defineProperty(exports, "payloadIs", { enumerable: true, get: function () { return predicates_js_1.payloadIs; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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/cjs/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/cjs/filters/predicates.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasText = hasText;
+exports.isPrivateChat = isPrivateChat;
+exports.commandIs = commandIs;
+exports.hasCallbackPayload = hasCallbackPayload;
+exports.payloadIs = payloadIs;
+const CallbackContext_js_1 = require("../bot/context/CallbackContext.js");
+const MessageContext_js_1 = require("../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();
+ * });
+ */
+function hasText(ctx) {
+    return (ctx instanceof MessageContext_js_1.MessageContext &&
+        typeof ctx.text === "string" &&
+        ctx.text.length > 0);
+}
+/**
+ * Проверяет, что сообщение пришло из приватного чата (диалога с ботом).
+ *
+ * @example
+ * bot.use(async (ctx, next) => {
+ *   if (isPrivateChat(ctx)) {
+ *     await ctx.reply("Это личный чат 👋");
+ *   }
+ *   await next();
+ * });
+ */
+function isPrivateChat(ctx) {
+    return (ctx instanceof MessageContext_js_1.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();
+ * });
+ */
+function commandIs(name) {
+    const normalized = name.startsWith("/") ? name : `/${name}`;
+    return (ctx) => {
+        if (!(ctx instanceof MessageContext_js_1.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();
+ * });
+ */
+function hasCallbackPayload(ctx) {
+    return ctx instanceof CallbackContext_js_1.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();
+ * });
+ */
+function payloadIs(pattern) {
+    return (ctx) => {
+        if (!(ctx instanceof CallbackContext_js_1.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/cjs/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/cjs/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/cjs/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./bot/index.js"), exports);
+__exportStar(require("./api/index.js"), exports);
+__exportStar(require("./transport/index.js"), exports);
+__exportStar(require("./core/http/index.js"), exports);
+__exportStar(require("./core/errors/index.js"), exports);
+__exportStar(require("./core/rate-limiter/RateLimiter.js"), exports);
+__exportStar(require("./types/index.js"), exports);
+__exportStar(require("./utils/index.js"), exports);
+__exportStar(require("./middleware/index.js"), exports);
+__exportStar(require("./filters/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/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/cjs/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/cjs/middleware/compose.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compose = compose;
+exports.composeWithTiming = composeWithTiming;
+/**
+ * Собирает массив middleware в единую async-функцию.
+ *
+ * Инварианты:
+ * - next() нельзя вызвать дважды в одном middleware — выброс Error.
+ * - Если middlewares пустой — вызывается `finalHandler` напрямую.
+ * - Ошибка в любом звене пробрасывается вверх по стеку (без перехвата).
+ *
+ * @param middlewares - Упорядоченный список middleware
+ * @param finalHandler - Вызывается после последнего middleware (например, диспетчер хендлеров)
+ * @returns Функция `(ctx) => Promise<void>`, которую можно awaited
+ */
+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
+ */
+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/cjs/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/cjs/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/cjs/middleware/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeWithTiming = exports.compose = void 0;
+var compose_js_1 = require("./compose.js");
+Object.defineProperty(exports, "compose", { enumerable: true, get: function () { return compose_js_1.compose; } });
+Object.defineProperty(exports, "composeWithTiming", { enumerable: true, get: function () { return compose_js_1.composeWithTiming; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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/cjs/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/cjs/middleware/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/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/cjs/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"}