@hyperttp/cache 1.1.0 → 1.1.5

package/README.md

@@ -1,6 +1,6 @@
 # hyperttp-cache
 
-> English | [Русский](https://github.com/IT-IF-OR/hyperttp-cache/tree/main/lang/ru)
+> [Русский](https://github.com/IT-IF-OR/hyperttp-cache/tree/main/lang/ru) | English
 
 ---
 
@@ -11,45 +11,45 @@
 
 ---
 
-Сверхбыстрый, изоморфный плагин кэширования и дедупликации параллельных запросов для высокопроизводительного
-HTTP-клиента `Hyperttp`. Оптимизирован для рантаймов **Bun** и **Node.js**.
+Blazing fast, isomorphic cache management and concurrent request deduplication plugin for the high-performance
+`Hyperttp` HTTP client. Optimized for **Bun** and **Node.js** runtimes.
 
-Плагин бесшовно встраивается в плоский конвейер жизненного цикла `HyperCore`, защищая сервер от лавинообразной
-нагрузки (**Cache Stampede Protection**) и предоставляя умное in-memory хранилище на базе стратегии
-**LRU (Least Recently Used)**.
+The plugin seamlessly integrates into the flat `HyperCore` lifecycle pipeline, protecting your backend from server
+breakdown (**Cache Stampede Protection**) and providing smart in-memory storage based on the **LRU (Least Recently Used)**
+strategy.
 
 ---
 
-## 🔥 Ключевые фичи
+## 🔥 Key Features
 
-- 🧠 **LRU-стратегия с поддержкой TTL:** Автоматическое вытеснение старых записей при достижении лимита. При каждом
-  `GET`-запросе возраст записи сбрасывается (`updateAgeOnGet: true`), удерживая горячие данные в памяти.
-- 🚀 **In-Flight Deduplication:** Веерные параллельные запросы на один и тот же URL группируются в один сетевой
-  hot path. Ответ клонируется и раздается всем подписчикам одновременно.
-- 🔄 **HTTP Revalidation:** Полная поддержка проверок свежести по `ETag` (`If-None-Match`) и `Last-Modified`
-  (`If-Modified-Since`). Автоматически гидрирует пустые `304` ответы актуальным телом из памяти.
-- 🛡️ **Безопасность при сбоях:** При возникновении сетевых ошибок пул ожидания мгновенно разрывается (`onError`),
-  разблокируя повторные попытки запросов.
-- 📊 **Расширение Ядра:** Автоматически инжектирует методы управления кэшем (`clearCache`) и добавляет метрику
-  `cacheSize` в системную статистику `getStats()`.
+- 🧠 **LRU Strategy with TTL Support:** Automatically evicts old entries when reaching limits. With every `GET`
+  request, the entry age resets (`updateAgeOnGet: true`), keeping hot data cached in memory.
+- 🚀 **In-Flight Deduplication:** Concurrent fan-out requests targeting the same URL are grouped into a single network
+  hot path. The response is cloned and distributed to all waiting subscribers simultaneously.
+- 🔄 **HTTP Revalidation:** Full freshness verification support via `ETag` (`If-None-Match`) and `Last-Modified`
+  (`If-Modified-Since`). Automatically re-hydrates empty `304` responses with cached data bodies.
+- 🛡️ **Fail-Safe Processing:** When network processing exceptions occur, the in-flight waiting pool is instantly
+  purged (`onError`), unblocking immediate subsequent retry attempts.
+- 📊 **Core Extension:** Automatically injects cache management methods (`clearCache`) and appends a `cacheSize`
+  telemetry metric into the core `getStats()` architecture.
 
 ---
 
-## 📦 Установка
+## 📦 Installation
 
 ```bash
 bun add hyperttp-cache
-# или
+# or
 npm install hyperttp-cache
 
 ```
 
 ---
 
-## 🚀 Быстрый старт
+## 🚀 Quick Start
 
-Просто импортируйте фабрику `withCache` и передайте её в массив плагинов вашего клиента. Настройки кэша
-передаются в глобальный конфиг.
+Simply import the `withCache` factory and append it to your client's plugin array. Cache configurations are
+passed directly within the global options block.
 
 ```typescript
 import { createClient } from "@hyperttp/core";
@@ -59,75 +59,79 @@ const client = createClient({
   plugins: [withCache()],
   cache: {
     enabled: true,
-    ttl: 60_000, // 1 минута (по умолчанию 300_000 мс)
-    maxSize: 1000, // Лимит в 1000 элементов (по умолчанию 500)
-    methods: ["GET"], // HTTP-методы, разрешенные для кэширования
+    ttl: 60_000,       // 1 minute (defaults to 300_000 ms)
+    maxSize: 1000,    // Limit to 1000 items (defaults to 500)
+    methods: ["GET"], // HTTP methods authorized for downstream caching
   },
 });
 
-// 1. Первый запрос уходит в сеть и наполняет кэш
+// 1. The first request goes out to the network and populates the cache
 const res1 = await client.get("/api/data");
 
-// 2. Второй последующий запрос вернет изолированный клон из кэша
+// 2. Subsequent requests instantly return an isolated clone from the cache
 const res2 = await client.get("/api/data");
+
 ```
 
 ---
 
-## ⚙️ Параметры конфигурации (`CacheManagerOptions`)
+## ⚙️ Configuration Options (`CacheManagerOptions`)
 
-Конфигурация плагина полностью типизирована и расширяет интерфейс настроек клиента:
+The plugin configuration layer is fully typed and extends the default client option interfaces:
 
-| Параметр        | Тип        | По умолчанию      | Описание                                                         |
-| --------------- | ---------- | ----------------- | ---------------------------------------------------------------- |
-| `cache.enabled` | `boolean`  | `false`           | Флаг активации/деактивации слоя кэширования.                     |
-| `cache.ttl`     | `number`   | `300_000` (5 мин) | Время жизни записи в кэше (в миллисекундах).                     |
-| `cache.maxSize` | `number`   | `500`             | Максимальное количество записей в LRU-кэше до начала вытеснения. |
-| `cache.methods` | `Method[]` | `["GET"]`         | Массив HTTP-методов, для которых разрешено кэширование ответов.  |
+| Parameter | Type | Default | Description |
+| --- | --- | --- | --- |
+| `cache.enabled` | `boolean` | `false` | Activation status flag for the caching layer. |
+| `cache.ttl` | `number` | `300_000` (5 min) | Cache entry time-to-live threshold (in milliseconds). |
+| `cache.maxSize` | `number` | `500` | Maximum entries allowed inside the LRU pool before eviction begins. |
+| `cache.methods` | `Method[]` | `["GET"]` | Array of HTTP methods authorized for response interception. |
 
 ---
 
-## 🛠️ API Расширения Ядра
+## 🛠️ Core API Extensions
 
-Плагин расширяет глобальные интерфейсы декларации типов `@hyperttp/types`. Вам становятся доступны следующие
-методы прямо из инстанса ядра:
+The plugin extends the global `@hyperttp/types` interface declarations. The following lifecycle methods become
+directly accessible via the client core instance:
 
-### Очистка кэша
+### Purging Cache
 
 ```typescript
-// Очистить кэш полностью
+// Purge the entire cache system
 client.clearCache();
 
-// Удалить конкретный URL из кэша
+// Evict a specific URL key from the storage
 client.clearCache("/api/data");
+
 ```
 
-### Телеметрия
+### Telemetry
 
-Если ваше ядро поддерживает метод `getStats()`, плагин автоматически подмешает туда текущий размер кэша:
+If your core implementation supports the `getStats()` routine, the plugin automatically appends the current cache size:
 
 ```typescript
 const stats = client.getStats();
-console.log(stats.cacheSize); // Выведет текущее количество записей в LRU-хранилище
+console.log(stats.cacheSize); // Outputs the current number of active entries inside the LRU storage
+
 ```
 
 ---
 
-## 📐 Архитектура жизненного цикла
+## 📐 Lifecycle Architecture
 
-Плагин использует атомарные независимые хуки вместо тяжелых middleware-оберток:
+The plugin utilizes atomic, decoupled lifecycle hooks instead of overhead-heavy middleware wrappers:
 
-1. **`onRequest`**: Проверяет наличие точного совпадения в `CacheManager`. Если запись свежая и не требует
-   проверки сервера — возвращает её клон, завершая цепочку. Если идет активный запрос к этому же URL — подписывается
-   на его `Promise`. Если запись требует валидации, подмешает заголовки `If-None-Match` / `If-Modified-Since`.
-2. **`onResponse`**: Перехватывает успешные ответы. Превращает пустой `304 Not Modified` обратно в полноценный
-   `200 OK`, восстанавливая данные из локальной памяти. Записывает новые `200` ответы с валидными ETag. Разрешает
-   (resolves) ожидания всех `In-Flight` подписчиков.
-3. **`onError`**: В случае сетевого сбоя вычищает карту активных задач, чтобы не заблокировать последующие
-   повторные вызовы к упавшему эндпоинту.
+1. **`onRequest`**: Evaluates local key hits inside the `CacheManager`. If the matching record is fresh and doesn't
+require validation, it returns a clone, short-circuiting the chain. If a concurrent request to the same URL is active,
+it hooks into its matching follower `Promise`. If a partial hit requires validation, it appends conditional headers
+(`If-None-Match` / `If-Modified-Since`).
+2. **`onResponse`**: Intercepts successful downstream outputs. Re-hydrates an empty `304 Not Modified` status code
+back into a full `200 OK` response by recovering body content from memory. Saves valid `200` ranges containing validation
+metadata and resolves execution triggers for all waiting `In-Flight` threads.
+3. **`onError`**: In the event of a critical network failure, it instantly flushes matching active tracking task entries
+from the map to ensure subsequent retries targeting the failed endpoint are never deadlocked.
 
 ---
 
-## 📄 Лицензия
+## 📄 License
 
 MIT

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@hyperttp/cache",
-  "version": "1.1.0",
+  "version": "1.1.5",
   "description": "High-performance LRU caching plugin for Hyperttp client",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "keywords": [
     "hyperttp"
   ],
@@ -14,12 +22,8 @@
     "type": "git",
     "url": "git+https://github.com/IT-IF-OR/hyperttp-cache.git"
   },
-  "dependencies": {
-    "@hyperttp/types": "^0.1.1",
-    "lru-cache": "^11.5.1"
-  },
   "peerDependencies": {
-    "@hyperttp/core": "^1.2.0"
+    "@hyperttp/types": "^0.1.5"
   },
   "private": false
 }

package/plugin.d.ts

@@ -1,24 +1,64 @@
 import type { HyperPlugin } from "@hyperttp/types";
-import type { CacheManagerOptions } from "./types/cache.js";
+import type { CacheManagerOptions, LightweightResponse } from "./types/cache.js";
 import { CacheManager } from "./utils/CacheManager.js";
+/**
+ * @en Extends the PluginContext to include the cache manager instance.
+ * @ru Расширяет PluginContext, добавляя экземпляр менеджера кэша.
+ */
 declare module "@hyperttp/types" {
     interface PluginContext {
-        cache?: CacheManager;
+        /**
+         * @en The active cache manager instance.
+         * @ru Активный экземпляр менеджера кэша.
+         */
+        cache?: CacheManager<LightweightResponse>;
     }
+    /**
+     * @en Extends HyperttpPluginsExtension to include cache configuration options.
+     * @ru Расширяет HyperttpPluginsExtension, добавляя опции конфигурации кэша.
+     */
     interface HyperttpPluginsExtension {
+        /**
+         * @en Cache configuration and enablement flags.
+         * @ru Конфигурация кэша и флаги включения.
+         */
         cache?: CacheManagerOptions & {
+            /**
+             * @en Enables or disables the caching plugin.
+             * @ru Включает или отключает плагин кэширования.
+             */
             enabled: boolean;
+            /**
+             * @en List of HTTP methods allowed for caching (e.g., ["GET"]).
+             * @ru Список HTTP-методов, разрешенных для кэширования (например, ["GET"]).
+             */
+            methods?: string[];
         };
     }
+    /**
+     * @en Extends IHyperCore with cache management methods.
+     * @ru Расширяет IHyperCore методами управления кэшем.
+     */
     interface IHyperCore {
+        /**
+         * @en Clears the cache. If a key is provided, only that entry is removed.
+         * @ru Очищает кэш. Если указан ключ, удаляется только соответствующая запись.
+         * @param key - Optional cache key to delete.
+         */
         clearCache(key?: string): void;
+        /**
+         * @en Returns runtime statistics, including cache size.
+         * @ru Возвращает статистику выполнения, включая размер кэша.
+         */
         getStats?(): Record<string, any>;
     }
 }
 /**
- * @ru Фабрика плагина кэширования и дедупликации конкурентных запросов для HyperCore.
- * @en Cache management and concurrent request deduplication plugin factory for HyperCore.
- * @returns Модуль расширения ядра в рамках линейного жизненного цикла. / Configured extension plugin container.
+ * @en Creates a caching plugin for Hyperttp.
+ * Handles in-memory caching, conditional requests (ETag/Last-Modified), and request deduplication.
+ * @ru Создает плагин кэширования для Hyperttp.
+ * Обрабатывает кэширование в памяти, условные запросы (ETag/Last-Modified) и дедупликацию запросов.
+ * @returns The configured HyperPlugin instance.
  */
 export declare function withCache(): HyperPlugin;
 //# sourceMappingURL=plugin.d.ts.map

package/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EAKZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,aAAa;QACrB,KAAK,CAAC,EAAE,YAAY,CAAC;KACtB;IACD,UAAU,wBAAwB;QAChC,KAAK,CAAC,EAAE,mBAAmB,GAAG;YAC5B,OAAO,EAAE,OAAO,CAAC;SAClB,CAAC;KACH;IACD,UAAU,UAAU;QAClB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC;CACF;AAaD;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,WAAW,CA+LvC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EAIZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;GAGG;AACH,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,aAAa;QACrB;;;WAGG;QACH,KAAK,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;KAC3C;IAED;;;OAGG;IACH,UAAU,wBAAwB;QAChC;;;WAGG;QACH,KAAK,CAAC,EAAE,mBAAmB,GAAG;YAC5B;;;eAGG;YACH,OAAO,EAAE,OAAO,CAAC;YACjB;;;eAGG;YACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC;KACH;IAED;;;OAGG;IACH,UAAU,UAAU;QAClB;;;;WAIG;QACH,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE/B;;;WAGG;QACH,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC;CACF;AA0BD;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,WAAW,CAyKvC"}

package/plugin.js

@@ -1,92 +1,76 @@
 import { CacheManager } from "./utils/CacheManager.js";
 /**
- * @ru Фабрика плагина кэширования и дедупликации конкурентных запросов для HyperCore.
- * @en Cache management and concurrent request deduplication plugin factory for HyperCore.
- * @returns Модуль расширения ядра в рамках линейного жизненного цикла. / Configured extension plugin container.
+ * @en Helper function to create a standardized HttpResponse object from lightweight data.
+ * @ru Вспомогательная функция для создания стандартизированного объекта HttpResponse из легких данных.
+ * @param data - The lightweight response data.
+ * @returns A full HttpResponse object.
+ */
+const createHttpResponse = (data) => ({
+    status: data.status,
+    headers: data.headers,
+    body: data.body,
+    url: data.url,
+    clone: () => createHttpResponse(data),
+});
+/**
+ * @en Creates a caching plugin for Hyperttp.
+ * Handles in-memory caching, conditional requests (ETag/Last-Modified), and request deduplication.
+ * @ru Создает плагин кэширования для Hyperttp.
+ * Обрабатывает кэширование в памяти, условные запросы (ETag/Last-Modified) и дедупликацию запросов.
+ * @returns The configured HyperPlugin instance.
  */
 export function withCache() {
-    /**
-     * @private
-     * @ru Изолированный инстанс менеджера кэша для текущего клиента.
-     * @en Isolated cache manager orchestration instance allocated for the target client.
-     */
     let cache;
-    /**
-     * @private
-     * @ru Список HTTP-методов, для которых разрешено кэширование ответов.
-     * @en Set of HTTP request methods authorized for downstream response caching.
-     */
-    let allowedMethods;
-    /**
-     * @private
-     * @ru Карта активных сетевых запросов для предотвращения каскадного заваливания бэкенда (Cache Stampede).
-     * @en Registry of concurrent requests in execution to prevent backend server breakdown (Cache Stampede).
-     */
+    let allowedMethods = new Set();
     const inFlight = new Map();
     return {
         name: "hyperttp-cache",
-        /**
-         * @ru Динамическая проверка необходимости активации кэширования на основе переданных опций.
-         * @en Dynamic check evaluating if the caching plugin layer should be appended based on client runtime options.
-         * @param config - Глобальная конфигурация инстанса клиента. / Global active client lifecycle options.
-         * @returns Индикатор необходимости сборки плагина. / Lifecycle activation indicator status.
-         */
         enabled: (config) => {
             return !!config.cache?.enabled;
         },
-        /**
-         * @ru Однократный хук инициализации. Настраивает менеджер кэша и внедряет методы отладки/очистки в ядро.
-         * @en One-time setup context hook. Orchestrates the cache manager and extends telemetry/purge interfaces inside the core.
-         * @param ctx - Общий контекст окружения плагина. / Shared plugin execution context metadata.
-         */
         setup(ctx) {
-            const { core, config } = ctx;
+            const core = ctx.core;
+            const config = ctx.config;
             cache = new CacheManager(config?.cache);
             ctx.cache = cache;
             const methods = config?.cache?.methods ?? ["GET"];
             allowedMethods = new Set(methods.map((m) => m.toUpperCase()));
             if (core && typeof core.getStats === "function") {
-                const originalGetStats = core.getStats;
+                const originalGetStats = core.getStats.bind(core);
                 core.getStats = function () {
-                    const stats = originalGetStats.call(this);
-                    if (stats) {
-                        stats.cacheSize = cache.size;
-                    }
-                    return stats;
+                    const stats = originalGetStats();
+                    return {
+                        ...stats,
+                        cacheSize: cache.size,
+                    };
                 };
             }
             core.clearCache = (key) => {
-                return key ? cache.delete(key) : cache.clear();
+                if (key) {
+                    cache.delete(key);
+                }
+                else {
+                    cache.clear();
+                }
             };
         },
-        /**
-         * @ru Перехватчик фазы отправки запроса. Проверяет локальные кэш-хиты и координирует пулинг конкурентных задач.
-         * @en Request phase interceptor. Evaluates local cache hits, appends conditional headers, or hooks into active in-flight targets.
-         * @param req - Сконфигурированный внутренний объект запроса. / Contextual internal request parameters.
-         * @param ctx - Общий контекст окружения плагина. / Shared plugin execution context metadata.
-         * @returns Мгновенный изолированный ответ из кэша, обертку гонки или void для продолжения сетевого цикла. / Short-circuit response clone, matching follower promise tracker, or void execution.
-         */
-        onRequest(req, 
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        _ctx) {
-            const method = req.method.toUpperCase();
-            if (!allowedMethods.has(method)) {
+        onRequest(req) {
+            if (!allowedMethods.has(req.method.toUpperCase())) {
                 return;
             }
             const cacheKey = req.url;
             const cachedEntry = cache.getWithMetadata(cacheKey);
-            if (cachedEntry !== undefined &&
-                !cachedEntry.etag &&
-                !cachedEntry.lastModified) {
-                return cachedEntry.data.clone();
+            if (cachedEntry && !cachedEntry.etag && !cachedEntry.lastModified) {
+                return createHttpResponse(cachedEntry.data);
             }
-            // Частичный кэш-хит, подмешиваем заголовки проверки свежести
-            if (cachedEntry !== undefined) {
+            if (cachedEntry) {
                 req.headers = { ...req.headers };
-                if (cachedEntry.etag)
+                if (cachedEntry.etag) {
                     req.headers["if-none-match"] = cachedEntry.etag;
-                if (cachedEntry.lastModified)
+                }
+                if (cachedEntry.lastModified) {
                     req.headers["if-modified-since"] = cachedEntry.lastModified;
+                }
             }
             const currentInFlight = inFlight.get(cacheKey);
             if (currentInFlight) {
@@ -94,62 +78,78 @@ export function withCache() {
             }
             let resolveFn;
             let rejectFn;
-            const promise = new Promise((res, rej) => {
-                resolveFn = res;
-                rejectFn = rej;
+            const promise = new Promise((resolve, reject) => {
+                resolveFn = resolve;
+                rejectFn = reject;
             });
-            promise.catch(() => { });
-            inFlight.set(cacheKey, { promise, resolve: resolveFn, reject: rejectFn });
+            const trigger = {
+                promise,
+                resolve: resolveFn,
+                reject: (err) => {
+                    inFlight.delete(cacheKey);
+                    rejectFn(err);
+                },
+            };
+            inFlight.set(cacheKey, trigger);
+            setTimeout(() => {
+                if (inFlight.has(cacheKey)) {
+                    console.warn(`[Cache] Warning: Request hung for ${cacheKey}, forcing cleanup`);
+                    trigger.reject(new Error("Request timed out in cache plugin"));
+                }
+            }, 30_000);
+            return;
         },
-        /**
-         * @ru Перехватчик фазы получения ответа. Обновляет хранилище или трансформирует статус 304 в полные данные из кэша.
-         * @en Response phase interceptor. Saves raw outputs to the storage layer or re-hydrates empty 304 responses with cached data bodies.
-         */
-        onResponse(res, req, 
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        _ctx) {
+        onResponse(res, req) {
+            if (!req)
+                return;
             const cacheKey = req.url;
             const trigger = inFlight.get(cacheKey);
-            if (!trigger) {
+            if (!trigger)
                 return;
-            }
             inFlight.delete(cacheKey);
-            const cachedEntry = cache.getWithMetadata(cacheKey);
-            if (res.status === 304 && cachedEntry !== undefined) {
-                const clonedCache = cachedEntry.data.clone();
-                Object.assign(res, clonedCache);
-                res.status = clonedCache.status ?? 200;
-                trigger.resolve(clonedCache);
-                return;
+            if (res.status === 304) {
+                const cachedEntry = cache.getWithMetadata(cacheKey);
+                if (cachedEntry) {
+                    const cachedData = cachedEntry.data;
+                    const restoredRes = {
+                        status: cachedData.status,
+                        headers: cachedData.headers,
+                        body: cachedData.body,
+                        url: cachedData.url,
+                        clone: () => createHttpResponse(cachedData),
+                    };
+                    trigger.resolve(restoredRes);
+                    return;
+                }
+                else {
+                    console.warn(`[Cache] Received 304 for ${cacheKey} but no cache entry found.`);
+                }
             }
             if (res.status >= 200 && res.status < 300) {
-                const valueToCache = res.clone();
-                const headers = res.headers;
-                const etag = headers?.["etag"] || headers?.["ETag"];
-                const lastModified = headers?.["last-modified"] || headers?.["Last-Modified"];
-                cache.setWithMetadata(cacheKey, valueToCache, {
-                    etag: typeof etag === "string" ? etag : undefined,
-                    lastModified: typeof lastModified === "string" ? lastModified : undefined,
+                const headers = res.headers || {};
+                const lightResponse = {
+                    body: res.body,
+                    status: res.status,
+                    headers: res.headers,
+                    url: res.url,
+                };
+                cache.setWithMetadata(cacheKey, lightResponse, {
+                    etag: Array.isArray(headers["etag"])
+                        ? headers["etag"][0]
+                        : headers["etag"],
+                    lastModified: Array.isArray(headers["last-modified"])
+                        ? headers["last-modified"][0]
+                        : headers["last-modified"],
                 });
-                trigger.resolve(res.clone());
-                return;
             }
             trigger.resolve(res.clone());
         },
-        /**
-         * @ru Перехватчик фазы критических сбоев. Разрывает пул ожидания дедупликации, транслируя ошибку всем подписчикам.
-         * @en Error phase interceptor. Purges matching metadata maps and forwards pipeline processing exceptions to all waiting threads.
-         * @param err - Специфичный объект ошибки сетевого клиента. / Normalized client-level error framework tracking details.
-         * @param req - Сконфигурированный внутренний объект запроса. / Contextual internal request parameters.
-         * @param ctx - Общий контекст окружения плагина. / Shared plugin execution context metadata.
-         */
-        onError(err, req, 
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        _ctx) {
-            const cacheKey = req.url;
-            const trigger = inFlight.get(cacheKey);
+        onError(err, req) {
+            if (!req)
+                return;
+            const trigger = inFlight.get(req.url);
             if (trigger) {
-                inFlight.delete(cacheKey);
+                inFlight.delete(req.url);
                 trigger.reject(err);
             }
         },

package/plugin.js.map

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

package/types/cache.d.ts

@@ -1,29 +1,81 @@
 import { Method } from "@hyperttp/types";
+/**
+ * @en Structure representing a cached item with optional HTTP validation metadata.
+ * @ru Структура, представляющая элемент кэша с опциональными метаданными для HTTP-валидации.
+ * @template T - Type of the cached data.
+ */
 export interface CacheEntry<T> {
+    /**
+     * @en The cached data payload.
+     * @ru Сохраненные данные.
+     */
     data: T;
+    /**
+     * @en HTTP ETag header value for conditional requests.
+     * @ru Значение заголовка HTTP ETag для условных запросов.
+     */
     etag?: string;
+    /**
+     * @en HTTP Last-Modified header value for conditional requests.
+     * @ru Значение заголовка HTTP Last-Modified для условных запросов.
+     */
     lastModified?: string;
 }
+/**
+ * @en Configuration options for the CacheManager.
+ * @ru Конфигурационные опции для CacheManager.
+ */
 export interface CacheManagerOptions {
     /**
-     * @ru Включить кэш
-     * @en Enable cache
+     * @en Enable cache functionality.
+     * @ru Включить кэш.
      */
     enabled?: boolean;
     /**
-     * @ru Время жизни кэша (мс)
-     * @en Cache time-to-live in milliseconds
+     * @en Cache time-to-live in milliseconds.
+     * @ru Время жизни кэша (мс).
      */
     ttl?: number;
     /**
-     * @ru Максимальный размер кэша
-     * @en Maximum cache size
+     * @en Maximum number of entries in the cache.
+     * @ru Максимальный размер кэша.
      */
     maxSize?: number;
     /**
-     * @ru HTTP методы, которые можно кэшировать
-     * @en HTTP methods allowed to be cached
+     * @en HTTP methods allowed to be cached.
+     * @ru HTTP методы, которые можно кэшировать.
      */
     methods?: readonly Method[];
+    /**
+     * @en Update the expiration time when an entry is accessed.
+     * @ru Обновлять время истечения при доступе к записи.
+     */
+    updateAgeOnGet?: boolean;
+}
+/**
+ * @en A simplified response object used for efficient cache storage.
+ * @ru Упрощенный объект ответа, используемый для эффективного хранения в кэше.
+ */
+export interface LightweightResponse<T = unknown> {
+    /**
+     * @en The response body content.
+     * @ru Содержимое тела ответа.
+     */
+    body: T;
+    /**
+     * @en The HTTP status code.
+     * @ru HTTP-код статуса.
+     */
+    status: number;
+    /**
+     * @en The response headers.
+     * @ru Заголовки ответа.
+     */
+    headers: Record<string, string | string[]>;
+    /**
+     * @en The final URL of the response.
+     * @ru Финальный URL ответа.
+     */
+    url: string;
 }
 //# sourceMappingURL=cache.d.ts.map

package/types/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/types/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/types/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAE3C;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;CACb"}

package/utils/CacheManager.d.ts

@@ -1,78 +1,71 @@
 import type { CacheEntry, CacheManagerOptions } from "../types/cache.ts";
 /**
- * @class CacheManager
- * @en High-performance in-memory cache based on LRU strategy.
- * Provides TTL support, metadata storage (etag, lastModified) and fast key-value access.
+ * @en High-performance inline in-memory cache with no external dependencies.
+ * Uses native Map and lazy invalidation to ensure maximum RPS.
+ * @ru Высокопроизводительный инлайновый in-memory кэш без внешних зависимостей.
+ * Использует нативный Map и ленивую инвалидацию для обеспечения максимального RPS.
  *
- * @ru Высокопроизводительный in-memory кэш на основе LRU стратегии.
- * Поддерживает TTL, хранение метаданных (etag, lastModified) и быстрый доступ по ключу.
+ * @template T - Type of the data stored in the cache. Defaults to unknown.
  */
-export declare class CacheManager {
-    private readonly cache;
+export declare class CacheManager<T = unknown> {
+    private readonly storage;
+    private readonly maxSize;
+    private readonly ttl;
+    private readonly updateAgeOnGet;
     constructor(options?: CacheManagerOptions);
     /**
-     * @en Retrieves cached value by key.
+     * @en Retrieves a value from the cache by key.
      * @ru Получает значение из кэша по ключу.
-     *
-     * @template T
-     * @param key Cache key
-     * @returns Cached value or undefined if not found
+     * @param key - The cache key.
+     * @returns The cached value or undefined if not found or expired.
      */
-    get<T>(key: string): T | undefined;
+    get(key: string): T | undefined;
     /**
-     * @en Stores value in cache.
+     * @en Stores a value in the cache.
      * @ru Сохраняет значение в кэш.
-     *
-     * @template T
-     * @param key Cache key
-     * @param value Value to store
+     * @param key - The cache key.
+     * @param value - The data to store.
      */
-    set<T>(key: string, value: T): void;
+    set(key: string, value: T): void;
     /**
-     * @en Retrieves cached entry with metadata (etag, lastModified).
+     * @en Retrieves a cache entry along with its metadata (etag, lastModified).
      * @ru Получает запись кэша вместе с метаданными (etag, lastModified).
-     *
-     * @template T
-     * @param key Cache key
-     * @returns Cached entry with metadata or undefined
+     * @param key - The cache key.
+     * @returns The cache entry with metadata or undefined if not found or expired.
      */
-    getWithMetadata<T>(key: string): CacheEntry<T> | undefined;
+    getWithMetadata(key: string): CacheEntry<T> | 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
+     * @en Stores a value with additional HTTP metadata.
+     * @ru Сохраняет значение с дополнительными HTTP метаданными.
+     * @param key - The cache key.
+     * @param data - The response data to store.
+     * @param meta - Optional HTTP metadata (etag, lastModified).
      */
-    setWithMetadata<T>(key: string, data: T, meta?: {
+    setWithMetadata(key: string, data: T, meta?: {
         etag?: string;
         lastModified?: string;
     }): void;
     /**
-     * @en Checks if key exists in cache.
-     * @ru Проверяет наличие ключа в кэше.
-     *
-     * @param key Cache key
-     * @returns true if exists, otherwise false
+     * @en Checks for the existence of a key in the cache without updating its TTL.
+     * @ru Проверяет наличие ключа в кэше без обновления его времени жизни.
+     * @param key - The cache key.
+     * @returns True if the key exists and is not expired.
      */
     has(key: string): boolean;
     /**
-     * @en Deletes value from cache by key.
+     * @en Removes a value from the cache by key.
      * @ru Удаляет значение из кэша по ключу.
-     *
-     * @param key Cache key
-     * @returns true if value was removed
+     * @param key - The cache key.
+     * @returns True if the element was removed, false otherwise.
      */
     delete(key: string): boolean;
     /**
-     * @en Clears entire cache.
+     * @en Clears the entire cache.
      * @ru Очищает весь кэш.
      */
     clear(): void;
     /**
-     * @en Returns current cache size.
+     * @en Returns the current number of items in the cache.
      * @ru Возвращает текущий размер кэша.
      */
     get size(): number;

package/utils/CacheManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/utils/CacheManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;;;;;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,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS;IAK1D;;;;;;;;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"}
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/utils/CacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAczE;;;;;;;GAOG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,OAAO,CAAC,EAAE,mBAAmB;IAMzC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAoB/B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAgBhC;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS;IAuBvD;;;;;;OAMG;IACH,eAAe,CACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,IAAI;IAoBP;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAWzB;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/utils/CacheManager.js

@@ -1,106 +1,154 @@
-import { LRUCache } from "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.
+ * @en High-performance inline in-memory cache with no external dependencies.
+ * Uses native Map and lazy invalidation to ensure maximum RPS.
+ * @ru Высокопроизводительный инлайновый in-memory кэш без внешних зависимостей.
+ * Использует нативный Map и ленивую инвалидацию для обеспечения максимального RPS.
  *
- * @ru Высокопроизводительный in-memory кэш на основе LRU стратегии.
- * Поддерживает TTL, хранение метаданных (etag, lastModified) и быстрый доступ по ключу.
+ * @template T - Type of the data stored in the cache. Defaults to unknown.
  */
 export class CacheManager {
-    cache;
+    storage = new Map();
+    maxSize;
+    ttl;
+    updateAgeOnGet;
     constructor(options) {
-        this.cache = new LRUCache({
-            max: options?.maxSize ?? 500,
-            ttl: options?.ttl ?? 300_000,
-            updateAgeOnGet: true,
-        });
+        this.maxSize = options?.maxSize ?? 500;
+        this.ttl = options?.ttl ?? 300_000;
+        this.updateAgeOnGet = options?.updateAgeOnGet ?? true;
     }
     /**
-     * @en Retrieves cached value by key.
+     * @en Retrieves a value from the cache by key.
      * @ru Получает значение из кэша по ключу.
-     *
-     * @template T
-     * @param key Cache key
-     * @returns Cached value or undefined if not found
+     * @param key - The cache key.
+     * @returns The cached value or undefined if not found or expired.
      */
     get(key) {
-        return this.cache.get(key)?.data;
+        const entry = this.storage.get(key);
+        if (!entry)
+            return undefined;
+        const now = Date.now();
+        if (now > entry.expiresAt) {
+            this.storage.delete(key);
+            return undefined;
+        }
+        if (this.updateAgeOnGet) {
+            entry.expiresAt = now + this.ttl;
+            // Move to end for LRU
+            this.storage.delete(key);
+            this.storage.set(key, entry);
+        }
+        return entry.data;
     }
     /**
-     * @en Stores value in cache.
+     * @en Stores a value in the cache.
      * @ru Сохраняет значение в кэш.
-     *
-     * @template T
-     * @param key Cache key
-     * @param value Value to store
+     * @param key - The cache key.
+     * @param value - The data to store.
      */
     set(key, value) {
-        this.cache.set(key, {
+        const now = Date.now();
+        if (this.storage.has(key)) {
+            this.storage.delete(key);
+        }
+        else if (this.storage.size >= this.maxSize) {
+            const oldestKey = this.storage.keys().next().value;
+            if (oldestKey !== undefined)
+                this.storage.delete(oldestKey);
+        }
+        this.storage.set(key, {
             data: value,
+            expiresAt: now + this.ttl,
         });
     }
     /**
-     * @en Retrieves cached entry with metadata (etag, lastModified).
+     * @en Retrieves a cache entry along with its metadata (etag, lastModified).
      * @ru Получает запись кэша вместе с метаданными (etag, lastModified).
-     *
-     * @template T
-     * @param key Cache key
-     * @returns Cached entry with metadata or undefined
+     * @param key - The cache key.
+     * @returns The cache entry with metadata or undefined if not found or expired.
      */
     getWithMetadata(key) {
-        const entry = this.cache.get(key);
-        return entry ? entry : undefined;
+        const entry = this.storage.get(key);
+        if (!entry)
+            return undefined;
+        const now = Date.now();
+        if (now > entry.expiresAt) {
+            this.storage.delete(key);
+            return undefined;
+        }
+        if (this.updateAgeOnGet) {
+            entry.expiresAt = now + this.ttl;
+            this.storage.delete(key);
+            this.storage.set(key, entry);
+        }
+        return {
+            data: entry.data,
+            etag: entry.etag,
+            lastModified: entry.lastModified,
+        };
     }
     /**
-     * @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
+     * @en Stores a value with additional HTTP metadata.
+     * @ru Сохраняет значение с дополнительными HTTP метаданными.
+     * @param key - The cache key.
+     * @param data - The response data to store.
+     * @param meta - Optional HTTP metadata (etag, lastModified).
      */
     setWithMetadata(key, data, meta) {
-        this.cache.set(key, {
+        const now = Date.now();
+        if (this.storage.has(key)) {
+            this.storage.delete(key);
+        }
+        else if (this.storage.size >= this.maxSize) {
+            const oldestKey = this.storage.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.storage.delete(oldestKey);
+            }
+        }
+        this.storage.set(key, {
             data,
             etag: meta?.etag,
             lastModified: meta?.lastModified,
+            expiresAt: now + this.ttl,
         });
     }
     /**
-     * @en Checks if key exists in cache.
-     * @ru Проверяет наличие ключа в кэше.
-     *
-     * @param key Cache key
-     * @returns true if exists, otherwise false
+     * @en Checks for the existence of a key in the cache without updating its TTL.
+     * @ru Проверяет наличие ключа в кэше без обновления его времени жизни.
+     * @param key - The cache key.
+     * @returns True if the key exists and is not expired.
      */
     has(key) {
-        return this.cache.has(key);
+        const entry = this.storage.get(key);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expiresAt) {
+            this.storage.delete(key);
+            return false;
+        }
+        return true;
     }
     /**
-     * @en Deletes value from cache by key.
+     * @en Removes a value from the cache by key.
      * @ru Удаляет значение из кэша по ключу.
-     *
-     * @param key Cache key
-     * @returns true if value was removed
+     * @param key - The cache key.
+     * @returns True if the element was removed, false otherwise.
      */
     delete(key) {
-        return this.cache.delete(key);
+        return this.storage.delete(key);
     }
     /**
-     * @en Clears entire cache.
+     * @en Clears the entire cache.
      * @ru Очищает весь кэш.
      */
     clear() {
-        this.cache.clear();
+        this.storage.clear();
     }
     /**
-     * @en Returns current cache size.
+     * @en Returns the current number of items in the cache.
      * @ru Возвращает текущий размер кэша.
      */
     get size() {
-        return this.cache.size;
+        return this.storage.size;
     }
 }
 //# sourceMappingURL=CacheManager.js.map

package/utils/CacheManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../../src/utils/CacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACN,KAAK,CAAoC;IAE1D,YAAY,OAA6B;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC;YACxB,GAAG,EAAE,OAAO,EAAE,OAAO,IAAI,GAAG;YAC5B,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO;YAC5B,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;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,CAAC,CAAE,KAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,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"}
+{"version":3,"file":"CacheManager.js","sourceRoot":"","sources":["../../src/utils/CacheManager.ts"],"names":[],"mappings":"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"}