hyperttp 0.2.1 → 0.2.3

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

@@ -1,50 +1,70 @@
 /**
- * Configuration options for the RateLimiter
+ * @interface RateLimiterConfig
+ * @en Configuration for the token bucket rate limiter.
+ * @ru Конфигурация для ограничителя частоты запросов (алгоритм Token Bucket).
  */
 export interface RateLimiterConfig {
-    /** Maximum number of requests allowed within the time window (default: 100) */
+    /** * @en Maximum number of requests allowed within the window.
+     * @ru Максимальное количество запросов, разрешенных в пределах окна.
+     * @default 100
+     */
     maxRequests?: number;
-    /** Time window in milliseconds (default: 60000ms / 1 minute) */
+    /** * @en Time window in milliseconds.
+     * @ru Временное окно в миллисекундах.
+     * @default 60000 (1 minute)
+     */
     windowMs?: number;
-    /** Maximum array size before aggressive cleanup (default: maxRequests * 2) */
-    maxArraySize?: number;
 }
 /**
- * Implements a sliding window rate limiter to control request frequency.
+ * @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 timestamps;
+    private tokens;
+    private lastRefill;
     private readonly max;
     private readonly window;
-    private readonly maxArraySize;
+    private readonly refillRate;
     constructor(config?: RateLimiterConfig);
     /**
-     * Cleans up old timestamps efficiently
+     * @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).
      */
-    private cleanup;
+    tryConsume(tokensNeeded?: number): boolean;
     /**
-     * Waits if necessary to respect the rate limit, then records the current request.
+     * @en Internal method to refill the bucket based on elapsed time.
+     * @ru Внутренний метод для пополнения корзины на основе прошедшего времени.
      */
-    wait(): Promise<void>;
+    private refill;
     /**
-     * Gets the current number of requests in the sliding window
+     * @en Returns the number of currently "used" slots.
+     * @ru Возвращает количество текущих "занятых" слотов.
      */
     get currentCount(): number;
     /**
-     * Remaining requests in current window
+     * @en Returns how many requests can be made right now.
+     * @ru Возвращает количество запросов, которые можно выполнить прямо сейчас.
      */
     get remainingRequests(): number;
     /**
-     * Milliseconds until next reset
+     * @en Estimated time in ms until the next token is available.
+     * @ru Ожидаемое время в мс до появления следующего токена.
      */
     get timeToReset(): number;
     /**
-     * Resets the rate limiter
+     * @en Instantly refills the bucket to its maximum capacity.
+     * @ru Мгновенно пополняет корзину до максимальной емкости.
      */
     reset(): void;
-    /**
-     * Removes a specific timestamp (для removeToken pattern)
-     */
-    removeToken(timestamp: number): boolean;
 }
 //# 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;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,CAAC,EAAE,iBAAiB;IAMtC;;OAEG;IACH,OAAO,CAAC,OAAO;IAef;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAGzB;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAIxB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAQxC"}
+{"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

@@ -2,83 +2,104 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RateLimiter = void 0;
 /**
- * Implements a sliding window rate limiter to control request frequency.
+ * @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 {
-    timestamps = [];
+    tokens;
+    lastRefill;
     max;
     window;
-    maxArraySize;
+    refillRate; // tokens per ms
     constructor(config) {
         this.max = Math.max(1, config?.maxRequests ?? 100);
         this.window = Math.max(1, config?.windowMs ?? 60_000);
-        this.maxArraySize = config?.maxArraySize ?? this.max * 2;
+        this.refillRate = this.max / this.window;
+        this.tokens = this.max;
+        this.lastRefill = Date.now();
     }
     /**
-     * Cleans up old timestamps efficiently
+     * @en Waits until enough tokens are available and consumes them.
+     * @ru Ожидает появления достаточного количества токенов и потребляет их.
+     * @param tokensNeeded - Number of tokens to consume (default: 1)
      */
-    cleanup() {
-        const now = Date.now();
-        if (this.timestamps.length > this.maxArraySize) {
-            this.timestamps = this.timestamps.filter((t) => now - t < this.window);
+    async wait(tokensNeeded = 1) {
+        this.refill();
+        tokensNeeded = Math.max(1, tokensNeeded);
+        if (this.tokens >= tokensNeeded) {
+            this.tokens -= tokensNeeded;
             return;
         }
-        while (this.timestamps.length > 0 &&
-            now - this.timestamps[0] >= this.window) {
-            this.timestamps.shift();
-        }
+        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);
     }
     /**
-     * Waits if necessary to respect the rate limit, then records the current request.
+     * @en Attempts to consume tokens immediately.
+     * @ru Пытается немедленно потребить токены.
+     * @returns true if tokens were consumed, false otherwise (limit exceeded).
      */
-    async wait() {
-        this.cleanup();
-        if (this.timestamps.length >= this.max) {
-            const delay = this.timestamps[0] + this.window - Date.now();
-            if (delay > 0) {
-                await new Promise((resolve) => setTimeout(resolve, delay));
-            }
+    tryConsume(tokensNeeded = 1) {
+        this.refill();
+        tokensNeeded = Math.max(1, tokensNeeded);
+        if (this.tokens >= tokensNeeded) {
+            this.tokens -= tokensNeeded;
+            return true;
         }
-        this.timestamps.push(Date.now());
+        return false;
+    }
+    /**
+     * @en Internal method to refill the bucket based on elapsed time.
+     * @ru Внутренний метод для пополнения корзины на основе прошедшего времени.
+     */
+    refill() {
+        const now = Date.now();
+        const elapsedMs = now - this.lastRefill;
+        const newTokens = elapsedMs * this.refillRate;
+        this.tokens = Math.min(this.max, this.tokens + newTokens);
+        this.lastRefill = now;
     }
     /**
-     * Gets the current number of requests in the sliding window
+     * @en Returns the number of currently "used" slots.
+     * @ru Возвращает количество текущих "занятых" слотов.
      */
     get currentCount() {
-        this.cleanup();
-        return this.timestamps.length;
+        this.refill();
+        return Math.floor(this.max - this.tokens);
     }
     /**
-     * Remaining requests in current window
+     * @en Returns how many requests can be made right now.
+     * @ru Возвращает количество запросов, которые можно выполнить прямо сейчас.
      */
     get remainingRequests() {
-        return Math.max(0, this.max - this.currentCount);
+        this.refill();
+        return Math.floor(this.tokens);
     }
     /**
-     * Milliseconds until next reset
+     * @en Estimated time in ms until the next token is available.
+     * @ru Ожидаемое время в мс до появления следующего токена.
      */
     get timeToReset() {
-        if (this.timestamps.length === 0)
+        this.refill();
+        if (this.tokens >= 1)
             return 0;
-        const now = Date.now();
-        return this.timestamps[0] + this.window - now;
+        const deficitToOne = 1 - this.tokens;
+        return Math.max(0, Math.ceil(deficitToOne / this.refillRate));
     }
     /**
-     * Resets the rate limiter
+     * @en Instantly refills the bucket to its maximum capacity.
+     * @ru Мгновенно пополняет корзину до максимальной емкости.
      */
     reset() {
-        this.timestamps.length = 0;
-    }
-    /**
-     * Removes a specific timestamp (для removeToken pattern)
-     */
-    removeToken(timestamp) {
-        const index = this.timestamps.indexOf(timestamp);
-        if (index > -1) {
-            this.timestamps.splice(index, 1);
-            return true;
-        }
-        return false;
+        this.tokens = this.max;
+        this.lastRefill = Date.now();
     }
 }
 exports.RateLimiter = RateLimiter;

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,15 +1,15 @@
+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> {
@@ -18,79 +18,63 @@ export declare class RequestBuilder<T = any> {
     private _headers;
     private _body?;
     private _responseType;
+    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);
-    /**
-     * 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
-     */
-    json(): 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
+     * @en Sets the body and ensures Content-Type is application/json.
+     * @ru Устанавливает тело запроса и заголовок Content-Type: application/json.
      */
-    xml(): this;
+    jsonBody<B>(body: B): 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 Sets streaming response mode.
-     */
-    stream(): this;
-    /**
-     * 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
+     * @en Attaches an external AbortSignal for manual cancellation.
+     * @ru Привязывает внешний AbortSignal для ручной отмены запроса.
      */
-    query(params: Record<string, string | number | boolean>): this;
+    signal(signal: AbortSignal): 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
+     * @en Creates a timeout signal for this specific request.
+     * @ru Устанавливает таймаут для конкретно этого запроса.
      */
-    jsonBody<T>(body: T): this;
+    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>;
 }

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":"AAKA;;;;;;;;;;;;;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;IAE7C;;;OAGG;gBACS,GAAG,EAAE,MAAM;IAIvB;;;;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;IACH,MAAM,IAAI,IAAI;IAKd;;;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;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC;CA6BzB"}
+{"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"}