@dementevdev/maxbot-ts 1.0.0

package/dist/esm/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/esm/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/esm/core/errors/MaxError.js

@@ -0,0 +1,15 @@
+/**
+ * Базовый класс ошибок SDK.
+ *
+ * Иерархия ошибок позволяет ловить как конкретные типы,
+ * так и все ошибки SDK одним catch-блоком.
+ */
+export class MaxError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+        // Восстанавливаем прототип — необходимо для корректной работы instanceof в TypeScript
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# sourceMappingURL=MaxError.js.map

package/dist/esm/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/esm/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/esm/core/errors/errors.js

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

package/dist/esm/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/esm/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/esm/core/errors/index.js

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

package/dist/esm/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/esm/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/esm/core/http/HttpClient.js

@@ -0,0 +1,144 @@
+import { ApiError, AuthError, MaxError, NetworkError, NotFoundError, RateLimitError, } from "../errors/index.js";
+/**
+ * HTTP-клиент для взаимодействия с MAX Bot API.
+ *
+ * Инкапсулирует всю HTTP-логику: заголовки, таймауты, rate limiting.
+ * Разработчику не нужно думать о низкоуровневых деталях.
+ */
+export class HttpClient {
+    baseUrl;
+    token;
+    timeout;
+    rateLimiter;
+    constructor(config) {
+        // Валидация токена при создании клиента —
+        // лучше упасть сразу с понятной ошибкой, чем при первом запросе
+        if (!config.token || typeof config.token !== "string") {
+            throw new AuthError("Токен не указан или имеет неверный формат");
+        }
+        this.baseUrl = config.baseUrl;
+        this.token = config.token;
+        this.timeout = config.timeout ?? 30000;
+        this.rateLimiter = config.rateLimiter;
+    }
+    async get(path, options) {
+        return this.request("GET", path, options);
+    }
+    async post(path, options) {
+        return this.request("POST", path, options);
+    }
+    async put(path, options) {
+        return this.request("PUT", path, options);
+    }
+    async patch(path, options) {
+        return this.request("PATCH", path, options);
+    }
+    async delete(path, options) {
+        return this.request("DELETE", path, options);
+    }
+    async request(method, path, options) {
+        // Rate limiter перед каждым запросом —
+        // гарантирует соблюдение лимита 30 rps даже при параллельных вызовах
+        await this.rateLimiter.acquire();
+        const url = this.buildUrl(path, options?.params);
+        const headers = {
+            Authorization: this.token,
+            ...options?.headers,
+        };
+        // Content-Type только для запросов с телом
+        if (options?.body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: options?.body !== undefined
+                    ? JSON.stringify(options.body)
+                    : undefined,
+                // Внешний signal (например, AbortController при остановке бота) имеет
+                // приоритет над таймаутом — внешний caller управляет отменой сам.
+                // Иначе используем AbortSignal.timeout для автоматической очистки ресурсов.
+                signal: options?.signal ?? AbortSignal.timeout(this.timeout),
+            });
+            return await this.handleResponse(response);
+        }
+        catch (error) {
+            // Преобразуем ошибки fetch в наши типы для единообразной обработки
+            if (error instanceof MaxError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === "AbortError" || error.name === "TimeoutError") {
+                    throw new NetworkError(`Таймаут запроса: ${this.timeout}мс`, error);
+                }
+                throw new NetworkError(`Ошибка сети: ${error.message}`, error);
+            }
+            throw new NetworkError("Неизвестная ошибка сети");
+        }
+    }
+    buildUrl(path, params) {
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    /**
+     * Централизованная обработка ответов —
+     * единообразное поведение во всём SDK, легче отлаживать
+     */
+    async handleResponse(response) {
+        if (response.ok) {
+            // Некоторые эндпоинты возвращают пустой ответ (204 No Content)
+            const text = await response.text();
+            if (!text) {
+                return undefined;
+            }
+            return JSON.parse(text);
+        }
+        // Парсим тело ошибки для получения деталей
+        let errorBody = null;
+        try {
+            errorBody = (await response.json());
+        }
+        catch {
+            // Тело ответа не JSON — используем статус-код
+        }
+        const message = errorBody?.message ?? response.statusText;
+        switch (response.status) {
+            case 401:
+                throw new AuthError(message);
+            case 404:
+                throw new NotFoundError(message);
+            case 429: {
+                // Retry-After может быть в секундах или в HTTP-date формате
+                const retryAfter = this.parseRetryAfter(response.headers.get("Retry-After"));
+                throw new RateLimitError(retryAfter, message);
+            }
+            default:
+                throw new ApiError(response.status, message, errorBody?.code);
+        }
+    }
+    parseRetryAfter(header) {
+        if (!header) {
+            // Если заголовок отсутствует, ждём 1 секунду по умолчанию
+            return 1000;
+        }
+        const seconds = parseInt(header, 10);
+        if (!isNaN(seconds)) {
+            return seconds * 1000;
+        }
+        // HTTP-date формат
+        const date = Date.parse(header);
+        if (!isNaN(date)) {
+            return Math.max(0, date - Date.now());
+        }
+        return 1000;
+    }
+}
+//# sourceMappingURL=HttpClient.js.map

package/dist/esm/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/esm/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/esm/core/http/index.js

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

package/dist/esm/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/esm/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/esm/core/http/interfaces.js

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

package/dist/esm/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/esm/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/esm/core/rate-limiter/RateLimiter.js

@@ -0,0 +1,106 @@
+/**
+ * Rate Limiter на основе алгоритма Token Bucket.
+ *
+ * Token Bucket позволяет накапливать "запас" запросов при простое,
+ * что даёт возможность burst-запросов без превышения среднего лимита.
+ */
+export 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);
+    }
+}
+//# sourceMappingURL=RateLimiter.js.map

package/dist/esm/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/esm/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/esm/core/rate-limiter/index.js

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

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

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

package/dist/esm/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/esm/filters/index.js

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