hyperttp 0.2.2 → 0.2.3

package/dist/Hyperttp/Core/QueueManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueueManager.js","sourceRoot":"","sources":["../../../src/Hyperttp/Core/QueueManager.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,MAAa,YAAY;IAQH;IAPZ,KAAK,GAAmB,EAAE,CAAC;IAC3B,OAAO,GAAG,CAAC,CAAC;IAEpB;;;OAGG;IACH,YAAoB,gBAAgB,EAAE;QAAlB,kBAAa,GAAb,aAAa,CAAK;IAAG,CAAC;IAE1C;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,OAAO,CAAI,QAA0B;QACzC,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,EAAE,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,EAAE,CAAC;YACT,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF;AA9DD,oCA8DC"}
+{"version":3,"file":"QueueManager.js","sourceRoot":"","sources":["../../../src/Hyperttp/Core/QueueManager.ts"],"names":[],"mappings":";;;AAOA,MAAa,YAAY;IAOH;IANZ,OAAO,GAAG,CAAC,CAAC;IACZ,IAAI,GAAG,CAAC,CAAC;IAET,IAAI,GAAqB,IAAI,CAAC;IAC9B,IAAI,GAAqB,IAAI,CAAC;IAEtC,YAAoB,gBAAgB,EAAE;QAAlB,kBAAa,GAAb,aAAa,CAAK;IAAG,CAAC;IAE1C,KAAK,CAAC,OAAO,CAAI,QAA0B;QACzC,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,OAAO,GAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAErE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;gBACpB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;gBACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,QAA0B,EAC1B,OAAwB,EACxB,MAAyB;QAEzB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;YAChB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YAEvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,CAAC;YAED,IAAI,CAAC,IAAI,EAAE,CAAC;YAEZ,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAvED,oCAuEC"}

package/dist/Hyperttp/Core/RateLimiter.d.ts

@@ -1,7 +1,27 @@
+/**
+ * @interface RateLimiterConfig
+ * @en Configuration for the token bucket rate limiter.
+ * @ru Конфигурация для ограничителя частоты запросов (алгоритм Token Bucket).
+ */
 export interface RateLimiterConfig {
+    /** * @en Maximum number of requests allowed within the window.
+     * @ru Максимальное количество запросов, разрешенных в пределах окна.
+     * @default 100
+     */
     maxRequests?: number;
+    /** * @en Time window in milliseconds.
+     * @ru Временное окно в миллисекундах.
+     * @default 60000 (1 minute)
+     */
     windowMs?: number;
 }
+/**
+ * @class RateLimiter
+ * @en Smooth rate limiting using the Token Bucket algorithm.
+ * Allows for short bursts while maintaining a steady long-term rate.
+ * @ru Плавное ограничение частоты запросов с использованием алгоритма Token Bucket.
+ * Позволяет кратковременные всплески, сохраняя стабильную скорость в долгосрочной перспективе.
+ */
 export declare class RateLimiter {
     private tokens;
     private lastRefill;
@@ -9,12 +29,42 @@ export declare class RateLimiter {
     private readonly window;
     private readonly refillRate;
     constructor(config?: RateLimiterConfig);
+    /**
+     * @en Waits until enough tokens are available and consumes them.
+     * @ru Ожидает появления достаточного количества токенов и потребляет их.
+     * @param tokensNeeded - Number of tokens to consume (default: 1)
+     */
     wait(tokensNeeded?: number): Promise<void>;
+    /**
+     * @en Attempts to consume tokens immediately.
+     * @ru Пытается немедленно потребить токены.
+     * @returns true if tokens were consumed, false otherwise (limit exceeded).
+     */
     tryConsume(tokensNeeded?: number): boolean;
+    /**
+     * @en Internal method to refill the bucket based on elapsed time.
+     * @ru Внутренний метод для пополнения корзины на основе прошедшего времени.
+     */
     private refill;
+    /**
+     * @en Returns the number of currently "used" slots.
+     * @ru Возвращает количество текущих "занятых" слотов.
+     */
     get currentCount(): number;
+    /**
+     * @en Returns how many requests can be made right now.
+     * @ru Возвращает количество запросов, которые можно выполнить прямо сейчас.
+     */
     get remainingRequests(): number;
+    /**
+     * @en Estimated time in ms until the next token is available.
+     * @ru Ожидаемое время в мс до появления следующего токена.
+     */
     get timeToReset(): number;
+    /**
+     * @en Instantly refills the bucket to its maximum capacity.
+     * @ru Мгновенно пополняет корзину до максимальной емкости.
+     */
     reset(): void;
 }
 //# sourceMappingURL=RateLimiter.d.ts.map

package/dist/Hyperttp/Core/RateLimiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../../src/Hyperttp/Core/RateLimiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,CAAC,EAAE,iBAAiB;IAQhC,IAAI,CAAC,YAAY,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3C,UAAU,CAAC,YAAY,SAAI,GAAG,OAAO;IAUrC,OAAO,CAAC,MAAM;IASd,IAAI,YAAY,IAAI,MAAM,CAGzB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAG9B;IAED,IAAI,WAAW,IAAI,MAAM,CAMxB;IAED,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../../src/Hyperttp/Core/RateLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,CAAC,EAAE,iBAAiB;IAQtC;;;;OAIG;IACG,IAAI,CAAC,YAAY,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3C;;;;OAIG;IACH,UAAU,CAAC,YAAY,SAAI,GAAG,OAAO;IAUrC;;;OAGG;IACH,OAAO,CAAC,MAAM;IASd;;;OAGG;IACH,IAAI,YAAY,IAAI,MAAM,CAGzB;IAED;;;OAGG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAG9B;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAMxB;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/Hyperttp/Core/RateLimiter.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RateLimiter = void 0;
+/**
+ * @class RateLimiter
+ * @en Smooth rate limiting using the Token Bucket algorithm.
+ * Allows for short bursts while maintaining a steady long-term rate.
+ * @ru Плавное ограничение частоты запросов с использованием алгоритма Token Bucket.
+ * Позволяет кратковременные всплески, сохраняя стабильную скорость в долгосрочной перспективе.
+ */
 class RateLimiter {
     tokens;
     lastRefill;
@@ -14,6 +21,11 @@ class RateLimiter {
         this.tokens = this.max;
         this.lastRefill = Date.now();
     }
+    /**
+     * @en Waits until enough tokens are available and consumes them.
+     * @ru Ожидает появления достаточного количества токенов и потребляет их.
+     * @param tokensNeeded - Number of tokens to consume (default: 1)
+     */
     async wait(tokensNeeded = 1) {
         this.refill();
         tokensNeeded = Math.max(1, tokensNeeded);
@@ -23,11 +35,17 @@ class RateLimiter {
         }
         const deficit = tokensNeeded - this.tokens;
         const waitTimeMs = Math.ceil(deficit / this.refillRate);
+        // Приостанавливаем выполнение на расчетное время
         await new Promise((resolve) => setTimeout(resolve, waitTimeMs));
         this.refill();
         this.tokens -= tokensNeeded;
         this.tokens = Math.max(0, this.tokens);
     }
+    /**
+     * @en Attempts to consume tokens immediately.
+     * @ru Пытается немедленно потребить токены.
+     * @returns true if tokens were consumed, false otherwise (limit exceeded).
+     */
     tryConsume(tokensNeeded = 1) {
         this.refill();
         tokensNeeded = Math.max(1, tokensNeeded);
@@ -37,6 +55,10 @@ class RateLimiter {
         }
         return false;
     }
+    /**
+     * @en Internal method to refill the bucket based on elapsed time.
+     * @ru Внутренний метод для пополнения корзины на основе прошедшего времени.
+     */
     refill() {
         const now = Date.now();
         const elapsedMs = now - this.lastRefill;
@@ -44,21 +66,37 @@ class RateLimiter {
         this.tokens = Math.min(this.max, this.tokens + newTokens);
         this.lastRefill = now;
     }
+    /**
+     * @en Returns the number of currently "used" slots.
+     * @ru Возвращает количество текущих "занятых" слотов.
+     */
     get currentCount() {
         this.refill();
         return Math.floor(this.max - this.tokens);
     }
+    /**
+     * @en Returns how many requests can be made right now.
+     * @ru Возвращает количество запросов, которые можно выполнить прямо сейчас.
+     */
     get remainingRequests() {
         this.refill();
         return Math.floor(this.tokens);
     }
+    /**
+     * @en Estimated time in ms until the next token is available.
+     * @ru Ожидаемое время в мс до появления следующего токена.
+     */
     get timeToReset() {
         this.refill();
         if (this.tokens >= 1)
             return 0;
         const deficitToOne = 1 - this.tokens;
-        return Math.ceil(deficitToOne / this.refillRate);
+        return Math.max(0, Math.ceil(deficitToOne / this.refillRate));
     }
+    /**
+     * @en Instantly refills the bucket to its maximum capacity.
+     * @ru Мгновенно пополняет корзину до максимальной емкости.
+     */
     reset() {
         this.tokens = this.max;
         this.lastRefill = Date.now();

package/dist/Hyperttp/Core/RateLimiter.js.map

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

package/dist/Hyperttp/Core/RequestBuilder.d.ts

@@ -1,17 +1,15 @@
-import { StreamResponse } from "../../Types";
 import HttpClientImproved from "./HttpClientImproved";
 /**
- * Fluent request builder for making HTTP requests with a chainable API.
- * Provides a convenient way to build and send HTTP requests with various options.
- *
- * @example
+ * @class RequestBuilder
+ * @en Fluent request builder for creating HTTP requests with a chainable API.
+ * @ru Fluent request builder для создания HTTP-запросов. Позволяет собирать параметры запроса в цепочку.
+ * * @example
  * ```ts
- * const client = new HttpClientImproved();
- * const response = await client.request('https://api.example.com/data')
- *   .headers({ 'Authorization': 'Bearer token' })
- *   .query({ limit: 10, offset: 0 })
- *   .json()
- *   .send();
+ * const user = await client.request('[https://api.example.com/users](https://api.example.com/users)')
+ * .post()
+ * .jsonBody({ name: 'John' })
+ * .headers({ 'X-Custom-Header': 'value' })
+ * .send();
  * ```
  */
 export declare class RequestBuilder<T = any> {
@@ -20,91 +18,64 @@ export declare class RequestBuilder<T = any> {
     private _headers;
     private _body?;
     private _responseType;
-    private _client?;
+    private _client;
     private _signal?;
+    constructor(url: string, client: HttpClientImproved);
     /**
-     * Creates a new request builder for the specified URL.
-     * @param url - The target URL for the request
-     */
-    constructor(url: string, client?: HttpClientImproved);
-    /**
-     * Sets HTTP headers for the request.
-     * @param headers - Object containing header key-value pairs
-     * @returns The builder instance for chaining
+     * @en Appends multiple headers to the request.
+     * @ru Добавляет несколько заголовков к запросу.
      */
     headers(headers: Record<string, string>): this;
     /**
-     * Sets the request body data.
-     * @param bodyData - The body data to send with the request
-     * @returns The builder instance for chaining
+     * @en Sets the request body.
+     * @ru Устанавливает тело запроса.
      */
     body(bodyData: any): this;
     /**
-     * Sets the response type to JSON.
-     * @returns The builder instance for chaining
+     * @en Sets the body and ensures Content-Type is application/json.
+     * @ru Устанавливает тело запроса и заголовок Content-Type: application/json.
      */
-    json(): this;
+    jsonBody<B>(body: B): this;
     /**
-     * Sets the response type to plain text.
-     * @returns The builder instance for chaining
-     */
-    text(): this;
-    /**
-     * Sets the response type to XML.
-     * @returns The builder instance for chaining
-     */
-    xml(): this;
-    /**
-     * Sets the HTTP method to POST.
-     * @returns The builder instance for chaining
+     * @en Adds URL query parameters.
+     * @ru Добавляет параметры запроса в URL (search params).
      */
+    query(params: Record<string, string | number | boolean>): this;
+    /** @en Set method to POST */
     post(): this;
-    /**
-     * @ru Выполняет запрос в режиме потока.
-     * @en Executes the request in streaming mode.
-     */
-    stream(): Promise<StreamResponse>;
-    /**
-     * Sets the HTTP method to PUT.
-     * @returns The builder instance for chaining
-     */
+    /** @en Set method to PUT */
     put(): this;
-    /**
-     * Sets the HTTP method to PATCH.
-     * @returns The builder instance for chaining
-     */
+    /** @en Set method to PATCH */
     patch(): this;
-    /**
-     * Sets the HTTP method to DELETE.
-     * @returns The builder instance for chaining
-     */
+    /** @en Set method to DELETE */
     delete(): this;
+    /** @en Set method to HEAD */
+    head(): this;
+    /** @en Set response type to JSON */
+    json(): this;
+    /** @en Set response type to Plain Text */
+    text(): this;
+    /** @en Set response type to XML */
+    xml(): this;
+    /** @en Set response type to Buffer */
+    buffer(): this;
+    /** @en Set response type to Stream (AsyncIterable) */
+    stream(): this;
     /**
-     * Adds query parameters to the URL.
-     * @param params - Object containing query parameter key-value pairs
-     * @returns The builder instance for chaining
-     */
-    query(params: Record<string, string | number | boolean>): this;
-    /**
-     * Sets a JSON body for the request.
-     * Automatically sets the Content-Type header to application/json.
-     * @param body - The JSON body data
-     * @returns The builder instance for chaining
-     */
-    jsonBody<T>(body: T): this;
-    /**
-     * @ru Устанавливает AbortSignal для отмены запроса.
+     * @en Attaches an external AbortSignal for manual cancellation.
+     * @ru Привязывает внешний AbortSignal для ручной отмены запроса.
      */
     signal(signal: AbortSignal): this;
     /**
-     * @ru Устанавливает специфичный таймаут для этого запроса.
+     * @en Creates a timeout signal for this specific request.
+     * @ru Устанавливает таймаут для конкретно этого запроса.
      */
     timeout(ms: number): this;
     /**
-     * Sends the HTTP request and returns the response.
-     * @returns Promise resolving to the response data
+     * @en Finalizes and sends the request.
+     * @ru Финализирует и отправляет запрос.
+     * @returns Promise resolving to the expected type T or StreamResponse.
      */
     send(): Promise<T>;
-    private ensureClient;
 }
 //# sourceMappingURL=RequestBuilder.d.ts.map

package/dist/Hyperttp/Core/RequestBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RequestBuilder.d.ts","sourceRoot":"","sources":["../../../src/Hyperttp/Core/RequestBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAItD;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,GAAG;IACjC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAsD;IACrE,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,KAAK,CAAC,CAAM;IACpB,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAC,CAAc;IAE9B;;;OAGG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB;IAKpD;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK9C;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAKzB;;;OAGG;IACH,IAAI,IAAI,IAAI;IAKZ;;;OAGG;IACH,IAAI,IAAI,IAAI;IAKZ;;;OAGG;IACH,GAAG,IAAI,IAAI;IAKX;;;OAGG;IACH,IAAI,IAAI,IAAI;IAKZ;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAUvC;;;OAGG;IACH,GAAG,IAAI,IAAI;IAKX;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,MAAM,IAAI,IAAI;IAKd;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI;IAS9D;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAM1B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKjC;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;IA4BxB,OAAO,CAAC,YAAY;CAOrB"}
+{"version":3,"file":"RequestBuilder.d.ts","sourceRoot":"","sources":["../../../src/Hyperttp/Core/RequestBuilder.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,GAAG;IACjC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAA+D;IAC9E,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,KAAK,CAAC,CAAM;IACpB,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAc;gBAElB,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB;IAKnD;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK9C;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAKzB;;;OAGG;IACH,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAM1B;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI;IAS9D,6BAA6B;IAC7B,IAAI,IAAI,IAAI;IAKZ,4BAA4B;IAC5B,GAAG,IAAI,IAAI;IAKX,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAKb,+BAA+B;IAC/B,MAAM,IAAI,IAAI;IAKd,6BAA6B;IAC7B,IAAI,IAAI,IAAI;IAKZ,oCAAoC;IACpC,IAAI,IAAI,IAAI;IAKZ,0CAA0C;IAC1C,IAAI,IAAI,IAAI;IAKZ,mCAAmC;IACnC,GAAG,IAAI,IAAI;IAKX,sCAAsC;IACtC,MAAM,IAAI,IAAI;IAKd,sDAAsD;IACtD,MAAM,IAAI,IAAI;IAKd;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKjC;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;CA2BzB"}

package/dist/Hyperttp/Core/RequestBuilder.js

@@ -1,23 +1,17 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RequestBuilder = void 0;
-const HttpClientImproved_1 = __importDefault(require("./HttpClientImproved"));
-let defaultClient = null;
 /**
- * Fluent request builder for making HTTP requests with a chainable API.
- * Provides a convenient way to build and send HTTP requests with various options.
- *
- * @example
+ * @class RequestBuilder
+ * @en Fluent request builder for creating HTTP requests with a chainable API.
+ * @ru Fluent request builder для создания HTTP-запросов. Позволяет собирать параметры запроса в цепочку.
+ * * @example
  * ```ts
- * const client = new HttpClientImproved();
- * const response = await client.request('https://api.example.com/data')
- *   .headers({ 'Authorization': 'Bearer token' })
- *   .query({ limit: 10, offset: 0 })
- *   .json()
- *   .send();
+ * const user = await client.request('[https://api.example.com/users](https://api.example.com/users)')
+ * .post()
+ * .jsonBody({ name: 'John' })
+ * .headers({ 'X-Custom-Header': 'value' })
+ * .send();
  * ```
  */
 class RequestBuilder {
@@ -25,146 +19,120 @@ class RequestBuilder {
     _method = "GET";
     _headers = {};
     _body;
-    _responseType = "auto"; // Помним про наш новый дефолт
+    _responseType = "auto";
     _client;
     _signal;
-    /**
-     * Creates a new request builder for the specified URL.
-     * @param url - The target URL for the request
-     */
     constructor(url, client) {
         this._url = url;
         this._client = client;
     }
     /**
-     * Sets HTTP headers for the request.
-     * @param headers - Object containing header key-value pairs
-     * @returns The builder instance for chaining
+     * @en Appends multiple headers to the request.
+     * @ru Добавляет несколько заголовков к запросу.
      */
     headers(headers) {
-        this._headers = headers;
+        Object.assign(this._headers, headers);
         return this;
     }
     /**
-     * Sets the request body data.
-     * @param bodyData - The body data to send with the request
-     * @returns The builder instance for chaining
+     * @en Sets the request body.
+     * @ru Устанавливает тело запроса.
      */
     body(bodyData) {
         this._body = bodyData;
         return this;
     }
     /**
-     * Sets the response type to JSON.
-     * @returns The builder instance for chaining
-     */
-    json() {
-        this._responseType = "json";
-        return this;
-    }
-    /**
-     * Sets the response type to plain text.
-     * @returns The builder instance for chaining
+     * @en Sets the body and ensures Content-Type is application/json.
+     * @ru Устанавливает тело запроса и заголовок Content-Type: application/json.
      */
-    text() {
-        this._responseType = "text";
+    jsonBody(body) {
+        this._body = body;
+        this._headers["Content-Type"] = "application/json; charset=utf-8";
         return this;
     }
     /**
-     * Sets the response type to XML.
-     * @returns The builder instance for chaining
+     * @en Adds URL query parameters.
+     * @ru Добавляет параметры запроса в URL (search params).
      */
-    xml() {
-        this._responseType = "xml";
+    query(params) {
+        const urlObj = new URL(this._url);
+        Object.entries(params).forEach(([k, v]) => urlObj.searchParams.set(k, String(v)));
+        this._url = urlObj.toString();
         return this;
     }
-    /**
-     * Sets the HTTP method to POST.
-     * @returns The builder instance for chaining
-     */
+    /** @en Set method to POST */
     post() {
         this._method = "POST";
         return this;
     }
-    /**
-     * @ru Выполняет запрос в режиме потока.
-     * @en Executes the request in streaming mode.
-     */
-    async stream() {
-        const client = this.ensureClient();
-        return client.stream({
-            getURL: () => this._url,
-            getHeaders: () => this._headers,
-            getBodyData: () => this._body,
-            getSignal: () => this._signal,
-        });
-    }
-    /**
-     * Sets the HTTP method to PUT.
-     * @returns The builder instance for chaining
-     */
+    /** @en Set method to PUT */
     put() {
         this._method = "PUT";
         return this;
     }
-    /**
-     * Sets the HTTP method to PATCH.
-     * @returns The builder instance for chaining
-     */
+    /** @en Set method to PATCH */
     patch() {
         this._method = "PATCH";
         return this;
     }
-    /**
-     * Sets the HTTP method to DELETE.
-     * @returns The builder instance for chaining
-     */
+    /** @en Set method to DELETE */
     delete() {
         this._method = "DELETE";
         return this;
     }
-    /**
-     * Adds query parameters to the URL.
-     * @param params - Object containing query parameter key-value pairs
-     * @returns The builder instance for chaining
-     */
-    query(params) {
-        const urlObj = new URL(this._url);
-        Object.entries(params).forEach(([k, v]) => urlObj.searchParams.set(k, String(v)));
-        this._url = urlObj.toString();
+    /** @en Set method to HEAD */
+    head() {
+        this._method = "HEAD";
         return this;
     }
-    /**
-     * Sets a JSON body for the request.
-     * Automatically sets the Content-Type header to application/json.
-     * @param body - The JSON body data
-     * @returns The builder instance for chaining
-     */
-    jsonBody(body) {
-        this._body = body;
-        this._headers["Content-Type"] = "application/json; charset=utf-8";
+    /** @en Set response type to JSON */
+    json() {
+        this._responseType = "json";
+        return this;
+    }
+    /** @en Set response type to Plain Text */
+    text() {
+        this._responseType = "text";
+        return this;
+    }
+    /** @en Set response type to XML */
+    xml() {
+        this._responseType = "xml";
+        return this;
+    }
+    /** @en Set response type to Buffer */
+    buffer() {
+        this._responseType = "buffer";
+        return this;
+    }
+    /** @en Set response type to Stream (AsyncIterable) */
+    stream() {
+        this._responseType = "stream";
         return this;
     }
     /**
-     * @ru Устанавливает AbortSignal для отмены запроса.
+     * @en Attaches an external AbortSignal for manual cancellation.
+     * @ru Привязывает внешний AbortSignal для ручной отмены запроса.
      */
     signal(signal) {
         this._signal = signal;
         return this;
     }
     /**
-     * @ru Устанавливает специфичный таймаут для этого запроса.
+     * @en Creates a timeout signal for this specific request.
+     * @ru Устанавливает таймаут для конкретно этого запроса.
      */
     timeout(ms) {
         this._signal = AbortSignal.timeout(ms);
         return this;
     }
     /**
-     * Sends the HTTP request and returns the response.
-     * @returns Promise resolving to the response data
+     * @en Finalizes and sends the request.
+     * @ru Финализирует и отправляет запрос.
+     * @returns Promise resolving to the expected type T or StreamResponse.
      */
     async send() {
-        const client = this.ensureClient();
         const req = {
             getURL: () => this._url,
             getBodyData: () => this._body,
@@ -172,26 +140,23 @@ class RequestBuilder {
             getSignal: () => this._signal,
         };
         if (this._responseType === "stream") {
-            return (await client.stream(req));
+            return (await this._client.stream(req));
         }
         switch (this._method) {
             case "POST":
-                return client.post(req, this._body, this._responseType);
+                return this._client.post(req, this._body, this._responseType);
             case "PUT":
-                return client.put(req, this._body, this._responseType);
+                return this._client.put(req, this._body, this._responseType);
             case "PATCH":
-                return client.patch(req, this._body, this._responseType);
+                return this._client.patch(req, this._body, this._responseType);
             case "DELETE":
-                return client.delete(req, this._responseType);
+                return this._client.delete(req, this._responseType);
+            case "HEAD":
+                return (await this._client.head(req));
             default:
-                return client.get(req, this._responseType);
+                return this._client.get(req, this._responseType);
         }
     }
-    ensureClient() {
-        return (this._client ??
-            defaultClient ??
-            (defaultClient = new HttpClientImproved_1.default()));
-    }
 }
 exports.RequestBuilder = RequestBuilder;
 //# sourceMappingURL=RequestBuilder.js.map