hyperttp 0.1.8 → 0.2.0

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

@@ -1,65 +1,24 @@
-/**
- * Configuration options for the CacheManager
- */
 export interface CacheManagerOptions {
-    /** Time-to-live for cached items in milliseconds (default: 300000ms / 5 minutes) */
+    /** TTL для элементов в миллисекундах (по умолчанию 5 минут) */
     cacheTTL?: number;
-    /** Maximum number of items to store in cache (default: 500) */
+    /** Максимальное количество элементов в кэше (по умолчанию 500) */
     cacheMaxSize?: number;
 }
-/**
- * LRU (Least Recently Used) cache manager with TTL support.
- * Provides a simple key-value storage with automatic eviction of old entries.
- *
- * @example
- * ```ts
- * const cache = new CacheManager({ cacheTTL: 60000, cacheMaxSize: 100 });
- * cache.set('key', { data: 'value' });
- * const value = cache.get<{ data: string }>('key');
- * ```
- */
 export declare class CacheManager {
     private cache;
     private ttl;
-    /**
-     * Creates a new CacheManager instance
-     * @param options - Configuration options for cache behavior
-     */
     constructor(options?: CacheManagerOptions);
-    /**
-     * Retrieves a value from the cache
-     * @template T - The type of the cached value
-     * @param key - The cache key to retrieve
-     * @returns The cached value or null if not found or expired
-     */
-    get<T>(key: string): T | null;
-    /**
-     * Stores a value in the cache
-     * @template T - The type of the value to cache
-     * @param key - The cache key
-     * @param value - The value to store
-     */
-    set<T>(key: string, value: T): void;
-    /**
-     * Checks if a key exists in the cache
-     * @param key - The cache key to check
-     * @returns True if the key exists and hasn't expired
-     */
-    has(key: string): boolean;
-    /**
-     * Removes a specific key from the cache
-     * @param key - The cache key to delete
-     * @returns True if the key was deleted, false if it didn't exist
-     */
-    delete(key: string): boolean;
-    /**
-     * Clears all entries from the cache
-     */
-    clear(): void;
-    /**
-     * Gets the current number of items in the cache
-     * @returns The number of cached items
-     */
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    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,mBAAmB;IAClC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,GAAG,CAAS;IAEpB;;;OAGG;gBACS,OAAO,CAAC,EAAE,mBAAmB;IASzC;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAI7B;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAInC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../../src/Hyperttp/Core/CacheManager.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,GAAG,CAAS;gBAER,OAAO,CAAC,EAAE,mBAAmB;IAYnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAI3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,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;IAIvC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI7B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC,SAAS,IAAI,IAAI;IAIjB,kCAAkC;IAClC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/Hyperttp/Core/CacheManager.js

@@ -2,24 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CacheManager = void 0;
 const lru_cache_1 = require("lru-cache");
-/**
- * LRU (Least Recently Used) cache manager with TTL support.
- * Provides a simple key-value storage with automatic eviction of old entries.
- *
- * @example
- * ```ts
- * const cache = new CacheManager({ cacheTTL: 60000, cacheMaxSize: 100 });
- * cache.set('key', { data: 'value' });
- * const value = cache.get<{ data: string }>('key');
- * ```
- */
 class CacheManager {
     cache;
     ttl;
-    /**
-     * Creates a new CacheManager instance
-     * @param options - Configuration options for cache behavior
-     */
     constructor(options) {
         this.ttl = options?.cacheTTL ?? 300_000;
         this.cache = new lru_cache_1.LRUCache({
@@ -28,50 +13,43 @@ class CacheManager {
             updateAgeOnGet: true,
         });
     }
-    /**
-     * Retrieves a value from the cache
-     * @template T - The type of the cached value
-     * @param key - The cache key to retrieve
-     * @returns The cached value or null if not found or expired
-     */
-    get(key) {
-        return this.cache.get(key) ?? null;
+    // ----------------------
+    // Async API
+    // ----------------------
+    async get(key) {
+        return this.cache.get(key);
     }
-    /**
-     * Stores a value in the cache
-     * @template T - The type of the value to cache
-     * @param key - The cache key
-     * @param value - The value to store
-     */
-    set(key, value) {
+    async set(key, value) {
         this.cache.set(key, value);
     }
-    /**
-     * Checks if a key exists in the cache
-     * @param key - The cache key to check
-     * @returns True if the key exists and hasn't expired
-     */
-    has(key) {
+    async has(key) {
         return this.cache.has(key);
     }
-    /**
-     * Removes a specific key from the cache
-     * @param key - The cache key to delete
-     * @returns True if the key was deleted, false if it didn't exist
-     */
-    delete(key) {
+    async delete(key) {
         return this.cache.delete(key);
     }
-    /**
-     * Clears all entries from the cache
-     */
-    clear() {
+    async clear() {
         this.cache.clear();
     }
-    /**
-     * Gets the current number of items in the cache
-     * @returns The number of cached items
-     */
+    // ----------------------
+    // Sync API (супербыстрый)
+    // ----------------------
+    getSync(key) {
+        return this.cache.get(key);
+    }
+    setSync(key, value) {
+        this.cache.set(key, value);
+    }
+    hasSync(key) {
+        return this.cache.has(key);
+    }
+    deleteSync(key) {
+        return this.cache.delete(key);
+    }
+    clearSync() {
+        this.cache.clear();
+    }
+    /** Количество элементов в кэше */
     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":";;;AAAA,yCAAqC;AAYrC;;;;;;;;;;GAUG;AACH,MAAa,YAAY;IACf,KAAK,CAAwB;IAC7B,GAAG,CAAS;IAEpB;;;OAGG;IACH,YAAY,OAA6B;QACvC,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAQ,CAAC;YACxB,GAAG,EAAE,OAAO,EAAE,YAAY,IAAI,GAAG;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAI,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;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;AArED,oCAqEC"}
+{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../../../../src/Hyperttp/Core/CacheManager.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AASrC,MAAa,YAAY;IACf,KAAK,CAAwB;IAC7B,GAAG,CAAS;IAEpB,YAAY,OAA6B;QACvC,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAQ,CAAC;YACxB,GAAG,EAAE,OAAO,EAAE,YAAY,IAAI,GAAG;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB;IACzB,YAAY;IACZ,yBAAyB;IACzB,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ;QAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,yBAAyB;IACzB,0BAA0B;IAC1B,yBAAyB;IACzB,OAAO,CAAI,GAAW;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;IAC9C,CAAC;IAED,OAAO,CAAI,GAAW,EAAE,KAAQ;QAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,SAAS;QACP,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AA/DD,oCA+DC"}

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

@@ -1,57 +1,9 @@
-import { HttpClientInterface, HttpClientOptions, RequestInterface, RequestMetrics, ResponseType, StreamResponse } from "../../Types";
+import { CookieJar } from "tough-cookie";
+import { HttpClientInterface, HttpClientOptions, RequestInterceptor, RequestInterface, RequestMetrics, ResponseInterceptor, ResponseType, StreamResponse } from "../../Types";
+import { RequestBuilder } from "./RequestBuilder";
 /**
- * @ru
- * Улучшенный HTTP-клиент с кэшированием, ограничением скорости, логикой повторных попыток и расширенными функциями.
- * Предоставляет надежный интерфейс для выполнения HTTP-запросов с автоматической обработкой
- * распространенных паттернов, таких как повторные попытки, кэширование и перехват запросов/ответов.
- * @en
- * Enhanced HTTP client with caching, rate limiting, retry logic, and advanced features.
- * Provides a robust interface for making HTTP requests with automatic handling of
- * common patterns like retries, caching, and request/response interception.
- *
- * @example
- * ```ts
- * const client = new HttpClientImproved({
- *   timeout: 10000,
- *   maxRetries: 3,
- *   cacheTTL: 300000,
- *   rateLimit: { maxRequests: 100, windowMs: 60000 }
- * });
- *
- * const response = await client.get('https://api.example.com/data');
- * ```
- *
- * @example
- * ```ts
- * // Using the fluent request builder
- * const client = new HttpClientImproved();
- * const response = await client.request('https://api.example.com/data')
- *   .headers({ 'Authorization': 'Bearer token' })
- *   .json()
- *   .send();
- * ```
- *
- * @example
- * ```ts
- * // Using RequestInterface for complex requests
- * import { RequestInterface } from './src';
- *
- * class ApiRequest implements RequestInterface {
- *   constructor(
- *     private url: string,
- *     private headers: Record<string, string> = {},
- *     private body?: any
- *   ) {}
- *
- *   getURL(): string { return this.url; }
- *   getHeaders(): Record<string, string> { return this.headers; }
- *   getBodyData(): any { return this.body; }
- * }
- *
- * const client = new HttpClientImproved();
- * const request = new ApiRequest('https://api.example.com/data');
- * const response = await client.get(request);
- * ```
+ * Advanced HTTP client with built-in caching, rate limiting, request queuing,
+ * automatic retries, cookie management, and response decompression.
  */
 export default class HttpClientImproved implements HttpClientInterface {
     private cookieJar;
@@ -66,179 +18,105 @@ export default class HttpClientImproved implements HttpClientInterface {
     private requestInterceptors;
     private responseInterceptors;
     private requestMetrics;
-    constructor(options?: HttpClientOptions);
-    private log;
     /**
-     * Creates a hash of the request body for cache key generation.
-     * @param body - Request body (string or Buffer)
-     * @returns SHA1 hash of the body, truncated to 8 characters
+     * Creates a new instance of HttpClientImproved.
+     * @param options Optional configuration options for the HTTP client
      */
-    private hashBody;
+    constructor(options?: HttpClientOptions);
     /**
-     * Calculates the delay for retry attempts using exponential backoff.
-     * @param attempt - Current retry attempt number (0-based)
-     * @returns Delay in milliseconds
+     * Sets default headers that will be applied to all outgoing requests.
+     * @param headers An object containing header names and values
      */
-    private calcDelay;
+    setDefaultHeaders(headers: Record<string, string>): void;
     /**
-     * Creates a promise that resolves after the specified delay.
-     * @param ms - Delay in milliseconds
-     * @returns Promise that resolves after the delay
+     * Returns the cookie jar used for managing HTTP cookies.
+     * @returns The CookieJar instance
      */
-    private sleep;
+    getCookieJar(): CookieJar;
     /**
-     * Applies all registered request interceptors to modify the request configuration.
-     * Interceptors are executed in sequence, with each one receiving the output of the previous.
-     * @param config - Original request configuration
-     * @returns Modified request configuration
+     * Adds a request interceptor to modify requests before they are sent.
+     * @param interceptor The interceptor function to add
      */
-    private applyRequestInterceptors;
+    addRequestInterceptor(interceptor: RequestInterceptor): void;
     /**
-     * Applies all registered response interceptors to modify the response data.
-     * Interceptors are executed in sequence, with each one receiving the output of the previous.
-     * @param response - Original response data
-     * @returns Modified response data
+     * Adds a response interceptor to modify responses after they are received.
+     * @param interceptor The interceptor function to add
      */
+    addResponseInterceptor(interceptor: ResponseInterceptor): void;
+    /** Closes the HTTP agent to properly terminate keep-alive connections. */
+    close(): void;
+    private log;
+    private decompress;
+    private calcDelay;
+    private sleep;
+    private applyRequestInterceptors;
     private applyResponseInterceptors;
-    /**
-     * Resolves a redirect location relative to the base URL.
-     * Handles both absolute and relative redirect URLs.
-     * @param location - The redirect location from the response
-     * @param baseUrl - The original request URL
-     * @returns The resolved absolute URL
-     */
     private resolveRedirect;
-    /**
-     * Parses the Retry-After header to determine when to retry a request.
-     * Supports both seconds and HTTP date formats.
-     * @param retryAfterHeader - The Retry-After header value
-     * @returns Delay in milliseconds, or undefined if not parseable
-     */
     private parseRetryAfterMs;
-    /**
-     * Reads response body with size limit enforcement.
-     * Collects chunks until the response is complete or the limit is exceeded.
-     * @param body - Async iterable of response chunks
-     * @returns Complete response body as a Buffer
-     */
     private readBodyWithLimit;
-    /**
-     * Removes old metrics entries to prevent memory leaks.
-     * Keeps only metrics from the last 24 hours.
-     */
-    private trimMetrics;
-    /**
-     * Sends an HTTP request with retry logic and rate limiting.
-     * Handles timeouts, redirects, and various retry scenarios.
-     * @param method - HTTP method (GET, POST, etc.)
-     * @param url - Target URL
-     * @param headers - HTTP headers
-     * @param body - Request body (optional)
-     * @param metrics - Optional metrics object to track request details
-     * @param redirects - Number of redirects followed so far
-     * @returns Promise resolving to the response data
-     */
     private sendWithRetry;
-    /**
-     * Parses the Content-Type header to extract MIME type and character encoding.
-     * @param contentType - Content-Type header value
-     * @returns Object containing type and charset information
-     */
     private parseContentType;
-    /**
-     * Parses the HTTP response body based on content type and requested response type.
-     * Handles JSON, XML, text, and buffer responses with fallback parsing.
-     * @param res - HTTP response object
-     * @param responseType - Desired response type
-     * @returns Parsed response data
-     */
+    private xmlParser;
     private parseResponse;
-    /**
-     * Makes an HTTP request without using the cache.
-     * Used for methods that shouldn't be cached or when caching is disabled.
-     * @param method - HTTP method
-     * @param req - Request configuration
-     * @param responseType - Expected response type
-     * @returns Promise resolving to the response data
-     */
-    private requestInternalWithoutCache;
-    /**
-     * Makes an HTTP request with caching support.
-     * Handles cache lookups, request deduplication, and automatic cache storage.
-     * @param method - HTTP method
-     * @param req - Request configuration
-     * @param useCache - Whether to use caching (default: true)
-     * @param responseType - Expected response type
-     * @returns Promise resolving to the response data
-     */
     private requestInternal;
     /**
-     * Makes an HTTP GET request.
-     * Supports both RequestInterface objects and direct URL strings.
-     * GET requests are cached by default unless caching is disabled.
-     * @param req - Request configuration or URL string
-     * @param responseType - Expected response type (default: "json")
-     * @returns Promise resolving to the response data
+     * Performs an HTTP GET request.
+     * @param req The request object containing URL and headers
+     * @param responseType Optional response parsing type
+     * @returns A promise that resolves to the parsed response
+     * @template T The expected response type
      */
     get<T = any>(req: RequestInterface | string, responseType?: ResponseType): Promise<T>;
     /**
-     * Makes an HTTP POST request.
-     * Supports both RequestInterface objects and direct URL strings with body data.
-     * POST requests are not cached by default due to their side effects.
-     * @param req - Request configuration or URL string
-     * @param body - Request body data (optional)
-     * @param responseType - Expected response type (default: "json")
-     * @returns Promise resolving to the response data
+     * Performs an HTTP POST request.
+     * @param req The request object containing URL, body, and headers
+     * @param responseType Optional response parsing type
+     * @returns A promise that resolves to the parsed response
+     * @template T The expected response type
      */
     post<T = any>(req: RequestInterface | string, body?: any, responseType?: ResponseType): Promise<T>;
     /**
-     * Makes an HTTP PUT request.
-     * Supports both RequestInterface objects and direct URL strings with body data.
-     * PUT requests are not cached by default due to their side effects.
-     * @param req - Request configuration or URL string
-     * @param body - Request body data (optional)
-     * @param responseType - Expected response type (default: "json")
-     * @returns Promise resolving to the response data
+     * Performs an HTTP PUT request.
+     * @param req The request object containing URL, body, and headers
+     * @param responseType Optional response parsing type
+     * @returns A promise that resolves to the parsed response
+     * @template T The expected response type
      */
     put<T = any>(req: RequestInterface | string, body?: any, responseType?: ResponseType): Promise<T>;
     /**
-     * @ru Получает потоковый ответ (для SSE, больших файлов).
-     * @en Gets streaming response (for SSE, large files).
+     * Performs an HTTP DELETE request.
+     * @param req The request object containing URL and headers
+     * @param responseType Optional response parsing type
+     * @returns A promise that resolves to the parsed response
+     * @template T The expected response type
      */
-    stream(req: RequestInterface | string): Promise<StreamResponse>;
+    delete<T = any>(req: RequestInterface | string, responseType?: ResponseType): Promise<T>;
     /**
-     * Makes an HTTP DELETE request.
-     * Supports both RequestInterface objects and direct URL strings.
-     * DELETE requests are not cached by default due to their side effects.
-     * @param req - Request configuration or URL string
-     * @param responseType - Expected response type (default: "json")
-     * @returns Promise resolving to the response data
+     * Performs an HTTP PATCH request.
+     * @param req The request object containing URL, body, and headers
+     * @param responseType Optional response parsing type
+     * @returns A promise that resolves to the parsed response
+     * @template T The expected response type
      */
-    delete<T = any>(req: RequestInterface | string, responseType?: ResponseType): Promise<T>;
+    patch<T = any>(req: RequestInterface | string, body?: any, responseType?: ResponseType): Promise<T>;
     /**
-     * Makes an HTTP PATCH request.
-     * PATCH requests are not cached by default due to their side effects.
-     * @param req - Request configuration
-     * @param responseType - Expected response type (default: "json")
-     * @returns Promise resolving to the response data
+     * @ru Получает потоковый ответ (для SSE, больших файлов).
+     * @en Gets streaming response (for SSE, large files).
      */
-    patch<T = any>(req: RequestInterface, responseType?: ResponseType): Promise<T>;
+    stream(req: RequestInterface | string): Promise<StreamResponse>;
     /**
-     * Makes an HTTP HEAD request.
-     * Returns only the status code and headers without the response body.
-     * HEAD requests are not cached by default.
-     * @param req - Request configuration or URL string
-     * @returns Promise resolving to status and headers
+     * Performs an HTTP HEAD request.
+     * @param req The request object containing URL and headers
+     * @returns A promise that resolves when the request completes
      */
     head(req: RequestInterface | string): Promise<{
         status: number;
         headers: Record<string, any>;
     }>;
     /**
-     * Clears the internal cache of the HTTP client.
-     * Removes all cached responses and resets the cache state.
+     * Clears the request cache.
      */
-    clearCache(): void;
+    clearCache(): Promise<void>;
     /**
      * Clears all collected request metrics.
      * Removes performance and timing data from memory.
@@ -264,8 +142,7 @@ export default class HttpClientImproved implements HttpClientInterface {
     request<T = any>(url: string): RequestBuilder<T>;
     /**
      * Returns current statistics about the HTTP client's state.
-     * Useful for monitoring and debugging performance.
-     * @returns Object containing various client statistics
+     * @returns An object containing cache size, request counts, and rate limit information
      */
     getStats(): {
         cacheSize: number;
@@ -273,104 +150,6 @@ export default class HttpClientImproved implements HttpClientInterface {
         queuedRequests: number;
         activeRequests: number;
         currentRateLimit: number;
-        metricsSize: number;
     };
 }
-/**
- * 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
- * ```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();
- * ```
- */
-declare class RequestBuilder<T = any> {
-    private _url;
-    private _method;
-    private _headers;
-    private _body?;
-    private _responseType;
-    /**
-     * 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
-     */
-    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
-     */
-    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
-     */
-    xml(): this;
-    /**
-     * Sets the HTTP method to POST.
-     * @returns The builder instance for chaining
-     */
-    post(): this;
-    /**
-     * @ru Устанавливает потоковый режим ответа.
-     * @en Sets streaming response mode.
-     */
-    stream(): this;
-    /**
-     * Sets the HTTP method to PUT.
-     * @returns The builder instance for chaining
-     */
-    put(): this;
-    /**
-     * Sets the HTTP method to PATCH.
-     * @returns The builder instance for chaining
-     */
-    patch(): this;
-    /**
-     * Sets the HTTP method to DELETE.
-     * @returns The builder instance for chaining
-     */
-    delete(): 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;
-    /**
-     * Sends the HTTP request and returns the response.
-     * @returns Promise resolving to the response data
-     */
-    send(): Promise<T>;
-}
-export {};
 //# sourceMappingURL=HttpClientImproved.d.ts.map

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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"}