hyperttp 0.1.5

package/dist/Hyperttp/UrlExtractor.d.ts

@@ -0,0 +1,87 @@
+import { UrlExtractorInterface, UrlPattern } from "../Types";
+/**
+ * Universal URL Extractor
+ *
+ * Allows extraction of entity IDs (track, album, artist, playlist, etc.)
+ * from URLs of multiple platforms using configurable regex patterns.
+ *
+ * @example
+ * ```ts
+ * const extractor = new UrlExtractor();
+ *
+ * // Register Yandex Music patterns
+ * extractor.registerPlatform("yandex", [
+ *   { entity: "track", regex: /music\.yandex\.ru\/track\/(?<id>\d+)/, groupNames: ["id"] },
+ *   { entity: "album", regex: /music\.yandex\.ru\/album\/(?<id>\d+)/, groupNames: ["id"] },
+ *   { entity: "artist", regex: /music\.yandex\.ru\/artist\/(?<id>\d+)/, groupNames: ["id"] },
+ *   { entity: "playlist", regex: /music\.yandex\.ru\/users\/(?<user>[\w\d\-_\.]+)\/playlists\/(?<id>\d+)/, groupNames: ["id", "user"] },
+ *   { entity: "playlist", regex: /music\.yandex\.ru\/playlists?\/(?<uid>(?:ar\.)?[A-Za-z0-9\-]+)/, groupNames: ["uid"] },
+ * ]);
+ *
+ * // Extract track ID
+ * const trackId = extractor.extractId<number>(
+ *   "https://music.yandex.ru/track/25063569",
+ *   "track",
+ *   "yandex"
+ * ).id;
+ *
+ * // Extract playlist info
+ * const playlist = extractor.extractId<string | number>(
+ *   "https://music.yandex.ru/playlists/ar123456",
+ *   "playlist",
+ *   "yandex"
+ * );
+ * ```
+ */
+export default class UrlExtractor implements UrlExtractorInterface {
+    private patterns;
+    /**
+     * Register a platform with its URL patterns.
+     *
+     * Each pattern should specify:
+     * - `entity`: the type of entity this pattern extracts (e.g., "track", "album")
+     * - `regex`: a regular expression with named capture groups
+     * - `groupNames`: array of the named groups to extract from the regex
+     *
+     * @param platform - Platform name (e.g., "yandex", "spotify")
+     * @param patterns - Array of URL patterns for this platform
+     *
+     * @example
+     * ```ts
+     * extractor.registerPlatform("yandex", [
+     *   { entity: "track", regex: /music\.yandex\.ru\/track\/(?<id>\d+)/, groupNames: ["id"] }
+     * ]);
+     * ```
+     */
+    registerPlatform(platform: string, patterns: UrlPattern[]): void;
+    /**
+     * Extract named groups from a URL using a specific pattern
+     * @param url URL to extract from
+     * @param pattern UrlPattern containing regex and group names
+     * @throws Will throw if the URL does not match the pattern or required groups are missing
+     * @returns Object with extracted group values
+     */
+    private extractGroups;
+    /**
+     * Extract an entity ID from a URL.
+     *
+     * This method tries all registered patterns for the given entity and platform.
+     * The returned values are always strings. If you expect numeric IDs, you should
+     * convert them using `Number()`.
+     *
+     * @param url - URL to extract from
+     * @param entity - Entity type ("track", "album", "artist", "playlist", etc.)
+     * @param platform - Platform name registered with `registerPlatform`
+     * @throws Will throw if no matching pattern is found or extraction fails
+     * @returns Record<string, string> containing extracted values (keys depend on the pattern)
+     *
+     * @example
+     * ```ts
+     * const result = extractor.extractId('https://music.yandex.ru/track/25063569', 'track', 'yandex');
+     * console.log(result.id); // "25063569" (string)
+     * const numericId = Number(result.id); // 25063569
+     * ```
+     */
+    extractId<T extends string | number>(url: string, entity: string, platform: string, castNumbers?: boolean): Record<string, T>;
+}
+//# sourceMappingURL=UrlExtractor.d.ts.map

package/dist/Hyperttp/UrlExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlExtractor.d.ts","sourceRoot":"","sources":["../../src/Hyperttp/UrlExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,YAAW,qBAAqB;IAChE,OAAO,CAAC,QAAQ,CAAoC;IAEpD;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE;IAIzD;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAmBrB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,WAAW,UAAO,GACjB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;CAgCrB"}

package/dist/Hyperttp/UrlExtractor.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Universal URL Extractor
+ *
+ * Allows extraction of entity IDs (track, album, artist, playlist, etc.)
+ * from URLs of multiple platforms using configurable regex patterns.
+ *
+ * @example
+ * ```ts
+ * const extractor = new UrlExtractor();
+ *
+ * // Register Yandex Music patterns
+ * extractor.registerPlatform("yandex", [
+ *   { entity: "track", regex: /music\.yandex\.ru\/track\/(?<id>\d+)/, groupNames: ["id"] },
+ *   { entity: "album", regex: /music\.yandex\.ru\/album\/(?<id>\d+)/, groupNames: ["id"] },
+ *   { entity: "artist", regex: /music\.yandex\.ru\/artist\/(?<id>\d+)/, groupNames: ["id"] },
+ *   { entity: "playlist", regex: /music\.yandex\.ru\/users\/(?<user>[\w\d\-_\.]+)\/playlists\/(?<id>\d+)/, groupNames: ["id", "user"] },
+ *   { entity: "playlist", regex: /music\.yandex\.ru\/playlists?\/(?<uid>(?:ar\.)?[A-Za-z0-9\-]+)/, groupNames: ["uid"] },
+ * ]);
+ *
+ * // Extract track ID
+ * const trackId = extractor.extractId<number>(
+ *   "https://music.yandex.ru/track/25063569",
+ *   "track",
+ *   "yandex"
+ * ).id;
+ *
+ * // Extract playlist info
+ * const playlist = extractor.extractId<string | number>(
+ *   "https://music.yandex.ru/playlists/ar123456",
+ *   "playlist",
+ *   "yandex"
+ * );
+ * ```
+ */
+class UrlExtractor {
+    patterns = {};
+    /**
+     * Register a platform with its URL patterns.
+     *
+     * Each pattern should specify:
+     * - `entity`: the type of entity this pattern extracts (e.g., "track", "album")
+     * - `regex`: a regular expression with named capture groups
+     * - `groupNames`: array of the named groups to extract from the regex
+     *
+     * @param platform - Platform name (e.g., "yandex", "spotify")
+     * @param patterns - Array of URL patterns for this platform
+     *
+     * @example
+     * ```ts
+     * extractor.registerPlatform("yandex", [
+     *   { entity: "track", regex: /music\.yandex\.ru\/track\/(?<id>\d+)/, groupNames: ["id"] }
+     * ]);
+     * ```
+     */
+    registerPlatform(platform, patterns) {
+        this.patterns[platform] = patterns;
+    }
+    /**
+     * Extract named groups from a URL using a specific pattern
+     * @param url URL to extract from
+     * @param pattern UrlPattern containing regex and group names
+     * @throws Will throw if the URL does not match the pattern or required groups are missing
+     * @returns Object with extracted group values
+     */
+    extractGroups(url, pattern) {
+        const match = url.match(pattern.regex)?.groups;
+        if (!match)
+            throw new Error(`Invalid ${pattern.entity} URL: ${url}`);
+        return pattern.groupNames.reduce((acc, name) => {
+            const value = match[name];
+            if (!value)
+                throw new Error(`Missing "${name}" in ${pattern.entity} URL: ${url}`);
+            acc[name] = value;
+            return acc;
+        }, {});
+    }
+    /**
+     * Extract an entity ID from a URL.
+     *
+     * This method tries all registered patterns for the given entity and platform.
+     * The returned values are always strings. If you expect numeric IDs, you should
+     * convert them using `Number()`.
+     *
+     * @param url - URL to extract from
+     * @param entity - Entity type ("track", "album", "artist", "playlist", etc.)
+     * @param platform - Platform name registered with `registerPlatform`
+     * @throws Will throw if no matching pattern is found or extraction fails
+     * @returns Record<string, string> containing extracted values (keys depend on the pattern)
+     *
+     * @example
+     * ```ts
+     * const result = extractor.extractId('https://music.yandex.ru/track/25063569', 'track', 'yandex');
+     * console.log(result.id); // "25063569" (string)
+     * const numericId = Number(result.id); // 25063569
+     * ```
+     */
+    extractId(url, entity, platform, castNumbers = true) {
+        const patterns = this.patterns[platform]?.filter((p) => p.entity === entity);
+        if (!patterns?.length)
+            throw new Error(`No patterns registered for "${entity}" on platform "${platform}"`);
+        for (const pattern of patterns) {
+            try {
+                const extracted = this.extractGroups(url, pattern);
+                const result = {};
+                for (const key in extracted) {
+                    const value = extracted[key];
+                    // Если ожидаем число и включен castNumbers, конвертируем
+                    if (castNumbers && !isNaN(Number(value))) {
+                        result[key] = Number(value);
+                    }
+                    else {
+                        result[key] = value;
+                    }
+                }
+                return result;
+            }
+            catch {
+                // continue searching for a matching pattern
+            }
+        }
+        throw new Error(`Invalid ${entity} URL for platform "${platform}": ${url}`);
+    }
+}
+exports.default = UrlExtractor;
+//# sourceMappingURL=UrlExtractor.js.map

package/dist/Hyperttp/UrlExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlExtractor.js","sourceRoot":"","sources":["../../src/Hyperttp/UrlExtractor.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAqB,YAAY;IACvB,QAAQ,GAAiC,EAAE,CAAC;IAEpD;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CAAC,QAAgB,EAAE,QAAsB;QACvD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACK,aAAa,CACnB,GAAW,EACX,OAAsB;QAEtB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC;QAErE,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAC9B,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACZ,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK;gBACR,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,QAAQ,OAAO,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC;YACxE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAClB,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAAuB,CACxB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CACP,GAAW,EACX,MAAc,EACd,QAAgB,EAChB,WAAW,GAAG,IAAI;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAC3B,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,MAAM;YACnB,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,kBAAkB,QAAQ,GAAG,CACnE,CAAC;QAEJ,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAEnD,MAAM,MAAM,GAAwB,EAAE,CAAC;gBACvC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;oBAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;oBAC7B,yDAAyD;oBACzD,IAAI,WAAW,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;wBACzC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC9B,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;oBACtB,CAAC;gBACH,CAAC;gBAED,OAAO,MAA2B,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,sBAAsB,QAAQ,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF;AA5GD,+BA4GC"}

package/dist/Hyperttp/index.d.ts

@@ -0,0 +1,5 @@
+export { HttpClientImproved, QueueManager, CacheManager, RateLimiter, } from "./Core";
+export { default as Request } from "./Request";
+export { PreparedRequest } from "./Request";
+export { default as UrlExtractor } from "./UrlExtractor";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Hyperttp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/Hyperttp/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlExtractor = exports.PreparedRequest = exports.Request = exports.RateLimiter = exports.CacheManager = exports.QueueManager = exports.HttpClientImproved = void 0;
+var Core_1 = require("./Core");
+Object.defineProperty(exports, "HttpClientImproved", { enumerable: true, get: function () { return Core_1.HttpClientImproved; } });
+Object.defineProperty(exports, "QueueManager", { enumerable: true, get: function () { return Core_1.QueueManager; } });
+Object.defineProperty(exports, "CacheManager", { enumerable: true, get: function () { return Core_1.CacheManager; } });
+Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return Core_1.RateLimiter; } });
+var Request_1 = require("./Request");
+Object.defineProperty(exports, "Request", { enumerable: true, get: function () { return __importDefault(Request_1).default; } });
+var Request_2 = require("./Request");
+Object.defineProperty(exports, "PreparedRequest", { enumerable: true, get: function () { return Request_2.PreparedRequest; } });
+var UrlExtractor_1 = require("./UrlExtractor");
+Object.defineProperty(exports, "UrlExtractor", { enumerable: true, get: function () { return __importDefault(UrlExtractor_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/Hyperttp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Hyperttp/index.ts"],"names":[],"mappings":";;;;;;AAAA,+BAKgB;AAJd,0GAAA,kBAAkB,OAAA;AAClB,oGAAA,YAAY,OAAA;AACZ,oGAAA,YAAY,OAAA;AACZ,mGAAA,WAAW,OAAA;AAEb,qCAA+C;AAAtC,mHAAA,OAAO,OAAW;AAC3B,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,+CAAyD;AAAhD,6HAAA,OAAO,OAAgB"}

package/dist/Types/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Interface for a universal URL extractor
+ */
+export interface UrlExtractorInterface {
+    /**
+     * Register a platform with its URL patterns
+     * @param platform Platform name (e.g., "yandex", "spotify")
+     * @param patterns Array of URL patterns for the platform
+     */
+    registerPlatform(platform: string, patterns: UrlPattern[]): void;
+    /**
+     * Extract an entity ID or related info from a URL
+     * @param url URL to extract from
+     * @param entity Entity type ("track", "album", "artist", "playlist", etc.)
+     * @param platform Platform name that has been registered
+     * @returns Record of extracted values (keys depend on the pattern)
+     */
+    extractId<T extends string | number>(url: string, entity: string, platform: string): Record<string, T>;
+}
+/**
+ * Defines a URL extraction pattern for a platform
+ */
+export interface UrlPattern<T extends string = string> {
+    /** Entity type this pattern applies to (track, album, artist, playlist, etc.) */
+    entity: string;
+    /** Regex with named capturing groups to extract IDs or info */
+    regex: RegExp;
+    /** Names of the capturing groups to extract */
+    groupNames: T[];
+}
+export * from "./request";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/Types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./request"), exports);
+//# sourceMappingURL=index.js.map

package/dist/Types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAuCA,4CAA0B"}

package/dist/Types/request.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Represents HTTP request headers
+ */
+export type RequestHeaders = {
+    [key: string]: string;
+};
+/**
+ * Represents URL query parameters
+ */
+export type RequestQuery = {
+    [key: string]: string;
+};
+/**
+ * Represents body data for requests
+ */
+export type RequestBodyData = {
+    [key: string]: string;
+};
+/**
+ * Configuration for a request
+ */
+export type RequestConfig = {
+    /** Protocol scheme (http or https) */
+    scheme: string;
+    /** Hostname or IP address */
+    host: string;
+    /** Port number */
+    port: number;
+    /** Optional path after host */
+    path?: string;
+    /** Optional headers */
+    headers?: RequestHeaders;
+    /** Optional query parameters */
+    query?: RequestQuery;
+    /** Optional body data */
+    bodyData?: RequestBodyData;
+};
+/**
+ * HTTP method type
+ */
+export type Method = "get" | "post";
+/**
+ * Represents a generic object response
+ */
+export type ObjectResponse = {
+    [key: string]: any;
+};
+/**
+ * Represents a plain string response
+ */
+export type StringResponse = string;
+/**
+ * Represents either an object or string response
+ */
+export type Response = ObjectResponse | StringResponse;
+/**
+ * Interface for a request object
+ */
+export interface RequestInterface {
+    /** Set the request path */
+    setPath(path: string): RequestInterface;
+    /** Set the host for the request */
+    setHost(host: string): RequestInterface;
+    /** Get current request headers */
+    getHeaders(): RequestHeaders;
+    /** Replace all headers */
+    setHeaders(headers: RequestHeaders): RequestInterface;
+    /** Add headers to the existing ones */
+    addHeaders(headers: RequestHeaders): RequestInterface;
+    /** Get current query parameters */
+    getQuery(): RequestQuery;
+    /** Replace all query parameters */
+    setQuery(query: RequestQuery): RequestInterface;
+    /** Add query parameters */
+    addQuery(query: RequestQuery): RequestInterface;
+    /** Get query string representation */
+    getQueryAsString(): string;
+    /** Get request body data */
+    getBodyData(): RequestBodyData;
+    /** Get body data as string (e.g., for JSON or URL-encoded) */
+    getBodyDataString(): string;
+    /** Replace body data */
+    setBodyData(bodyData: RequestBodyData): RequestInterface;
+    /** Add data to the existing body */
+    addBodyData(bodyData: RequestBodyData): RequestInterface;
+    /** Get URI (path + query) */
+    getURI(): string;
+    /** Get full URL including scheme, host, port, path and query */
+    getURL(): string;
+}
+/**
+ * Interface for a HTTP client
+ */
+export interface HttpClientInterface {
+    /**
+     * Send a GET request
+     * @param request Request object
+     * @returns Response object or string
+     */
+    get(request: RequestInterface): Promise<Response>;
+    /**
+     * Send a POST request
+     * @param request Request object
+     * @returns Response object or string
+     */
+    post(request: RequestInterface): Promise<Response>;
+}
+/**
+ * Options to configure HttpClient
+ */
+export interface HttpClientOptions {
+    /** Maximum number of concurrent requests */
+    maxConcurrent?: number;
+    /** Rate limiting options */
+    rateLimit?: {
+        maxRequests?: number;
+        windowMs?: number;
+    };
+    /** Maximum number of retry attempts */
+    maxRetries?: number;
+    /** Cache time-to-live in milliseconds */
+    cacheTTL?: number;
+    /** Maximum number of cached items */
+    cacheMaxSize?: number;
+    /** Logger function to capture debug/info/warn/error messages */
+    logger?: (level: "debug" | "info" | "warn" | "error", msg: string, meta?: any) => void;
+    /** User-Agent string to send with requests */
+    userAgent?: string;
+    /** Follow HTTP redirects (default true) */
+    followRedirects?: boolean;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    responseType?: ResponseType;
+}
+export type ResponseType = "json" | "text" | "buffer" | "xml";
+//# sourceMappingURL=request.d.ts.map

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

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

package/dist/Types/request.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=request.js.map

package/dist/Types/request.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +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; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "hyperttp",
+  "version": "0.1.5",
+  "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",
+  "author": "dirold2",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dirold2/hyperttp.git"
+  },
+  "keywords": [
+    "http",
+    "client",
+    "fetch",
+    "undici",
+    "cache",
+    "rate-limit",
+    "queue",
+    "retry",
+    "cookies",
+    "logger"
+  ],
+  "dependencies": {
+    "undici": "^7.16.0",
+    "tough-cookie": "^6.0.0",
+    "http-cookie-agent": "^7.0.3",
+    "fast-xml-parser": "^5.3.3",
+    "lru-cache": "^11.2.4"
+  }
+}