@dementevdev/maxbot-ts 1.0.0

package/dist/cjs/bot/triggers.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchTrigger = matchTrigger;
+exports.matchCommand = matchCommand;
+/**
+ * Проверяет один паттерн против строки.
+ *
+ * Для RegExp с флагами `g`/`y` создаёт новый объект при каждом вызове,
+ * чтобы избежать сдвига `lastIndex` между вызовами.
+ *
+ * @returns Массив совпадения (RegExp), `true` (строка) или `null` (нет совпадения)
+ */
+function matchOne(pattern, text) {
+    if (pattern instanceof RegExp) {
+        // Создаём новый RegExp для stateful-флагов чтобы lastIndex не сохранялся
+        const re = pattern.flags.includes("g") || pattern.flags.includes("y")
+            ? new RegExp(pattern.source, pattern.flags)
+            : pattern;
+        return re.exec(text) ?? null;
+    }
+    return text === pattern ? true : null;
+}
+/**
+ * Проверяет `HearsTrigger` против строки, перебирая все паттерны.
+ *
+ * Возвращает результат **первого** совпавшего паттерна:
+ * - `RegExpExecArray` — если совпал RegExp (для установки `ctx.match`)
+ * - `true` — если совпала строка
+ * - `null` — ни один паттерн не совпал
+ *
+ * @example
+ * const result = matchTrigger([/^(\d+)$/, 'да'], '42');
+ * // result: RegExpExecArray — ['42', '42'], совпал первый паттерн
+ *
+ * const result2 = matchTrigger([/^\d+$/, 'да'], 'да');
+ * // result2: true — совпала строка
+ */
+function matchTrigger(trigger, text) {
+    const patterns = Array.isArray(trigger)
+        ? trigger
+        : [trigger];
+    for (const p of patterns) {
+        const result = matchOne(p, text);
+        if (result !== null)
+            return result;
+    }
+    return null;
+}
+/**
+ * Нормализует имя команды: убирает ведущий `/`, приводит к нижнему регистру.
+ *
+ * @internal
+ */
+function normalizeCommandName(name) {
+    return (name.startsWith("/") ? name.slice(1) : name).toLowerCase();
+}
+/**
+ * Проверяет `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 — нет пробела после имени
+ */
+function matchCommand(trigger, text) {
+    const names = Array.isArray(trigger)
+        ? trigger
+        : [trigger];
+    const lower = text.toLowerCase();
+    for (const raw of names) {
+        const cmd = `/${normalizeCommandName(raw)}`;
+        if (lower === cmd || lower.startsWith(`${cmd} `))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=triggers.js.map

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

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

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

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

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotFoundError = exports.ValidationError = exports.ApiError = exports.NetworkError = exports.AuthError = exports.RateLimitError = exports.MaxError = void 0;
+var MaxError_js_1 = require("./MaxError.js");
+Object.defineProperty(exports, "MaxError", { enumerable: true, get: function () { return MaxError_js_1.MaxError; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_js_1.RateLimitError; } });
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return errors_js_1.AuthError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_js_1.NetworkError; } });
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return errors_js_1.ApiError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_js_1.NotFoundError; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const index_js_1 = require("../errors/index.js");
+/**
+ * HTTP-клиент для взаимодействия с MAX Bot API.
+ *
+ * Инкапсулирует всю HTTP-логику: заголовки, таймауты, rate limiting.
+ * Разработчику не нужно думать о низкоуровневых деталях.
+ */
+class HttpClient {
+    baseUrl;
+    token;
+    timeout;
+    rateLimiter;
+    constructor(config) {
+        // Валидация токена при создании клиента —
+        // лучше упасть сразу с понятной ошибкой, чем при первом запросе
+        if (!config.token || typeof config.token !== "string") {
+            throw new index_js_1.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 index_js_1.MaxError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === "AbortError" || error.name === "TimeoutError") {
+                    throw new index_js_1.NetworkError(`Таймаут запроса: ${this.timeout}мс`, error);
+                }
+                throw new index_js_1.NetworkError(`Ошибка сети: ${error.message}`, error);
+            }
+            throw new index_js_1.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 index_js_1.AuthError(message);
+            case 404:
+                throw new index_js_1.NotFoundError(message);
+            case 429: {
+                // Retry-After может быть в секундах или в HTTP-date формате
+                const retryAfter = this.parseRetryAfter(response.headers.get("Retry-After"));
+                throw new index_js_1.RateLimitError(retryAfter, message);
+            }
+            default:
+                throw new index_js_1.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;
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=HttpClient.js.map

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

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

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

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

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