@hyperttp/core 1.2.6 → 1.3.1

package/Core/HyperCore.d.ts

@@ -1,48 +1,170 @@
 import type { IHyperCore, HyperTransport, HttpClientOptions, HyperPlugin, InternalRequest, HttpResponse, RequestInterface, StreamResponse, RequestBodyData } from "@hyperttp/types";
-declare module "@hyperttp/types" {
-    interface HyperttpPluginsExtension {
-        baseURL?: string;
-    }
-}
-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[];
-export declare function resolveTransport(config: HttpClientOptions): Promise<HyperTransport>;
+/**
+ * @ru Основной класс HTTP-клиента Hyperttp. Управляет транспортами, плагинами, перехватчиками, повторными попытками и сжатием.
+ * @en Core HTTP client class for Hyperttp. Manages transports, plugins, interceptors, retries, and compression.
+ */
 export declare class HyperCore implements IHyperCore {
+    /** @ru Конфигурация клиента (базовый URL, таймауты, заголовки и т.д.). @en Client configuration (base URL, timeouts, headers, etc.). */
     config: HttpClientOptions;
-    private transport;
-    private transportPromise;
+    private readonly transportManager;
     private readonly defaultHeaders;
     private readonly pluginCtx;
     private readonly pipelines;
+    /**
+     * @ru Создаёт экземпляр HyperCore.
+     * @en Creates an instance of HyperCore.
+     * @param config - Client configuration options.
+     * @param transport - Optional custom transport implementation.
+     */
     constructor(config?: HttpClientOptions, transport?: HyperTransport);
-    private createTransport;
+    private get transport();
     private ensureTransport;
+    private dispatchInternal;
+    /**
+     * @ru Выполняет HTTP-запрос с полным контролем (через объект InternalRequest).
+     * @en Performs an HTTP request with full control (via InternalRequest object).
+     * @param req - Internal request object.
+     * @returns Promise with the HTTP response.
+     */
     dispatch<T = unknown>(req: InternalRequest): Promise<HttpResponse<T>>;
+    /**
+     * @ru Регистрирует плагин для расширения функциональности клиента.
+     * @en Registers a plugin to extend client functionality.
+     * @param plugin - Plugin instance.
+     * @returns This instance for chaining.
+     */
     use(plugin: HyperPlugin): this;
+    /**
+     * @ru Выполняет GET-запрос и возвращает ответ в виде потока (StreamResponse).
+     * @en Performs a GET request and returns the response as a stream (StreamResponse).
+     * @param req - Request URL or RequestInterface object.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the stream response.
+     */
     stream(req: RequestInterface | string, signal?: AbortSignal): Promise<StreamResponse<unknown>>;
+    /**
+     * @ru Выполняет POST-запрос и возвращает ответ в виде потока (StreamResponse).
+     * @en Performs a POST request and returns the response as a stream (StreamResponse).
+     * @param req - Request URL or RequestInterface object.
+     * @param body - Request body data.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the stream response.
+     */
+    postStream<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<StreamResponse<T>>;
+    /**
+     * @ru Выполняет GET-запрос.
+     * @en Performs a GET request.
+     * @param req - Request URL or RequestInterface object.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the HTTP response.
+     */
     get<T = unknown>(req: RequestInterface | string, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет POST-запрос.
+     * @en Performs a POST request.
+     * @param req - Request URL or RequestInterface object.
+     * @param body - Request body data.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the HTTP response.
+     */
     post<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
-    postStream<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<StreamResponse<T>>;
+    /**
+     * @ru Выполняет PUT-запрос.
+     * @en Performs a PUT request.
+     * @param req - Request URL or RequestInterface object.
+     * @param body - Request body data.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the HTTP response.
+     */
     put<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет PATCH-запрос.
+     * @en Performs a PATCH request.
+     * @param req - Request URL or RequestInterface object.
+     * @param body - Request body data.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the HTTP response.
+     */
     patch<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет DELETE-запрос.
+     * @en Performs a DELETE request.
+     * @param req - Request URL or RequestInterface object.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the HTTP response.
+     */
     delete<T = unknown>(req: RequestInterface | string, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет OPTIONS-запрос.
+     * @en Performs an OPTIONS request.
+     * @param req - Request URL or RequestInterface object.
+     * @param body - Optional request body data.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the HTTP response.
+     */
     options<T = unknown>(req: RequestInterface | string, body?: RequestBodyData, signal?: AbortSignal): Promise<HttpResponse<T>>;
+    /**
+     * @ru Выполняет HEAD-запрос.
+     * @en Performs a HEAD request.
+     * @param req - Request URL or RequestInterface object.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the HTTP response (body is always null).
+     */
     head(req: RequestInterface | string, signal?: AbortSignal): Promise<HttpResponse<null>>;
-    private buildInternalRequest;
-    extend(options: Partial<HttpClientOptions>): this;
+    /**
+     * @ru Создаёт новый экземпляр HyperCore с расширенной конфигурацией (поверх текущей).
+     * @en Creates a new HyperCore instance with extended configuration (on top of current).
+     * @param options - Additional configuration options.
+     * @returns New HyperCore instance.
+     */
+    extend(options: Partial<HttpClientOptions>): HyperCore;
+    /**
+     * @ru Алиас для extend(). Создаёт новый экземпляр HyperCore.
+     * @en Alias for extend(). Creates a new HyperCore instance.
+     * @param options - Configuration options.
+     * @returns New HyperCore instance.
+     */
     create(options: Partial<HttpClientOptions>): HyperCore;
+    /**
+     * @ru Уничтожает клиент, закрывая соединения и очищая ресурсы.
+     * @en Destroys the client, closing connections and cleaning up resources.
+     * @param graceful - If true, attempts graceful shutdown (default: true).
+     * @returns Promise that resolves when destruction is complete.
+     */
     destroy(graceful?: boolean): Promise<void>;
+    /**
+     * @ru Выполняет запрос и сразу возвращает распарсенный JSON (сокращённый метод).
+     * @en Performs a request and immediately returns parsed JSON (shortcut method).
+     * @param req - Request URL or RequestInterface object.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the parsed JSON value.
+     * @throws If the response does not contain a json() method.
+     */
     json<T = unknown>(req: RequestInterface | string, signal?: AbortSignal): Promise<T>;
+    /**
+     * @ru Выполняет запрос и возвращает тело как строку (сокращённый метод).
+     * @en Performs a request and returns the body as a string (shortcut method).
+     * @param req - Request URL or RequestInterface object.
+     * @param signal - Optional abort signal.
+     * @returns Promise with the response text.
+     * @throws If the response does not contain a text() method.
+     */
     text(req: RequestInterface | string, signal?: AbortSignal): Promise<string>;
+    /**
+     * @ru Выполняет запрос и немедленно отменяет (сбрасывает) тело ответа без чтения.
+     * @en Performs a request and immediately discards the response body without reading.
+     * @param req - Request URL or RequestInterface object.
+     * @param signal - Optional abort signal.
+     * @returns Promise that resolves after dumping the response.
+     * @throws If the response does not contain a dump() method.
+     */
     dump(req: RequestInterface | string, signal?: AbortSignal): Promise<void>;
+    private runResponsePipeline;
+    private handleDispatchError;
+    private applyDecompression;
+    private buildInternalRequest;
+    private createInternalRequestObject;
+    private appendQueryParams;
+    private dispatchShortcut;
 }
-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":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EAEjB,WAAW,EACX,eAAe,EACf,YAAY,EAEZ,gBAAgB,EAChB,cAAc,EACd,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AAuBzB,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,wBAAwB;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAErC,wBAAgB,UAAU,IAAI,OAAO,CAGpC;AAED,KAAK,YAAY,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,YAAY,EAsBpC,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,cAAc,CAAC,CAmCzB;AAED,qBAAa,SAAU,YAAW,UAAU;IACnC,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;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAG7C,MAAM,GAAE,iBAAiC,EACzC,SAAS,CAAC,EAAE,cAAc;YA0Bd,eAAe;IAI7B,OAAO,CAAC,eAAe;IAUV,QAAQ,CAAC,CAAC,GAAG,OAAO,EAC/B,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAyDpB,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IA2CxB,MAAM,CACjB,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAoB5B,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;IAMd,UAAU,CAAC,CAAC,GAAG,OAAO,EACjC,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,IAAI,CAAC,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAqBtB,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;IA6FrB,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAWjD,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,SAAS;IAWhD,OAAO,CAAC,QAAQ,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,IAAI,CAAC,CAAC,GAAG,OAAO,EAC3B,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC;IAWA,IAAI,CACf,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC;IAWL,IAAI,CACf,GAAG,EAAE,gBAAgB,GAAG,MAAM,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;CAUjB"}
+{"version":3,"file":"HyperCore.d.ts","sourceRoot":"","sources":["../../src/Core/HyperCore.ts"],"names":[],"mappings":"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"}