hyperttp 0.1.7 → 0.1.9

package/dist/Types/index.d.ts

@@ -1,3 +1,5 @@
+import { RateLimiterConfig } from "../Hyperttp/Core";
+import { ResponseType } from "./request";
 /**
  * Interface for a universal URL extractor
  */
@@ -28,5 +30,259 @@ export interface UrlPattern<T extends string = string> {
     /** Names of the capturing groups to extract */
     groupNames: T[];
 }
+/**
+ * Base error class for HTTP client operations.
+ * Contains additional context about the failed request including status code, URL, and method.
+ */
+export declare class HttpClientError extends Error {
+    statusCode?: number | undefined;
+    originalError?: Error | undefined;
+    url?: string | undefined;
+    method?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, originalError?: Error | undefined, url?: string | undefined, method?: string | undefined);
+}
+/**
+ * Error thrown when an HTTP request exceeds the configured timeout duration.
+ * Contains information about the URL and timeout value that caused the failure.
+ */
+export declare class TimeoutError extends HttpClientError {
+    constructor(url: string, timeout: number);
+}
+/**
+ * Error thrown when an HTTP request is rate limited by the server.
+ * Contains information about the URL and optional retry-after duration.
+ */
+export declare class RateLimitError extends HttpClientError {
+    retryAfter?: number | undefined;
+    constructor(url: string, retryAfter?: number | undefined);
+}
+/**
+ * Log level for HTTP client logging.
+ * Defines the verbosity of log output from the client.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+ * Function type for logging HTTP client events.
+ * Used to customize how the client logs various events like requests, responses, and errors.
+ *
+ * @param level - The severity level of the log message
+ * @param message - The log message content
+ * @param meta - Optional additional context or metadata
+ */
+export type LoggerFunction = (level: LogLevel, message: string, meta?: any) => void;
+/**
+ * Configuration options for HTTP request retry behavior.
+ * Defines how the client should handle failed requests and when to retry them.
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts before giving up */
+    maxRetries: number;
+    /** Base delay in milliseconds between retry attempts (exponential backoff) */
+    baseDelay: number;
+    /** Maximum delay in milliseconds between retry attempts */
+    maxDelay: number;
+    /** HTTP status codes that should trigger a retry */
+    retryStatusCodes: number[];
+    /** Whether to add random jitter to retry delays to prevent thundering herd */
+    jitter: boolean;
+}
+/**
+ * Function type for intercepting and modifying HTTP requests before they are sent.
+ * Request interceptors can modify the URL, method, headers, or body of outgoing requests.
+ *
+ * @param config - The request configuration object
+ * @returns A promise that resolves to the modified request configuration
+ */
+export type RequestInterceptor = (config: {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: string | Buffer;
+}) => Promise<{
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body?: string | Buffer;
+}>;
+/**
+ * Function type for intercepting and modifying HTTP responses before they are processed.
+ * Response interceptors can modify the status, headers, body, or URL of incoming responses.
+ *
+ * @param response - The response object containing status, headers, body, and URL
+ * @returns A promise that resolves to the modified response object
+ */
+export type ResponseInterceptor = (response: {
+    status: number;
+    headers: Record<string, any>;
+    body: Buffer;
+    url: string;
+}) => Promise<{
+    status: number;
+    headers: Record<string, any>;
+    body: Buffer;
+    url: string;
+}>;
+/**
+ * Configuration options for the HttpClientImproved instance.
+ * Defines all the behavior settings for HTTP requests including timeouts, retries, caching, and more.
+ */
+export interface HttpClientOptions {
+    /** Request timeout in milliseconds (default: 15000) */
+    timeout?: number;
+    /** Maximum number of concurrent requests (default: 50) */
+    maxConcurrent?: number;
+    /** Maximum number of retry attempts for failed requests (default: 3) */
+    maxRetries?: number;
+    /** Cache time-to-live in milliseconds (default: 300000) */
+    cacheTTL?: number;
+    /** Maximum number of cached entries (default: 500) */
+    cacheMaxSize?: number;
+    /** Rate limiting configuration to prevent overwhelming servers */
+    rateLimit?: RateLimiterConfig;
+    /** User-Agent string for HTTP requests (default: "Hyperttp/0.1.0 Node.js") */
+    userAgent?: string;
+    /** Custom logger function for HTTP client events */
+    logger?: LoggerFunction;
+    /** Retry behavior configuration */
+    retryOptions?: Partial<RetryOptions>;
+    /** Whether to automatically follow HTTP redirects (default: true) */
+    followRedirects?: boolean;
+    /** Maximum number of redirects to follow (default: 5) */
+    maxRedirects?: number;
+    /** Maximum response size in bytes (default: 1MB) */
+    maxResponseBytes?: number;
+    /** Function to validate HTTP status codes (default: 200-299) */
+    validateStatus?: (status: number) => boolean;
+    /** HTTP methods that should be cached (default: ["GET", "HEAD"]) */
+    cacheMethods?: string[];
+    /** Maximum number of request metrics to store (default: 10000) */
+    maxMetricsSize?: number;
+    /** Whether to enable verbose logging (default: false) */
+    verbose?: boolean;
+    /** Whether to enable request queuing (default: true) */
+    enableQueue?: boolean;
+    /** Whether to enable rate limiting (default: true) */
+    enableRateLimit?: boolean;
+    /** Whether to enable caching (default: true) */
+    enableCache?: boolean;
+}
+/**
+ * Interface for defining HTTP request parameters.
+ * Used to encapsulate URL, headers, and body data for HTTP requests.
+ *
+ * @example
+ * ```ts
+ * 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; }
+ * }
+ * ```
+ */
+export interface RequestInterface {
+    /** Returns the full URL for the HTTP request */
+    getURL(): string;
+    /** Returns the request body data (string, Buffer, or any serializable object) */
+    getBodyData(): any;
+    /** Returns the HTTP headers for the request */
+    getHeaders(): Record<string, string>;
+}
+/**
+ * Interface defining the contract for HTTP client implementations.
+ * Provides methods for making HTTP requests with various HTTP methods.
+ */
+export interface HttpClientInterface {
+    /**
+     * Makes an HTTP GET request
+     * @param req - Request configuration or URL string
+     * @param responseType - Expected response type (default: "json")
+     * @returns Promise resolving to the response data
+     */
+    get<T = any>(req: RequestInterface | string, responseType?: ResponseType): Promise<T>;
+    /**
+     * Makes an HTTP POST request
+     * @param req - Request configuration or URL string
+     * @param body - Request body data
+     * @param responseType - Expected response type (default: "json")
+     * @returns Promise resolving to the response data
+     */
+    post<T = any>(req: RequestInterface | string, body?: any, responseType?: ResponseType): Promise<T>;
+    /**
+     * Makes an HTTP PUT request
+     * @param req - Request configuration or URL string
+     * @param body - Request body data
+     * @param responseType - Expected response type (default: "json")
+     * @returns Promise resolving to the response data
+     */
+    put<T = any>(req: RequestInterface | string, body?: any, responseType?: ResponseType): Promise<T>;
+    stream(req: RequestInterface | string): Promise<StreamResponse>;
+    /**
+     * Makes an HTTP DELETE request
+     * @param req - Request configuration or URL string
+     * @param responseType - Expected response type (default: "json")
+     * @returns Promise resolving to the response data
+     */
+    delete<T = any>(req: RequestInterface | string, responseType?: ResponseType): Promise<T>;
+    /**
+     * Makes an HTTP PATCH request
+     * @param req - Request configuration
+     * @param responseType - Expected response type (default: "json")
+     * @returns Promise resolving to the response data
+     */
+    patch<T = any>(req: RequestInterface | string, responseType?: ResponseType): Promise<T>;
+    /**
+     * Makes an HTTP HEAD request
+     * @param req - Request configuration or URL string
+     * @returns Promise resolving to status and headers
+     */
+    head(req: RequestInterface | string): Promise<{
+        status: number;
+        headers: Record<string, any>;
+    }>;
+    /**
+     * Clears the internal cache of the HTTP client
+     */
+    clearCache(): void;
+}
+/**
+ * Metrics collected for HTTP requests to monitor performance and behavior.
+ * Contains timing information, response details, and caching information.
+ */
+export interface RequestMetrics {
+    /** Timestamp when the request started */
+    startTime: number;
+    /** Timestamp when the request completed */
+    endTime: number;
+    /** Total duration of the request in milliseconds */
+    duration: number;
+    /** HTTP status code of the response (if available) */
+    statusCode?: number;
+    /** Number of bytes received in the response */
+    bytesReceived: number;
+    /** Number of bytes sent in the request body */
+    bytesSent: number;
+    /** Number of retry attempts made for this request */
+    retries: number;
+    /** Whether the response was served from cache */
+    cached: boolean;
+    /** URL of the request */
+    url: string;
+    /** HTTP method used (GET, POST, etc.) */
+    method: string;
+    /** Hash of the request body for cache key generation */
+    bodyHash?: string;
+}
+export interface StreamResponse {
+    status: number;
+    headers: Record<string, any>;
+    body: AsyncIterable<Uint8Array>;
+    url: string;
+}
 export * from "./request";
 //# sourceMappingURL=index.d.ts.map

package/dist/Types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEjE;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACnD,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IAEf,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IAEd,+CAA+C;IAC/C,UAAU,EAAE,CAAC,EAAE,CAAC;CACjB;AAED,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Types/index.ts"],"names":[],"mappings":"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"}

package/dist/Types/index.js

@@ -14,5 +14,52 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitError = exports.TimeoutError = exports.HttpClientError = void 0;
+/**
+ * Base error class for HTTP client operations.
+ * Contains additional context about the failed request including status code, URL, and method.
+ */
+class HttpClientError extends Error {
+    statusCode;
+    originalError;
+    url;
+    method;
+    constructor(message, statusCode, originalError, url, method) {
+        super(message);
+        this.statusCode = statusCode;
+        this.originalError = originalError;
+        this.url = url;
+        this.method = method;
+        this.name = "HttpClientError";
+        Object.setPrototypeOf(this, HttpClientError.prototype);
+    }
+}
+exports.HttpClientError = HttpClientError;
+/**
+ * Error thrown when an HTTP request exceeds the configured timeout duration.
+ * Contains information about the URL and timeout value that caused the failure.
+ */
+class TimeoutError extends HttpClientError {
+    constructor(url, timeout) {
+        super(`Request timeout after ${timeout}ms for ${url}`);
+        this.name = "TimeoutError";
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Error thrown when an HTTP request is rate limited by the server.
+ * Contains information about the URL and optional retry-after duration.
+ */
+class RateLimitError extends HttpClientError {
+    retryAfter;
+    constructor(url, retryAfter) {
+        super(`Rate limited for ${url}${retryAfter ? `, retry after ${retryAfter}ms` : ""}`);
+        this.retryAfter = retryAfter;
+        this.name = "RateLimitError";
+        Object.setPrototypeOf(this, RateLimitError.prototype);
+    }
+}
+exports.RateLimitError = RateLimitError;
 __exportStar(require("./request"), exports);
 //# sourceMappingURL=index.js.map

package/dist/Types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAuCA,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA0CA;;;GAGG;AACH,MAAa,eAAgB,SAAQ,KAAK;IAG/B;IACA;IACA;IACA;IALT,YACE,OAAe,EACR,UAAmB,EACnB,aAAqB,EACrB,GAAY,EACZ,MAAe;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QALR,eAAU,GAAV,UAAU,CAAS;QACnB,kBAAa,GAAb,aAAa,CAAQ;QACrB,QAAG,GAAH,GAAG,CAAS;QACZ,WAAM,GAAN,MAAM,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAZD,0CAYC;AAED;;;GAGG;AACH,MAAa,YAAa,SAAQ,eAAe;IAC/C,YAAY,GAAW,EAAE,OAAe;QACtC,KAAK,CAAC,yBAAyB,OAAO,UAAU,GAAG,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF;AAND,oCAMC;AAED;;;GAGG;AACH,MAAa,cAAe,SAAQ,eAAe;IAGxC;IAFT,YACE,GAAW,EACJ,UAAmB;QAE1B,KAAK,CACH,oBAAoB,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9E,CAAC;QAJK,eAAU,GAAV,UAAU,CAAS;QAK1B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAXD,wCAWC;AA2QD,4CAA0B"}

package/dist/Types/request.d.ts

@@ -132,5 +132,5 @@ export interface HttpClientOptions {
     timeout?: number;
     responseType?: ResponseType;
 }
-export type ResponseType = "json" | "text" | "buffer" | "xml";
+export type ResponseType = "json" | "text" | "buffer" | "xml" | "stream";
 //# sourceMappingURL=request.d.ts.map

package/dist/Types/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/Types/request.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IAEb,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB,gCAAgC;IAChC,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,cAAc,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,2BAA2B;IAC3B,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACzC,mCAAmC;IACnC,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACzC,kCAAkC;IAClC,UAAU,CAAC,IAAI,cAAc,CAAC;IAC9B,0BAA0B;IAC1B,UAAU,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAAC;IACvD,uCAAuC;IACvC,UAAU,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAAC;IACvD,mCAAmC;IACnC,QAAQ,CAAC,IAAI,YAAY,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAAC;IACjD,2BAA2B;IAC3B,QAAQ,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAAC;IACjD,sCAAsC;IACtC,gBAAgB,CAAC,IAAI,MAAM,CAAC;IAC5B,4BAA4B;IAC5B,WAAW,CAAC,IAAI,eAAe,CAAC;IAChC,8DAA8D;IAC9D,iBAAiB,CAAC,IAAI,MAAM,CAAC;IAC7B,wBAAwB;IACxB,WAAW,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAC1D,oCAAoC;IACpC,WAAW,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAAC;IAC1D,6BAA6B;IAC7B,MAAM,CAAC,IAAI,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,CAAC,IAAI,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,4BAA4B;IAC5B,SAAS,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAExD,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,gEAAgE;IAChE,MAAM,CAAC,EAAE,CACP,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,KACP,IAAI,CAAC;IAEV,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/Types/request.ts"],"names":[],"mappings":"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"}

package/dist/Types/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/Types/request.ts"],"names":[],"mappings":""}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/Types/request.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-export { HttpClientImproved, QueueManager, CacheManager, RateLimiter, Request, PreparedRequest, UrlExtractor, } from "./Hyperttp";
-export type * from "./Types";
+export { HttpClientImproved, QueueManager, CacheManager, RateLimiter, Request, PreparedRequest, UrlExtractor, } from "./Hyperttp/index.js";
+export type * from "./Types/index.js";
+export type * from "./Types/request.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,OAAO,EACP,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,OAAO,EACP,eAAe,EACf,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UrlExtractor = exports.PreparedRequest = exports.Request = exports.RateLimiter = exports.CacheManager = exports.QueueManager = exports.HttpClientImproved = void 0;
-var Hyperttp_1 = require("./Hyperttp");
-Object.defineProperty(exports, "HttpClientImproved", { enumerable: true, get: function () { return Hyperttp_1.HttpClientImproved; } });
-Object.defineProperty(exports, "QueueManager", { enumerable: true, get: function () { return Hyperttp_1.QueueManager; } });
-Object.defineProperty(exports, "CacheManager", { enumerable: true, get: function () { return Hyperttp_1.CacheManager; } });
-Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return Hyperttp_1.RateLimiter; } });
-Object.defineProperty(exports, "Request", { enumerable: true, get: function () { return Hyperttp_1.Request; } });
-Object.defineProperty(exports, "PreparedRequest", { enumerable: true, get: function () { return Hyperttp_1.PreparedRequest; } });
-Object.defineProperty(exports, "UrlExtractor", { enumerable: true, get: function () { return Hyperttp_1.UrlExtractor; } });
+var index_js_1 = require("./Hyperttp/index.js");
+Object.defineProperty(exports, "HttpClientImproved", { enumerable: true, get: function () { return index_js_1.HttpClientImproved; } });
+Object.defineProperty(exports, "QueueManager", { enumerable: true, get: function () { return index_js_1.QueueManager; } });
+Object.defineProperty(exports, "CacheManager", { enumerable: true, get: function () { return index_js_1.CacheManager; } });
+Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return index_js_1.RateLimiter; } });
+Object.defineProperty(exports, "Request", { enumerable: true, get: function () { return index_js_1.Request; } });
+Object.defineProperty(exports, "PreparedRequest", { enumerable: true, get: function () { return index_js_1.PreparedRequest; } });
+Object.defineProperty(exports, "UrlExtractor", { enumerable: true, get: function () { return index_js_1.UrlExtractor; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAQoB;AAPlB,8GAAA,kBAAkB,OAAA;AAClB,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AACZ,uGAAA,WAAW,OAAA;AACX,mGAAA,OAAO,OAAA;AACP,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,gDAQ6B;AAP3B,8GAAA,kBAAkB,OAAA;AAClB,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AACZ,uGAAA,WAAW,OAAA;AACX,mGAAA,OAAO,OAAA;AACP,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperttp",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A high-performance, universal HTTP client for Node.js with caching, retries, queueing, rate limiting, cookies and logging.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,10 +23,10 @@
     "logger"
   ],
   "dependencies": {
-    "undici": "^7.22.0",
-    "tough-cookie": "^6.0.0",
+    "undici": "^8.0.2",
+    "tough-cookie": "^6.0.1",
     "http-cookie-agent": "^7.0.3",
-    "fast-xml-parser": "^5.5.3",
-    "lru-cache": "^11.2.6"
+    "fast-xml-parser": "^5.5.10",
+    "lru-cache": "^11.3.0"
   }
 }