@hyperttp/core 1.0.0

package/dist/Core/RequestExecutor.js

@@ -0,0 +1,194 @@
+import { request } from "undici";
+import { HttpClientError, TimeoutError } from "../types/errors.js";
+/**
+ * @en Low-level request executor responsible for handling the actual HTTP lifecycle.
+ * @ru Низкоуровневый исполнитель запросов, отвечающий за полный цикл HTTP-жизни.
+ */
+export class RequestExecutor {
+    agent;
+    options;
+    redirectStatusCodes = new Set([301, 302, 303, 307, 308]);
+    constructor(agent, options) {
+        this.agent = agent;
+        this.options = options;
+    }
+    /**
+     * @en Executes a raw HTTP request.
+     * @ru Выполняет "сырой" HTTP-запрос.
+     */
+    async execute(method, url, headers, body, signal, metrics, interceptors) {
+        return this.executeCore(method, url, headers, body, metrics, signal, async (res) => res.body, interceptors);
+    }
+    /**
+     * @en Calculates the delay for the next retry attempt using exponential backoff.
+     * @ru Вычисляет задержку для следующей попытки повтора.
+     */
+    calcDelay(attempt) {
+        const { baseDelay = 1000, maxDelay = 10000, jitter = true, } = this.options.retryOptions;
+        const base = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+        return jitter ? base * (0.75 + Math.random() * 0.5) : base;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * @en Ensures that the response body stream is properly closed to prevent memory leaks.
+     * @ru Гарантирует, что поток тела ответа корректно закрыт.
+     */
+    async drainBody(body) {
+        if (!body)
+            return;
+        try {
+            if (typeof body.dump === "function") {
+                await body.dump();
+                return;
+            }
+            if (typeof body.resume === "function") {
+                body.resume();
+                return;
+            }
+            if (typeof body.destroy === "function") {
+                body.destroy();
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    /**
+     * @en Checks if the status code should trigger a retry attempt.
+     * @ru Проверяет, должен ли данный статус-код вызывать повтор запроса.
+     */
+    shouldRetry(status) {
+        const codes = this.options.retryOptions.retryStatusCodes;
+        if (codes && codes.length > 0) {
+            return codes.includes(status);
+        }
+        return status === 429 || status >= 500;
+    }
+    async executeCore(method, url, headers, body, metrics, signal, parser, interceptors) {
+        let currentUrl = url;
+        let currentMethod = method;
+        let currentHeaders = headers;
+        let currentBody = body;
+        let redirects = 0;
+        let attempt = 0;
+        const manager = interceptors ?? {
+            applyRequest: async (c) => c,
+            applyResponse: async (r) => r,
+        };
+        const timeoutController = new AbortController();
+        const timer = setTimeout(() => timeoutController.abort(), this.options.timeout);
+        const abortHandler = () => timeoutController.abort();
+        if (signal) {
+            if (signal.aborted) {
+                clearTimeout(timer);
+                throw new HttpClientError("Request aborted by user", "ABORTED", 0, undefined, url, method);
+            }
+            signal.addEventListener("abort", abortHandler, { once: true });
+        }
+        try {
+            while (true) {
+                try {
+                    const config = await manager.applyRequest({
+                        url: currentUrl,
+                        method: currentMethod,
+                        headers: currentHeaders,
+                        body: currentBody,
+                    });
+                    const res = await request(config.url, {
+                        method: config.method,
+                        headers: config.headers,
+                        body: config.body,
+                        dispatcher: this.agent,
+                        signal: timeoutController.signal,
+                    });
+                    const status = res.statusCode;
+                    const resHeaders = res.headers;
+                    if (this.options.followRedirects &&
+                        this.redirectStatusCodes.has(status)) {
+                        if (redirects >= this.options.maxRedirects) {
+                            await this.drainBody(res.body);
+                            throw new HttpClientError("Too many redirects", "TOO_MANY_REDIRECTS", status);
+                        }
+                        const location = resHeaders.location;
+                        if (location) {
+                            await this.drainBody(res.body);
+                            const nextUrl = new URL(location, config.url).toString();
+                            const nextMethod = status === 303 ? "GET" : currentMethod;
+                            currentUrl = nextUrl;
+                            currentMethod = nextMethod;
+                            currentBody = nextMethod === "GET" ? undefined : currentBody;
+                            if (nextMethod === "GET") {
+                                if (currentHeaders["content-type"] ||
+                                    currentHeaders["Content-Type"] ||
+                                    currentHeaders["content-length"] ||
+                                    currentHeaders["Content-Length"]) {
+                                    const nextHeaders = { ...currentHeaders };
+                                    delete nextHeaders["content-type"];
+                                    delete nextHeaders["Content-Type"];
+                                    delete nextHeaders["content-length"];
+                                    delete nextHeaders["Content-Length"];
+                                    currentHeaders = nextHeaders;
+                                }
+                            }
+                            redirects++;
+                            continue;
+                        }
+                    }
+                    if (this.shouldRetry(status)) {
+                        if (attempt < this.options.maxRetries) {
+                            if (metrics)
+                                metrics.retries += 1;
+                            await this.drainBody(res.body);
+                            const delay = this.calcDelay(attempt);
+                            if (delay > 0)
+                                await this.sleep(delay);
+                            attempt++;
+                            continue;
+                        }
+                        throw new HttpClientError(`HTTP ${status}`, "HTTP_ERROR", status, undefined, config.url, currentMethod);
+                    }
+                    const transformed = await manager.applyResponse({
+                        status,
+                        headers: resHeaders,
+                        body: res.body,
+                        url: config.url,
+                    });
+                    const parsed = await parser(transformed);
+                    return {
+                        status: transformed.status,
+                        headers: transformed.headers,
+                        body: parsed,
+                        url: transformed.url,
+                    };
+                }
+                catch (err) {
+                    if (err?.name === "AbortError") {
+                        if (signal?.aborted) {
+                            throw new HttpClientError("Request aborted by user", "ABORTED", 0, err, url, method);
+                        }
+                        throw new TimeoutError(url, this.options.timeout);
+                    }
+                    if (attempt < this.options.maxRetries &&
+                        (err?.code === "ECONNREFUSED" ||
+                            err?.code === "ETIMEDOUT" ||
+                            err?.code === "UND_ERR_SOCKET")) {
+                        if (metrics)
+                            metrics.retries += 1;
+                        await this.sleep(this.calcDelay(attempt));
+                        attempt++;
+                        continue;
+                    }
+                    throw err;
+                }
+            }
+        }
+        finally {
+            clearTimeout(timer);
+            if (signal)
+                signal.removeEventListener("abort", abortHandler);
+        }
+    }
+}
+//# sourceMappingURL=RequestExecutor.js.map

package/dist/Core/RequestExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestExecutor.js","sourceRoot":"","sources":["../../src/Core/RequestExecutor.ts"],"names":[],"mappings":"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"}

package/dist/Core/index.d.ts

@@ -0,0 +1,4 @@
+export { HyperCore } from "./HyperCore.js";
+export type { InternalRequest } from "./HyperCore.js";
+export { RequestExecutor } from "./RequestExecutor.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/Core/index.js

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

package/dist/Core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { HyperCore } from "./Core/HyperCore.js";
+export { RequestExecutor } from "./Core/RequestExecutor.js";
+export type { InternalRequest, HttpResponse, HyperStats, } from "./Core/HyperCore.js";
+export type * from "./types/http.js";
+export type * from "./types/options.js";
+export type * from "./types/request.js";
+export type * from "./types/stream.js";
+export type * from "./types/metrics.js";
+export type * from "./types/errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { HyperCore } from "./Core/HyperCore.js";
+export { RequestExecutor } from "./Core/RequestExecutor.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class HttpClientError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    originalError?: Error | undefined;
+    url?: string | undefined;
+    method?: string | undefined;
+    constructor(message: string, code?: string, statusCode?: number | undefined, originalError?: Error | undefined, url?: string | undefined, method?: string | undefined);
+}
+export declare class TimeoutError extends HttpClientError {
+    constructor(url: string, timeout: number);
+}
+export declare class RateLimitError extends HttpClientError {
+    constructor(url: string, retryAfter?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IAG/B,IAAI,EAAE,MAAM;IACZ,UAAU,CAAC,EAAE,MAAM;IACnB,aAAa,CAAC,EAAE,KAAK;IACrB,GAAG,CAAC,EAAE,MAAM;IACZ,MAAM,CAAC,EAAE,MAAM;gBALtB,OAAO,EAAE,MAAM,EACR,IAAI,GAAE,MAAqB,EAC3B,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,aAAa,CAAC,EAAE,KAAK,YAAA,EACrB,GAAG,CAAC,EAAE,MAAM,YAAA,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA;CAKzB;AAED,qBAAa,YAAa,SAAQ,eAAe;gBACnC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIzC;AAED,qBAAa,cAAe,SAAQ,eAAe;gBACrC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAS7C"}

package/dist/types/errors.js

@@ -0,0 +1,28 @@
+export class HttpClientError extends Error {
+    code;
+    statusCode;
+    originalError;
+    url;
+    method;
+    constructor(message, code = "HTTP_ERROR", statusCode, originalError, url, method) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.originalError = originalError;
+        this.url = url;
+        this.method = method;
+        this.name = "HttpClientError";
+    }
+}
+export class TimeoutError extends HttpClientError {
+    constructor(url, timeout) {
+        super(`Timeout after ${timeout}ms`, "TIMEOUT", 408, undefined, url);
+        this.name = "TimeoutError";
+    }
+}
+export class RateLimitError extends HttpClientError {
+    constructor(url, retryAfter) {
+        super(`Rate limited${retryAfter ? ` retry in ${retryAfter}ms` : ""}`, "RATE_LIMIT", 429, undefined, url);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAG/B;IACA;IACA;IACA;IACA;IANT,YACE,OAAe,EACR,OAAe,YAAY,EAC3B,UAAmB,EACnB,aAAqB,EACrB,GAAY,EACZ,MAAe;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QANR,SAAI,GAAJ,IAAI,CAAuB;QAC3B,eAAU,GAAV,UAAU,CAAS;QACnB,kBAAa,GAAb,aAAa,CAAQ;QACrB,QAAG,GAAH,GAAG,CAAS;QACZ,WAAM,GAAN,MAAM,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C,YAAY,GAAW,EAAE,OAAe;QACtC,KAAK,CAAC,iBAAiB,OAAO,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,eAAe;IACjD,YAAY,GAAW,EAAE,UAAmB;QAC1C,KAAK,CACH,eAAe,UAAU,CAAC,CAAC,CAAC,aAAa,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAC9D,YAAY,EACZ,GAAG,EACH,SAAS,EACT,GAAG,CACJ,CAAC;IACJ,CAAC;CACF"}

package/dist/types/http.d.ts

@@ -0,0 +1,5 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export type Method = "GET" | "POST" | "PUT" | "PATCH" | "OPTIONS" | "DELETE" | "HEAD";
+export type ResponseType = "auto" | "json" | "text" | "xml" | "html" | "buffer" | "stream";
+export type SourceType = "json" | "xml" | "html" | "text" | "buffer";
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/types/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,MAAM,GACd,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,MAAM,GACN,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC"}

package/dist/types/http.js

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

package/dist/types/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/types/http.ts"],"names":[],"mappings":""}

package/dist/types/metrics.d.ts

@@ -0,0 +1,63 @@
+export interface RequestMetrics {
+    /**
+     * @ru Время начала запроса (timestamp)
+     * @en Request start time (timestamp)
+     */
+    startTime: number;
+    /**
+     * @ru Время окончания запроса (timestamp)
+     * @en Request end time (timestamp)
+     */
+    endTime: number;
+    /**
+     * @ru Длительность запроса (мс)
+     * @en Request duration (ms)
+     */
+    duration: number;
+    /**
+     * @ru HTTP статус код ответа
+     * @en HTTP status code of response
+     */
+    statusCode?: number;
+    /**
+     * @ru Количество полученных байт
+     * @en Bytes received
+     */
+    bytesReceived: number;
+    /**
+     * @ru Количество отправленных байт
+     * @en Bytes sent
+     */
+    bytesSent: number;
+    /**
+     * @ru Количество повторных попыток
+     * @en Number of retries performed
+     */
+    retries: number;
+    /**
+     * @ru Ответ из кэша
+     * @en Response served from cache
+     */
+    cached: boolean;
+    /**
+     * @ru URL запроса
+     * @en Request URL
+     */
+    url: string;
+    /**
+     * @ru HTTP метод запроса
+     * @en HTTP method
+     */
+    method: string;
+    /**
+     * @ru Хэш тела запроса (для кэширования)
+     * @en Request body hash (for caching)
+     */
+    bodyHash?: string;
+    stages?: {
+        serializationMs?: number;
+        networkMs?: number;
+        parsingMs?: number;
+    };
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/types/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/types/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/types/metrics.js

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

package/dist/types/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/types/metrics.ts"],"names":[],"mappings":""}

package/dist/types/network.d.ts

@@ -0,0 +1,60 @@
+export interface NetworkOptions {
+    /**
+     * @ru Таймаут запроса (мс)
+     * @en Request timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * @ru Максимум одновременных запросов. 0 = без лимита
+     * @en Maximum concurrent requests. 0 = unlimited
+     */
+    maxConcurrent?: number;
+    /**
+     * @ru Количество pipelined запросов на соединение
+     * @en Number of pipelined requests per connection
+     */
+    pipelining?: number;
+    /**
+     * @ru Таймаут keep-alive соединения (мс)
+     * @en Keep-alive connection timeout in milliseconds
+     */
+    keepAliveTimeout?: number;
+    /**
+     * @ru Отклонять недоверенные SSL сертификаты
+     * @en Reject unauthorized SSL certificates
+     */
+    rejectUnauthorized?: boolean;
+    /**
+     * @ru Следовать за редиректами
+     * @en Follow HTTP redirects
+     */
+    followRedirects?: boolean;
+    /**
+     * @ru Максимум редиректов
+     * @en Maximum number of redirects to follow
+     */
+    maxRedirects?: number;
+    /**
+     * @ru Максимальный размер ответа (байты)
+     * @en Maximum response body size in bytes
+     */
+    maxResponseBytes?: number;
+    /**
+     * @ru Переключение режима HTTP/2 и HTTP/1.1
+     * @en Switching between HTTP/2 and HTTP/1.1 modes
+     */
+    allowHttp2?: boolean;
+    /**
+     * @ru User-Agent заголовок
+     * @en User-Agent header string
+     */
+    userAgent?: string;
+    /**
+     * @ru Функция валидации HTTP статуса
+     * @en Function to validate HTTP status code
+     * @param status - HTTP status code
+     * @returns `true` if status is valid
+     */
+    validateStatus?: (status: number) => boolean;
+}
+//# sourceMappingURL=network.d.ts.map

package/dist/types/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/types/network.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C"}

package/dist/types/network.js

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

package/dist/types/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/types/network.ts"],"names":[],"mappings":""}

package/dist/types/options.d.ts

@@ -0,0 +1,41 @@
+import type { LogLevel } from "./http.js";
+import type { NetworkOptions } from "./network.js";
+export interface HyperttpPluginsExtension {
+}
+/**
+ * @ru Базовые настройки HTTP-клиента, входящие в состав основного ядра.
+ * @en Core HTTP client configuration options always available in the engine.
+ */
+export interface BaseHttpClientOptions {
+    /**
+     * @ru Базовые настройки сети (таймауты, заголовки, keep-alive)
+     * @en Base network configuration (timeouts, headers, keep-alive)
+     */
+    network?: Partial<NetworkOptions>;
+    /**
+     * @ru Кастомная функция логирования работы клиента
+     * @en Custom logging function for client operations
+     * @param level - @ru Уровень логирования @en Log level
+     * @param message - @ru Текст лога @en Log message
+     * @param meta - @ru Дополнительные метаданные @en Additional metadata
+     */
+    logger?: (level: LogLevel, message: string, meta?: unknown) => void;
+    /**
+     * @ru Режим подробного (verbose) логирования в консоль
+     * @en Enable verbose logging output to the console
+     */
+    verbose?: boolean;
+    /**
+     * @ru Список путей к папкам для автоматического сканирования и ленивой загрузки локальных плагинов
+     * @en List of directory paths for automatic scanning and lazy loading of local plugins
+     */
+    pluginDirs?: string[];
+    /**
+     * @ru Список явно подключенных плагинов (готовые объекты или строки с именами npm-пакетов)
+     * @en List of explicitly registered plugins (direct objects or npm package name strings)
+     */
+    plugins?: any[];
+    trackMetrics?: any;
+}
+export type HttpClientOptions = BaseHttpClientOptions & HyperttpPluginsExtension;
+//# sourceMappingURL=options.d.ts.map

package/dist/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,WAAW,wBAAwB;CAAG;AAE5C;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAEpE;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAEhB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GACnD,wBAAwB,CAAC"}

package/dist/types/options.js

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

package/dist/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":""}