@hyperttp/core 1.1.11 → 1.2.0

package/Core/HyperCore.d.ts

@@ -1,31 +1,196 @@
-import type { HttpClientOptions } from "../types/options.js";
-import type { RequestBodyData, RequestInterface } from "../types/request.js";
-import type { StreamResponse } from "../types/stream.js";
-import type { HyperTransport } from "../types/transport.js";
-import type { HttpResponse, InternalRequest } from "../types/hyper.js";
-import { HyperPlugin } from "../types/plugins.js";
-export declare class HyperCore {
+import type { IHyperCore, HyperTransport, HttpClientOptions, HyperPlugin, InternalRequest, HttpResponse, RequestInterface, StreamResponse, RequestBodyData } from "@hyperttp/types";
+export type Runtime = "bun" | "node";
+export declare function getRuntime(): Runtime;
+type TransportDef = {
+    name: string;
+    runtime: Runtime[];
+    pkg: string;
+    export: string;
+    priority: number;
+};
+export declare const TRANSPORTS: TransportDef[];
+declare module "@hyperttp/types" {
+    interface HttpClientOptions {
+        /**
+         * @ru Кастомный транспорт, переданный пользователем вручную
+         * @en Manually provided custom transport instance
+         */
+        customTransport?: HyperTransport;
+    }
+}
+export declare function resolveTransport(config: HttpClientOptions): Promise<any>;
+/**
+ * @ru Основной оркестратор HTTP-клиента, управляющий жизненным циклом запросов, плагинами и транспортом.
+ * @en Main HTTP client orchestrator managing request lifecycle, plugins, and network transports.
+ */
+export declare class HyperCore implements IHyperCore {
+    /**
+     * @ru Текущая конфигурация экземпляра клиента.
+     * @en Current client instance configuration.
+     */
     config: HttpClientOptions;
     private transport;
     private transportPromise;
     private readonly defaultHeaders;
     private readonly pluginCtx;
+    private readonly requestHooks;
+    private readonly responseHooks;
+    private readonly errorHooks;
+    private hasRequestHooks;
+    private hasResponseHooks;
+    private hasErrorHooks;
+    /**
+     * @ru Создает новый экземпляр HyperCore.
+     * @en Creates a new HyperCore instance.
+     * @param config - Client configuration options.
+     * @param transport - Pre-configured transport layer.
+     */
     constructor(config: HttpClientOptions, transport?: HyperTransport);
+    /**
+     * @private
+     * @ru Динамически импортирует и инициализирует транспорт в зависимости от рантайма.
+     * @en Dynamically imports and initializes transport depending on the runtime environment.
+     * @throws Error если не удалось загрузить или инициализировать модуль транспорта.
+     * @returns Network transport instance.
+     */
     private createTransport;
+    /**
+     * @private
+     * @ru Гарантирует синглтон-инициализацию сетевого транспорта.
+     * @en Ensures singleton initialization of the network transport layer.
+     * @returns Network transport instance promise.
+     */
     private ensureTransport;
-    dispatch: <T = unknown>(req: InternalRequest) => Promise<HttpResponse<T>>;
+    /**
+     * @ru Главный конвейер (Hot Path) выполнения запроса, последовательно вызывающий хуки плагинов и сетевой транспорт.
+     * @en Main hot path execution pipeline, sequentially running plugin hooks and the network transport.
+     * @template T - Type of the expected response body.
+     * @param req - Prepared internal request configuration.
+     * @returns Formatted HTTP response object.
+     */
+    dispatch<T = unknown>(req: InternalRequest): Promise<HttpResponse<T>>;
+    /**
+     * @private
+     * @ru Вспомогательный хелпер прогона сквозной фазы Response.
+     * @en Internal helper to run through the cross-cutting Response phase hooks.
+     * @template T - Type of the expected response body.
+     * @param res - Raw HTTP response object.
+     * @param req - Original internal request configuration.
+     * @returns Processed response object.
+     */
+    private executeResponseHooks;
+    /**
+     * @ru Регистрирует плагин и встраивает его хуки в конвейер выполнения.
+     * @en Registers a plugin and injects its hooks into the execution pipeline.
+     * @param plugin - Plugin object to register.
+     * @returns Current client instance.
+     */
     use(plugin: HyperPlugin): this;
+    /**
+     * @ru Выполняет GET-запрос в режиме потоковой передачи (streaming) без прогона через хуки плагинов.
+     * @en Executes a GET request in streaming mode, bypassing standard plugin hooks.
+     * @param req - Request configurations or targeted URL string.
+     * @param signal - Optional signal to abort the stream transport.
+     * @returns Stream response mapping container.
+     */
     stream(req: RequestInterface | string, signal?: AbortSignal): Promise<StreamResponse<unknown>>;
+    /**
+     * @ru Выполняет HTTP GET-запрос.
+     * @en Executes an HTTP GET request.
+     * @template T - Type of the expected response body.
+     * @param req - Request URL or options object.
+     * @param signal - Optional cancellation signal.
+     * @returns Wrapped HTTP response.
+     */
     get<T = unknown>(req: RequestInterface | string, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет HTTP POST-запрос с телом данных.
+     * @en Executes an HTTP POST request with a payload body.
+     * @template T - Type of the expected response body.
+     * @param req - Request URL or options object.
+     * @param body - Request body data.
+     * @param signal - Optional cancellation signal.
+     * @returns Wrapped HTTP response.
+     */
     post<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет HTTP PUT-запрос с телом данных.
+     * @en Executes an HTTP PUT request with a payload body.
+     * @template T - Type of the expected response body.
+     * @param req - Request URL or options object.
+     * @param body - Request body data.
+     * @param signal - Optional cancellation signal.
+     * @returns Wrapped HTTP response.
+     */
     put<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет HTTP PATCH-запрос с телом данных.
+     * @en Executes an HTTP PATCH request with a payload body.
+     * @template T - Type of the expected response body.
+     * @param req - Request URL or options object.
+     * @param body - Request body data.
+     * @param signal - Optional cancellation signal.
+     * @returns Wrapped HTTP response.
+     */
     patch<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет HTTP DELETE-запрос.
+     * @en Executes an HTTP DELETE request.
+     * @template T - Type of the expected response body.
+     * @param req - Request URL or options object.
+     * @param signal - Optional cancellation signal.
+     * @returns Wrapped HTTP response.
+     */
     delete<T = unknown>(req: RequestInterface | string, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет HTTP OPTIONS-запрос.
+     * @en Executes an HTTP OPTIONS request.
+     * @template T - Type of the expected response body.
+     * @param req - Request URL or options object.
+     * @param body - Optional request body data.
+     * @param signal - Optional cancellation signal.
+     * @returns Wrapped HTTP response.
+     */
     options<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет HTTP HEAD-запрос. Тело ответа всегда возвращает null.
+     * @en Executes an HTTP HEAD request. Response body always resolves to null.
+     * @param req - Request URL or options object.
+     * @param signal - Optional cancellation signal.
+     * @returns Wrapped null response.
+     */
     head(req: RequestInterface | string, signal?: AbortSignal): Promise<HttpResponse<null>>;
+    /**
+     * @private
+     * @ru Быстрый сборщик внутреннего нормализованного состояния запроса.
+     * @en Fast compiler of internal normalized request configurations.
+     * @param method - HTTP Verb / Method.
+     * @param req - User input request target or configuration block.
+     * @param body - Request body data.
+     * @param signal - Optional AbortSignal.
+     * @returns Compiled request payload.
+     */
     private buildInternalRequest;
+    /**
+     * @ru Создает новую копию ядра, расширяя текущую конфигурацию новыми опциями.
+     * @en Creates a new core copy extending the current instance configuration with fresh options.
+     * @param options - Partial configuration object override.
+     * @returns Extended HyperCore instance.
+     */
     extend(options: Partial<HttpClientOptions>): HyperCore;
+    /**
+     * @ru Алиас метода `extend`. Создает инстанс на базе текущих настроек.
+     * @en Alias for `extend` method. Spawn instance configuration based on current setup.
+     * @param options - Partial configuration object override.
+     * @returns Extended HyperCore instance.
+     */
     create(options: Partial<HttpClientOptions>): HyperCore;
-    destroy(): Promise<void>;
+    /**
+     * @ru Завершает работу транспорта и корректно освобождает дескрипторы активных соединений.
+     * @en Destroys the transport layer lifecycle and cleans up active sockets accurately.
+     * @param graceful - If true, drains pipeline before connection teardown.
+     */
+    destroy(graceful?: boolean): Promise<void>;
 }
+export {};
 //# sourceMappingURL=HyperCore.d.ts.map

package/Core/HyperCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HyperCore.d.ts","sourceRoot":"","sources":["../../src/Core/HyperCore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAiB,MAAM,qBAAqB,CAAC;AA4DjE,qBAAa,SAAS;IACb,MAAM,EAAE,iBAAiB,CAAC;IACjC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAE9B,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,cAAc;YA4BnD,eAAe;IAS7B,OAAO,CAAC,eAAe;IAUhB,QAAQ,GAAI,CAAC,GAAG,OAAO,EAC5B,KAAK,eAAe,KACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAczB;IAEK,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAa9B,MAAM,CACX,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAiC5B,GAAG,CAAC,CAAC,GAAG,OAAO,EACpB,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMpB,IAAI,CAAC,CAAC,GAAG,OAAO,EACrB,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,IAAI,CAAC,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMpB,GAAG,CAAC,CAAC,GAAG,OAAO,EACpB,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,IAAI,CAAC,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMpB,KAAK,CAAC,CAAC,GAAG,OAAO,EACtB,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,IAAI,CAAC,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMpB,MAAM,CAAC,CAAC,GAAG,OAAO,EACvB,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMpB,OAAO,CAAC,CAAC,GAAG,OAAO,EACxB,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,IAAI,CAAC,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAMpB,IAAI,CACT,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAM9B,OAAO,CAAC,oBAAoB;IAoCrB,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,SAAS;IAWtD,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,SAAS;IAIhD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAYtC"}
+{"version":3,"file":"HyperCore.d.ts","sourceRoot":"","sources":["../../src/Core/HyperCore.ts"],"names":[],"mappings":"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"}