@dementevdev/maxbot-ts 1.0.0

package/dist/types/bot/routing.d.ts

@@ -0,0 +1,131 @@
+import type { Middleware } from "../middleware/types.js";
+import type { UpdateType } from "../types/update.js";
+import { BotDispatch } from "./dispatch.js";
+import type { Context } from "./Bot.js";
+import { type HearsTrigger, type CommandTrigger } from "./triggers.js";
+/**
+ * Слой маршрутизации.
+ *
+ * Отвечает за регистрацию обработчиков событий:
+ * - `on` / `onMessage` / `onCallback` / `onStart` — подписка на типы обновлений
+ * - `command` / `hears` / `action` — шорткаты с pattern matching
+ * - `use` / `filter` — middleware-цепочки и предикаты
+ *
+ * Расширяет {@link BotDispatch} — использует `handlers` и `middlewares` из него.
+ */
+export declare abstract class BotRouting<Ctx extends Context> extends BotDispatch<Ctx> {
+    /**
+     * Зарегистрировать один или несколько обработчиков для события message_created.
+     *
+     * При нескольких аргументах промежуточные middleware должны вызывать `next()`;
+     * последний аргумент — финальный обработчик (next не нужен).
+     *
+     * @example С промежуточным middleware
+     * bot.onMessage(authMw, async (ctx) => { await ctx.reply('OK'); });
+     */
+    onMessage(...fns: Middleware<Ctx>[]): this;
+    /**
+     * Зарегистрировать один или несколько обработчиков для callback-запросов.
+     *
+     * @example
+     * bot.onCallback(logMw, async (ctx) => { ... });
+     */
+    onCallback(...fns: Middleware<Ctx>[]): this;
+    /**
+     * Зарегистрировать обработчик для события `bot_started`.
+     *
+     * Срабатывает когда пользователь нажимает Start в диалоге или переходит по deep link.
+     *
+     * @example Onboarding с deep link
+     * bot.onStart(async (ctx) => {
+     *   if (isBotStartedContext(ctx) && ctx.startPayload) {
+     *     await ctx.reply(`Реферал: ${ctx.startPayload}`);
+     *   } else {
+     *     await ctx.reply('Добро пожаловать!');
+     *   }
+     * });
+     */
+    onStart(...fns: Middleware<Ctx>[]): this;
+    /**
+     * Зарегистрировать один или несколько обработчиков для любого типа обновления.
+     *
+     * @example Один обработчик
+     * bot.on('message_created', async (ctx) => { ... });
+     *
+     * @example Несколько middleware + обработчик
+     * bot.on('message_created', authMw, rateLimitMw, async (ctx) => { ... });
+     */
+    on(event: UpdateType, ...fns: Middleware<Ctx>[]): this;
+    /**
+     * Зарегистрировать обработчик команды.
+     *
+     * Срабатывает на `message_created`, если текст сообщения начинается с `/<name>`.
+     *
+     * @example Один обработчик
+     * bot.command('start', async (ctx) => { ... });
+     *
+     * @example Массив команд
+     * bot.command(['start', 'begin'], async (ctx) => { ... });
+     *
+     * @example С промежуточными middleware
+     * bot.command('pay', authMw, checkBalanceMw, async (ctx) => { ... });
+     */
+    command(name: CommandTrigger, ...fns: Middleware<Ctx>[]): this;
+    /**
+     * Зарегистрировать обработчик по regexp- или строковому фильтру текста сообщения.
+     *
+     * При совпадении RegExp устанавливает `ctx.match` с capture-группами.
+     *
+     * @example
+     * bot.hears(/(\d+)/, async (ctx) => { ... });
+     * bot.hears('привет', async (ctx) => { ... });
+     * bot.hears(['привет', /^hi/i], async (ctx) => { ... });
+     */
+    hears(pattern: HearsTrigger, ...fns: Middleware<Ctx>[]): this;
+    /**
+     * Зарегистрировать обработчик по `callback.payload`.
+     *
+     * `pattern` может быть строкой, RegExp или массивом — срабатывает на первое
+     * совпадение. При совпадении RegExp устанавливает `ctx.match` с capture-группами.
+     *
+     * @example
+     * bot.action('buy',                   handler);
+     * bot.action(/^buy:(\d+)$/,           handler);
+     * bot.action(['confirm', 'ok'],        handler); // оба payload
+     * bot.action([/^buy:/, /^sell:/],     handler); // несколько RegExp
+     */
+    action(pattern: HearsTrigger, ...fns: Middleware<Ctx>[]): this;
+    /**
+     * Добавить глобальный middleware.
+     *
+     * Middleware выполняется **внутри** семафорного слота — backpressure применяется
+     * ко всему пайплайну целиком, а не только к финальным хендлерам.
+     *
+     * @example
+     * bot.use(async (ctx, next) => {
+     *   console.log('before');
+     *   await next();
+     *   console.log('after');
+     * });
+     */
+    use(middleware: Middleware<Ctx>): this;
+    /**
+     * Подключить middleware только если предикат возвращает `true`.
+     *
+     * Если предикат не сработал — обновление прозрачно перетекает к следующим middleware.
+     *
+     * @example Только сообщения с текстом
+     * bot.filter(hasText, async (ctx) => {
+     *   console.log(ctx.text.toUpperCase()); // ctx.text: string
+     * });
+     *
+     * @example Composer + filter
+     * const privateRouter = new Composer();
+     * privateRouter.command('start', handler);
+     * bot.filter(isPrivateChat, privateRouter.middleware());
+     */
+    filter<Narrowed extends Ctx>(predicate: (ctx: Ctx) => ctx is Narrowed, ...fns: Middleware<Narrowed>[]): this;
+    /** Цепочка из middleware: возвращает единый EventHandler, вызывающий каждый fn по очереди. */
+    private pipe;
+}
+//# sourceMappingURL=routing.d.ts.map

package/dist/types/bot/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../src/bot/routing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,UAAU,CAAC;AACtD,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;GASG;AACH,8BAAsB,UAAU,CAAC,GAAG,SAAS,OAAO,CAAE,SAAQ,WAAW,CAAC,GAAG,CAAC;IAG5E;;;;;;;;OAQG;IACH,SAAS,CAAC,GAAG,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAI1C;;;;;OAKG;IACH,UAAU,CAAC,GAAG,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAI3C;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,GAAG,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAIxC;;;;;;;;OAQG;IACH,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAUtD;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAU9D;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAY7D;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAY9D;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI;IAKtC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,SAAS,GAAG,EACzB,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,QAAQ,EACxC,GAAG,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,GAC7B,IAAI;IAWP,8FAA8F;IAC9F,OAAO,CAAC,IAAI;CAIb"}

package/dist/types/bot/triggers.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Тип паттерна для `hears()` и `action()`.
+ *
+ * Принимает:
+ * - строку — точное совпадение
+ * - RegExp — совпадение по регулярке, устанавливает `ctx.match`
+ * - массив строк/RegExp — срабатывает на **первое** совпадение из списка
+ *
+ * @example
+ * bot.hears('привет',            handler);  // строка
+ * bot.hears(/(\d+)\+(\d+)/,      handler);  // RegExp
+ * bot.hears([/^\d+$/, 'помощь'], handler);  // массив: число ИЛИ "помощь"
+ *
+ * bot.action(['confirm', 'ok'],    handler);  // несколько строк
+ * bot.action([/^buy:/, /^sell:/],  handler);  // несколько RegExp
+ */
+export type HearsTrigger = string | RegExp | ReadonlyArray<string | RegExp>;
+/**
+ * Тип паттерна для `command()`.
+ *
+ * Принимает одну команду или массив команд (без учёта ведущего `/`).
+ *
+ * @example
+ * bot.command('start',             handler);  // /start
+ * bot.command(['start', 'begin'],  handler);  // /start или /begin
+ * bot.command(['/help', 'info'],   handler);  // ведущий / необязателен
+ */
+export type CommandTrigger = string | ReadonlyArray<string>;
+/**
+ * Проверяет `HearsTrigger` против строки, перебирая все паттерны.
+ *
+ * Возвращает результат **первого** совпавшего паттерна:
+ * - `RegExpExecArray` — если совпал RegExp (для установки `ctx.match`)
+ * - `true` — если совпала строка
+ * - `null` — ни один паттерн не совпал
+ *
+ * @example
+ * const result = matchTrigger([/^(\d+)$/, 'да'], '42');
+ * // result: RegExpExecArray — ['42', '42'], совпал первый паттерн
+ *
+ * const result2 = matchTrigger([/^\d+$/, 'да'], 'да');
+ * // result2: true — совпала строка
+ */
+export declare function matchTrigger(trigger: HearsTrigger, text: string): RegExpExecArray | true | null;
+/**
+ * Проверяет `CommandTrigger` против текста сообщения.
+ *
+ * Совпадение: текст равен `/<name>` или начинается с `/<name> ` (команда с аргументами).
+ * Сравнение регистронезависимо (`/Start` === `/start`).
+ *
+ * @returns `true` если хотя бы одна команда совпала, иначе `false`
+ *
+ * @example
+ * matchCommand('start', '/start')              // true
+ * matchCommand('start', '/start arg1')         // true
+ * matchCommand(['start', 'help'], '/help')     // true
+ * matchCommand('start', '/stop')               // false
+ * matchCommand('start', '/starter')            // false — нет пробела после имени
+ */
+export declare function matchCommand(trigger: CommandTrigger, text: string): boolean;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/types/bot/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/bot/triggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAyB5D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,GACX,eAAe,GAAG,IAAI,GAAG,IAAI,CAU/B;AAWD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAW3E"}

package/dist/types/core/errors/MaxError.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Базовый класс ошибок SDK.
+ *
+ * Иерархия ошибок позволяет ловить как конкретные типы,
+ * так и все ошибки SDK одним catch-блоком.
+ */
+export declare abstract class MaxError extends Error {
+    abstract readonly code: string;
+    constructor(message: string);
+}
+//# sourceMappingURL=MaxError.d.ts.map

package/dist/types/core/errors/MaxError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaxError.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/MaxError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM;CAO5B"}

package/dist/types/core/errors/errors.d.ts

@@ -0,0 +1,59 @@
+import { MaxError } from "./MaxError.js";
+/**
+ * Ошибка превышения лимита запросов (HTTP 429).
+ *
+ * Содержит информацию о времени до возможности повторного запроса.
+ * Разработчик может использовать retryAfter для реализации своей логики retry.
+ */
+export declare class RateLimitError extends MaxError {
+    readonly retryAfter: number;
+    readonly code = "RATE_LIMIT";
+    constructor(retryAfter: number, message?: string);
+}
+/**
+ * Ошибка аутентификации (HTTP 401).
+ *
+ * Невалидный или отсутствующий токен — бот не сможет работать.
+ */
+export declare class AuthError extends MaxError {
+    readonly code = "AUTH_ERROR";
+    constructor(message?: string);
+}
+/**
+ * Ошибка сети (таймаут, недоступность сервера и т.д.).
+ *
+ * Временная ошибка — можно повторить запрос.
+ */
+export declare class NetworkError extends MaxError {
+    readonly cause?: Error | undefined;
+    readonly code = "NETWORK_ERROR";
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Ошибка API (HTTP 4xx/5xx кроме 401 и 429).
+ *
+ * Содержит HTTP-код и сообщение от сервера.
+ */
+export declare class ApiError extends MaxError {
+    readonly statusCode: number;
+    readonly apiCode?: string | undefined;
+    readonly code = "API_ERROR";
+    constructor(statusCode: number, message: string, apiCode?: string | undefined);
+}
+/**
+ * Ошибка валидации входных данных.
+ *
+ * Возникает при некорректных параметрах, переданных в методы SDK.
+ */
+export declare class ValidationError extends MaxError {
+    readonly code = "VALIDATION_ERROR";
+    constructor(message: string);
+}
+/**
+ * Ресурс не найден (HTTP 404).
+ */
+export declare class NotFoundError extends MaxError {
+    readonly code = "NOT_FOUND";
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/core/errors/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,QAAQ;aAIxB,UAAU,EAAE,MAAM;IAHpC,QAAQ,CAAC,IAAI,gBAAgB;gBAGX,UAAU,EAAE,MAAM,EAClC,OAAO,SAA6D;CAIvE;AAED;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,QAAQ;IACrC,QAAQ,CAAC,IAAI,gBAAgB;gBAEjB,OAAO,SAAgD;CAGpE;AAED;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,QAAQ;aAKtB,KAAK,CAAC,EAAE,KAAK;IAJ/B,QAAQ,CAAC,IAAI,mBAAmB;gBAG9B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAIhC;AAED;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,QAAQ;aAIlB,UAAU,EAAE,MAAM;aAElB,OAAO,CAAC,EAAE,MAAM;IALlC,QAAQ,CAAC,IAAI,eAAe;gBAGV,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,YAAA;CAInC;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,IAAI,sBAAsB;gBAEvB,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,eAAe;gBAEhB,OAAO,SAAqB;CAGzC"}

package/dist/types/core/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { MaxError } from "./MaxError.js";
+export { RateLimitError, AuthError, NetworkError, ApiError, ValidationError, NotFoundError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,cAAc,EACd,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/types/core/http/HttpClient.d.ts

@@ -0,0 +1,28 @@
+import type { HttpClientConfig, IHttpClient, RequestOptions } from "./interfaces.js";
+/**
+ * HTTP-клиент для взаимодействия с MAX Bot API.
+ *
+ * Инкапсулирует всю HTTP-логику: заголовки, таймауты, rate limiting.
+ * Разработчику не нужно думать о низкоуровневых деталях.
+ */
+export declare class HttpClient implements IHttpClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly timeout;
+    private readonly rateLimiter;
+    constructor(config: HttpClientConfig);
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    private request;
+    private buildUrl;
+    /**
+     * Централизованная обработка ответов —
+     * единообразное поведение во всём SDK, легче отлаживать
+     */
+    private handleResponse;
+    private parseRetryAfter;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/types/core/http/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../../../src/core/http/HttpClient.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;gBAElD,MAAM,EAAE,gBAAgB;IAa9B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3D,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1D,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5D,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;YAIrD,OAAO;IAqDrB,OAAO,CAAC,QAAQ;IAiBhB;;;OAGG;YACW,cAAc;IAwC5B,OAAO,CAAC,eAAe;CAmBxB"}

package/dist/types/core/http/index.d.ts

@@ -0,0 +1,3 @@
+export { HttpClient } from "./HttpClient.js";
+export type { HttpClientConfig, IHttpClient, RequestOptions, } from "./interfaces.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/types/core/http/interfaces.d.ts

@@ -0,0 +1,42 @@
+import type { IRateLimiter } from "../rate-limiter/RateLimiter.js";
+/**
+ * Конфигурация HTTP-клиента
+ */
+export interface HttpClientConfig {
+    /** Базовый URL API */
+    baseUrl: string;
+    /** Токен авторизации бота */
+    token: string;
+    /** Таймаут запроса в миллисекундах (по умолчанию 30000) */
+    timeout?: number;
+    /** Rate limiter для контроля частоты запросов */
+    rateLimiter: IRateLimiter;
+}
+/**
+ * Опции для отдельного запроса
+ */
+export interface RequestOptions {
+    /** Тело запроса */
+    body?: unknown;
+    /** Query-параметры */
+    params?: Record<string, string | number | boolean | undefined>;
+    /** Дополнительные заголовки */
+    headers?: Record<string, string>;
+    /**
+     * Сигнал для отмены запроса.
+     * При передаче заменяет встроенный AbortSignal.timeout —
+     * внешний caller берёт управление таймаутом на себя.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Интерфейс HTTP-клиента для возможности замены реализации (например, для моков)
+ */
+export interface IHttpClient {
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/types/core/http/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/core/http/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,WAAW,EAAE,YAAY,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5D,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/D"}

package/dist/types/core/rate-limiter/RateLimiter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Интерфейс rate limiter для возможности замены реализации
+ */
+export interface IRateLimiter {
+    /**
+     * Запрашивает разрешение на выполнение запроса.
+     * Возвращает Promise, который резолвится когда запрос можно выполнить.
+     */
+    acquire(): Promise<void>;
+}
+/**
+ * Rate Limiter на основе алгоритма Token Bucket.
+ *
+ * Token Bucket позволяет накапливать "запас" запросов при простое,
+ * что даёт возможность burst-запросов без превышения среднего лимита.
+ */
+export declare class RateLimiter implements IRateLimiter {
+    private readonly maxTokens;
+    private readonly refillRate;
+    private tokens;
+    private lastRefill;
+    private readonly queue;
+    private processing;
+    /**
+     * @param maxTokens - Максимальное количество токенов (по умолчанию 30)
+     * @param refillRate - Скорость восполнения токенов в секунду (по умолчанию 30)
+     */
+    constructor(maxTokens?: number, refillRate?: number);
+    acquire(): Promise<void>;
+    /**
+     * Восполняет токены пропорционально прошедшему времени
+     */
+    private refill;
+    /**
+     * Планирует ровно один setTimeout для первого элемента очереди.
+     *
+     * Вместо слип-цикла (sleep → refill → check → sleep …) каждый элемент
+     * получает свой точный таймер: setTimeout срабатывает ровно в момент
+     * когда токен готов, без дополнительного ожидания.
+     *
+     * processing-флаг гарантирует единственный активный таймер на очередь —
+     * новые вызовы scheduleNext() от acquire() не создают лишних таймеров.
+     */
+    private scheduleNext;
+}
+//# sourceMappingURL=RateLimiter.d.ts.map

package/dist/types/core/rate-limiter/RateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../../../src/core/rate-limiter/RateLimiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAQD;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;gBACS,SAAS,SAAK,EAAE,UAAU,SAAK;IAcrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB9B;;OAEG;IACH,OAAO,CAAC,MAAM;IAYd;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;CAuCrB"}

package/dist/types/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/types/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/types/filters/index.d.ts

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

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