hyperttp 0.2.4 → 0.2.6

package/README.md

@@ -20,16 +20,16 @@ Advanced HTTP client for Node.js with caching, rate limiting, request queuing, a
 npm install hyperttp
 ```
 
-## Basic Usage
+---
+
+## 🚀 Simple Usage
+
+Get started in seconds — just import and make requests:
 
 ```typescript
 import HttpClientImproved from "hyperttp";
 
-const client = new HttpClientImproved({
-  timeout: 10000,
-  maxConcurrent: 10,
-  logger: (level, msg) => console.log(`[${level}] ${msg}`),
-});
+const client = new HttpClientImproved();
 
 // Simple GET request
 const data = await client.get("https://api.example.com/data");
@@ -40,18 +40,112 @@ const postData = await client.post("https://api.example.com/items", {
   name: "Item 1",
 });
 console.log(postData);
+```
+
+**That's it!** Caching, request queuing, and retries are enabled by default.
+
+---
+
+## ⚙️ Advanced Configuration
+
+Configure all components for your specific needs:
+
+```typescript
+import HttpClientImproved from "hyperttp";
+
+const client = new HttpClientImproved({
+  // 🌐 Network settings
+  network: {
+    timeout: 10000,                    // Request timeout (ms)
+    maxConcurrent: 50,                 // Max concurrent requests
+    maxRedirects: 5,                   // Max redirects to follow
+    followRedirects: true,             // Follow redirects automatically
+    userAgent: "MyApp/1.0",            // User-Agent header
+    allowHttp2: true,                  // Enable HTTP/2
+    pipelining: 10,                    // Request pipelining
+    keepAliveTimeout: 30000,           // Keep-alive timeout
+    rejectUnauthorized: false,         // Skip SSL certificate validation
+  },
+
+  // 💾 Caching (LRU cache)
+  cache: {
+    enabled: true,                     // Enable caching
+    ttl: 1000 * 60 * 5,                // Cache TTL (5 minutes)
+    maxSize: 500,                      // Max cache size (entries)
+  },
+
+  // 🚦 Rate Limiting (Token Bucket)
+  rateLimit: {
+    enabled: true,                     // Enable rate limiting
+    maxRequests: 100,                  // Max requests per window
+    windowMs: 60000,                   // Time window (ms)
+  },
+
+  // 📊 Request Queue
+  queue: {
+    enabled: true,                     // Enable request queue
+  },
+
+  // 🔄 Retry Logic
+  retry: {
+    maxRetries: 3,                     // Max retry attempts
+    baseDelay: 1000,                   // Base delay between retries (ms)
+    maxDelay: 10000,                   // Max delay (ms)
+    jitter: true,                      // Add randomization to delays
+    retryStatusCodes: [408, 429, 500, 502, 503, 504],
+  },
+
+  // 📈 Metrics
+  metrics: {
+    enabled: true,                     // Enable metrics collection
+    maxHistory: 1000,                  // Metrics history size
+  },
+
+  // 🔍 Logging
+  verbose: true,                       // Enable verbose logging
+  logger: (level, msg) => console.log(`[${level}] ${msg}`),
+});
+```
 
-// Using fluent RequestBuilder
-const builderData = await client
+### Using Advanced Features
+
+```typescript
+// Using Fluent RequestBuilder
+const result = await client
   .request("https://api.example.com/search")
   .query({ q: "hyperttp", limit: 10 })
   .headers({ Authorization: "Bearer TOKEN" })
   .json()
   .send();
 
-console.log(builderData);
+console.log(result);
+
+// Get client statistics
+const stats = client.getStats();
+console.log({
+  cacheSize: stats.cacheSize,           // Current cache size
+  inflightRequests: stats.inflightRequests, // Active requests
+  queuedRequests: stats.queuedRequests, // Requests waiting in queue
+  activeRequests: stats.activeRequests, // Currently executing
+  currentRateLimit: stats.currentRateLimit, // Used rate limit slots
+});
+
+// Work with metrics
+const metrics = client.getMetrics("https://api.example.com/data");
+console.log(metrics); // Timing, bytes, retries, cache hits
+
+// Clear cache
+client.clearCache();
+
+// Clear metrics
+client.clearMetrics();
+
+// Graceful shutdown
+await client.destroy();
 ```
 
+---
+
 ## Fluent Builder API
 
 ```typescript
@@ -65,18 +159,37 @@ client
   .then(console.log);
 ```
 
-## Advanced Features
+---
+
+## Architecture Components
 
-- Caching: Automatically caches GET/HEAD responses, configurable TTL and max size
+### 💾 CacheManager
+LRU cache with TTL and metadata support (etag, lastModified):
+- Automatically caches GET/HEAD responses
+- Configurable size and TTL
+- Methods: `get()`, `set()`, `getWithMetadata()`, `setWithMetadata()`
 
-- Rate limiting: Prevents overwhelming servers
+### 📊 QueueManager
+Request queue management:
+- Concurrency control (maxConcurrent)
+- FIFO processing of pending requests
+- Methods: `enqueue()`, `activeCount`, `queuedCount`
 
-- Retries: Automatic retries for 408, 429, 500, 502, 503, 504 with exponential backoff
+### 🚦 RateLimiter
+Token bucket algorithm with wait queue:
+- Smooth rate limiting
+- FIFO waiting when limit exceeded
+- Methods: `wait()`, `tryConsume()`, `remainingRequests`
 
-- Cookies: Persistent cookie jar per client
+### 📈 MetricsManager
+Performance metrics collection and analysis:
+- Request timing
+- Bytes sent/received
+- Cache hits/misses
+- Retry counts
 
-- Metrics: Track request timings, bytes sent/received, retries, and cache hits
+---
 
 ## Documentation
 
-- [Русский](https://github.com/Dirold2/hyperttp/blob/main/lang/ru/README.md)
+- [Русский](https://github.com/Dirold2/hyperttp/blob/main/lang/ru/README.md)

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

@@ -1,61 +1,84 @@
-/**
- * @interface CacheEntry
- */
-export interface CacheEntry<T> {
-    data: T;
-    etag?: string;
-    lastModified?: string;
-    timestamp: number;
-}
-/**
- * @interface CacheManagerOptions
- */
-export interface CacheManagerOptions {
-    cacheTTL?: number;
-    cacheMaxSize?: number;
-}
+import { CacheManagerOptions } from "../../Types/cache";
 /**
  * @class CacheManager
+ * @en High-performance in-memory cache based on LRU strategy.
+ * Provides TTL support, metadata storage (etag, lastModified) and fast key-value access.
+ *
+ * @ru Высокопроизводительный in-memory кэш на основе LRU стратегии.
+ * Поддерживает TTL, хранение метаданных (etag, lastModified) и быстрый доступ по ключу.
  */
 export declare class CacheManager {
-    private cache;
-    private ttl;
+    private readonly cache;
     constructor(options?: CacheManagerOptions);
     /**
-     * @en Retrieves data along with HTTP validation metadata.
+     * @en Retrieves cached value by key.
+     * @ru Получает значение из кэша по ключу.
+     *
+     * @template T
+     * @param key Cache key
+     * @returns Cached value or undefined if not found
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * @en Stores value in cache.
+     * @ru Сохраняет значение в кэш.
+     *
+     * @template T
+     * @param key Cache key
+     * @param value Value to store
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * @en Retrieves cached entry with metadata (etag, lastModified).
+     * @ru Получает запись кэша вместе с метаданными (etag, lastModified).
+     *
+     * @template T
+     * @param key Cache key
+     * @returns Cached entry with metadata or undefined
      */
-    getWithMetadata<T>(key: string): Promise<{
+    getWithMetadata<T>(key: string): {
         data: T;
         etag?: string;
         lastModified?: string;
-        isExpired: boolean;
-    } | null>;
+    } | undefined;
+    /**
+     * @en Stores value with optional HTTP metadata (etag, lastModified).
+     * @ru Сохраняет значение с дополнительными HTTP метаданными (etag, lastModified).
+     *
+     * @template T
+     * @param key Cache key
+     * @param data Value to store
+     * @param meta Optional HTTP metadata
+     */
+    setWithMetadata<T>(key: string, data: T, meta?: {
+        etag?: string;
+        lastModified?: string;
+    }): void;
     /**
-     * @en Stores data with optional ETag and Last-Modified headers.
+     * @en Checks if key exists in cache.
+     * @ru Проверяет наличие ключа в кэше.
+     *
+     * @param key Cache key
+     * @returns true if exists, otherwise false
      */
-    setWithMetadata<T>(key: string, data: T, meta: {
-        etag?: unknown;
-        lastModified?: unknown;
-    }): Promise<void>;
+    has(key: string): boolean;
     /**
-     * @en Gets an item from cache.
+     * @en Deletes value from cache by key.
+     * @ru Удаляет значение из кэша по ключу.
+     *
+     * @param key Cache key
+     * @returns true if value was removed
      */
-    get<T>(key: string): Promise<T | undefined>;
+    delete(key: string): boolean;
     /**
-     * @en Standard async set method.
+     * @en Clears entire cache.
+     * @ru Очищает весь кэш.
      */
-    set<T>(key: string, value: T): Promise<void>;
+    clear(): void;
     /**
-     * @en Checks if key exists and is not expired.
+     * @en Returns current cache size.
+     * @ru Возвращает текущий размер кэша.
      */
-    has(key: string): Promise<boolean>;
-    delete(key: string): Promise<boolean>;
-    clear(): Promise<void>;
-    getSync<T>(key: string): T | undefined;
-    setSync<T>(key: string, value: T): void;
-    hasSync(key: string): boolean;
-    deleteSync(key: string): boolean;
-    clearSync(): void;
     get size(): number;
 }
 //# sourceMappingURL=CacheManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../src/Hyperttp/Core/CacheManager.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,GAAG,CAAS;gBAER,OAAO,CAAC,EAAE,mBAAmB;IASzC;;OAEG;IACG,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC;KACpB,GAAG,IAAI,CAAC;IAcT;;OAEG;IACG,eAAe,CAAC,CAAC,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/C,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAMjD;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAItC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAOvC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI7B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC,SAAS,IAAI,IAAI;IAIjB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../src/Hyperttp/Core/CacheManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE9C,OAAO,CAAC,EAAE,mBAAmB;IAQzC;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAMnC;;;;;;;OAOG;IACH,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAC1B;QACE,IAAI,EAAE,CAAC,CAAC;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACD,SAAS;IAIb;;;;;;;;OAQG;IACH,eAAe,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,IAAI;IAQP;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/Hyperttp/Core/CacheManager.js

@@ -4,101 +4,103 @@ exports.CacheManager = void 0;
 const lru_cache_1 = require("lru-cache");
 /**
  * @class CacheManager
+ * @en High-performance in-memory cache based on LRU strategy.
+ * Provides TTL support, metadata storage (etag, lastModified) and fast key-value access.
+ *
+ * @ru Высокопроизводительный in-memory кэш на основе LRU стратегии.
+ * Поддерживает TTL, хранение метаданных (etag, lastModified) и быстрый доступ по ключу.
  */
 class CacheManager {
     cache;
-    ttl;
     constructor(options) {
-        this.ttl = options?.cacheTTL ?? 300_000;
         this.cache = new lru_cache_1.LRUCache({
             max: options?.cacheMaxSize ?? 500,
-            ttl: this.ttl,
+            ttl: options?.cacheTTL ?? 300_000,
             updateAgeOnGet: true,
         });
     }
     /**
-     * @en Retrieves data along with HTTP validation metadata.
+     * @en Retrieves cached value by key.
+     * @ru Получает значение из кэша по ключу.
+     *
+     * @template T
+     * @param key Cache key
+     * @returns Cached value or undefined if not found
      */
-    async getWithMetadata(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return null;
-        const isExpired = Date.now() - entry.timestamp > this.ttl;
-        return {
-            data: entry.data,
-            etag: entry.etag,
-            lastModified: entry.lastModified,
-            isExpired,
-        };
+    get(key) {
+        return this.cache.get(key)?.data;
     }
     /**
-     * @en Stores data with optional ETag and Last-Modified headers.
+     * @en Stores value in cache.
+     * @ru Сохраняет значение в кэш.
+     *
+     * @template T
+     * @param key Cache key
+     * @param value Value to store
      */
-    async setWithMetadata(key, data, meta) {
+    set(key, value) {
         this.cache.set(key, {
-            data,
-            etag: typeof meta.etag === "string" ? meta.etag : undefined,
-            lastModified: typeof meta.lastModified === "string" ? meta.lastModified : undefined,
-            timestamp: Date.now(),
+            data: value,
         });
     }
     /**
-     * @en Gets an item from cache.
+     * @en Retrieves cached entry with metadata (etag, lastModified).
+     * @ru Получает запись кэша вместе с метаданными (etag, lastModified).
+     *
+     * @template T
+     * @param key Cache key
+     * @returns Cached entry with metadata or undefined
      */
-    async get(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        return entry.data;
+    getWithMetadata(key) {
+        return this.cache.get(key);
     }
     /**
-     * @en Standard async set method.
+     * @en Stores value with optional HTTP metadata (etag, lastModified).
+     * @ru Сохраняет значение с дополнительными HTTP метаданными (etag, lastModified).
+     *
+     * @template T
+     * @param key Cache key
+     * @param data Value to store
+     * @param meta Optional HTTP metadata
      */
-    async set(key, value) {
+    setWithMetadata(key, data, meta) {
         this.cache.set(key, {
-            data: value,
-            timestamp: Date.now(),
+            data,
+            etag: meta?.etag,
+            lastModified: meta?.lastModified,
         });
     }
     /**
-     * @en Checks if key exists and is not expired.
+     * @en Checks if key exists in cache.
+     * @ru Проверяет наличие ключа в кэше.
+     *
+     * @param key Cache key
+     * @returns true if exists, otherwise false
      */
-    async has(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return false;
-        const isExpired = Date.now() - entry.timestamp > this.ttl;
-        if (isExpired) {
-            this.cache.delete(key);
-            return false;
-        }
-        return true;
-    }
-    async delete(key) {
-        return this.cache.delete(key);
-    }
-    async clear() {
-        this.cache.clear();
-    }
-    // --- Synchronous Methods ---
-    getSync(key) {
-        return this.cache.get(key)?.data;
-    }
-    setSync(key, value) {
-        this.cache.set(key, {
-            data: value,
-            timestamp: Date.now(),
-        });
-    }
-    hasSync(key) {
+    has(key) {
         return this.cache.has(key);
     }
-    deleteSync(key) {
+    /**
+     * @en Deletes value from cache by key.
+     * @ru Удаляет значение из кэша по ключу.
+     *
+     * @param key Cache key
+     * @returns true if value was removed
+     */
+    delete(key) {
         return this.cache.delete(key);
     }
-    clearSync() {
+    /**
+     * @en Clears entire cache.
+     * @ru Очищает весь кэш.
+     */
+    clear() {
         this.cache.clear();
     }
+    /**
+     * @en Returns current cache size.
+     * @ru Возвращает текущий размер кэша.
+     */
     get size() {
         return this.cache.size;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../../../src/Hyperttp/Core/CacheManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../../../src/Hyperttp/Core/CacheManager.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AAGrC;;;;;;;GAOG;AACH,MAAa,YAAY;IACN,KAAK,CAAoC;IAE1D,YAAY,OAA6B;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAQ,CAAC;YACxB,GAAG,EAAE,OAAO,EAAE,YAAY,IAAI,GAAG;YACjC,GAAG,EAAE,OAAO,EAAE,QAAQ,IAAI,OAAO;YACjC,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAI,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACnC,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,eAAe,CAAI,GAAW;QAO5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;OAQG;IACH,eAAe,CACb,GAAW,EACX,IAAO,EACP,IAGC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI;YACJ,IAAI,EAAE,IAAI,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI,EAAE,YAAY;SACjC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AApHD,oCAoHC"}

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

@@ -1,5 +1,11 @@
 import { RequestBuilder } from "./RequestBuilder.js";
-import type { HttpClientInterface, HttpClientOptions, RequestInterface, RequestMetrics, ResponseType, StreamResponse } from "../../Types/index.js";
+import { HttpClientInterface } from "../../Types/http-client.js";
+import { HttpClientOptions } from "../../Types/options.js";
+import { ResponseType } from "../../Types/http.js";
+import { RequestInterface } from "../../Types/request.js";
+import { RequestMetrics } from "../../Types/metrics.js";
+import { StreamResponse } from "../../Types/stream.js";
+import { Readable } from "node:stream";
 /**
  * @class HttpClientImproved
  * @en High-performance HTTP client with built-in caching, queuing, rate limiting, and metrics.
@@ -7,30 +13,22 @@ import type { HttpClientInterface, HttpClientOptions, RequestInterface, RequestM
  */
 export default class HttpClientImproved implements HttpClientInterface {
     private agent;
-    private options;
+    readonly config: HttpClientOptions;
     private cache?;
     private queue?;
     private limiter?;
     private metricsManager;
     private interceptors;
-    private transformer;
     private executor;
-    /**
-     * @en Internal map to track active requests for deduplication and cancellation.
-     * @ru Внутренняя карта для отслеживания активных запросов (дедупликация и отмена).
-     */
+    private converter;
     private inflight;
     private defaultHeaders;
-    constructor(options?: HttpClientOptions);
-    /**
-     * @en Core internal method for handling all HTTP requests.
-     * @ru Основной внутренний метод для обработки всех HTTP-запросов.
-     * @param method HTTP method (GET, POST, etc.)
-     * @param req Request object
-     * @param useCache Whether to use caching for this request
-     * @param responseType Expected response format
-     */
-    private requestInternal;
+    private readonly cacheEnabled;
+    private readonly queueEnabled;
+    private readonly limiterEnabled;
+    private readonly metricsEnabled;
+    private readonly verboseEnabled;
+    constructor(config?: HttpClientOptions);
     /**
      * @en Performs an HTTP GET request.
      * @ru Выполняет HTTP GET запрос.
@@ -62,16 +60,10 @@ export default class HttpClientImproved implements HttpClientInterface {
      */
     patch<T = any>(req: RequestInterface | string, body?: any, responseType?: ResponseType): Promise<T>;
     /**
-     * @en Creates a RequestBuilder for a fluent API approach.
-     * @ru Создает RequestBuilder для использования Fluent API.
-     * @example client.request('url').get().send();
-     */
-    request<T = any>(url: string): RequestBuilder<T>;
-    /**
-     * @en Releases all resources, aborts active requests, and closes connections.
-     * @ru Освобождает ресурсы клиента, отменяет активные запросы и закрывает соединения.
+     * @en Performs an HTTP OPTIONS request.
+     * @ru Выполняет HTTP OPTIONS запрос.
      */
-    destroy(): Promise<void>;
+    options<T = any>(req: RequestInterface | string, body?: any, responseType?: ResponseType): Promise<T>;
     /**
      * @en Performs an HTTP HEAD request.
      * @ru Выполняет HTTP HEAD запрос.
@@ -80,15 +72,34 @@ export default class HttpClientImproved implements HttpClientInterface {
         status: number;
         headers: Record<string, any>;
     }>;
+    /**
+     * @en Creates a new HttpClient instance with merged configuration.
+     * @ru Создаёт новый экземпляр HttpClient с объединённой конфигурацией.
+     *
+     * @param options Partial configuration to override current settings
+     * @returns New HttpClientImproved instance
+     */
+    extend(options: Partial<HttpClientOptions>): HttpClientImproved;
+    /**
+     * @en Alias for extend(). Creates a new configured client instance.
+     * @ru Алиас для extend(). Создаёт новый настроенный экземпляр клиента.
+     *
+     * @param options Partial configuration overrides
+     * @returns New HttpClientImproved instance
+     */
+    create(options: Partial<HttpClientOptions>): HttpClientImproved;
     /**
      * @en Executes a request and returns an AsyncIterable stream.
      * @ru Выполняет запрос и возвращает итерируемый поток данных.
      */
-    stream(req: RequestInterface | string): Promise<StreamResponse>;
+    stream(req: RequestInterface | string): Promise<StreamResponse<Readable>>;
     /**
-     * @en Clears the internal cache.
-     * @ru Полностью очищает внутренний кэш клиента.
+     * @en Creates a RequestBuilder for a fluent API approach.
+     * @ru Создает RequestBuilder для использования Fluent API.
+     * @example client.request('url').get().send();
      */
+    request(url: string): RequestBuilder;
+    destroy(): Promise<void>;
     clearCache(): void;
     /**
      * @en Clears all collected performance metrics.
@@ -113,12 +124,23 @@ export default class HttpClientImproved implements HttpClientInterface {
     getStats(): {
         cacheSize: number;
         inflightRequests: number;
-        queuedRequests: number;
-        activeRequests: number;
-        currentRateLimit: number;
+        queuedRequests: any;
+        activeRequests: any;
+        currentRateLimit: any;
     };
+    warmup(urls: string[], count?: number): Promise<void>;
+    private mergeOptions;
     private normalizeRequest;
-    private applyDefaultOptions;
+    private applyDefaulthcoptions;
+    /**
+     * @en Core internal method for handling all HTTP requests.
+     * @ru Основной внутренний метод для обработки всех HTTP-запросов.
+     * @param method HTTP method (GET, POST, etc.)
+     * @param req Request object
+     * @param useCache Whether to use caching for this request
+     * @param responseType Expected response format
+     */
+    private requestInternal;
     private prepareRequestData;
     private createInitialMetrics;
     private recordSuccess;

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

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