@hyperttp/cache 1.1.1 → 1.1.5

package/README.md

@@ -1,4 +1,3 @@
-```markdown
 # hyperttp-cache
 
 > [Русский](https://github.com/IT-IF-OR/hyperttp-cache/tree/main/lang/ru) | English
@@ -136,7 +135,3 @@ from the map to ensure subsequent retries targeting the failed endpoint are neve
 ## 📄 License
 
 MIT
-
-```
-
-```

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@hyperttp/cache",
-  "version": "1.1.1",
+  "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":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AA4BvD;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB;;;;OAIG;IACH,IAAI,KAAmB,CAAC;IAExB;;;;OAIG;IACH,IAAI,cAA2B,CAAC;IAEhC;;;;OAIG;IACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEpD,OAAO;QACL,IAAI,EAAE,gBAAgB;QAEtB;;;;;WAKG;QACH,OAAO,EAAE,CAAC,MAA4D,EAAE,EAAE;YACxE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC;QACjC,CAAC;QAED;;;;WAIG;QACH,KAAK,CAAC,GAAkB;YACtB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAwC,CAAC;YAElE,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACxC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;YAElB,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAEtE,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAChD,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC;gBACvC,IAAI,CAAC,QAAQ,GAAG;oBACd,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1C,IAAI,KAAK,EAAE,CAAC;wBACV,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;oBAC/B,CAAC;oBACD,OAAO,KAAK,CAAC;gBACf,CAAC,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,UAAU,GAAG,CAAC,GAAY,EAAE,EAAE;gBACjC,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjD,CAAC,CAAC;QACJ,CAAC;QAED;;;;;;WAMG;QACH,SAAS,CACP,GAAoB;QACpB,6DAA6D;QAC7D,IAAmB;YAEnB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC;YACzB,MAAM,WAAW,GAAG,KAAK,CAAC,eAAe,CAAoB,QAAQ,CAAC,CAAC;YAEvE,IACE,WAAW,KAAK,SAAS;gBACzB,CAAC,WAAW,CAAC,IAAI;gBACjB,CAAC,WAAW,CAAC,YAAY,EACzB,CAAC;gBACD,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,CAAC;YAED,6DAA6D;YAC7D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,GAAG,CAAC,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjC,IAAI,WAAW,CAAC,IAAI;oBAAE,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;gBACtE,IAAI,WAAW,CAAC,YAAY;oBAC1B,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC;YAChE,CAAC;YAED,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,eAAe,EAAE,CAAC;gBACpB,OAAO,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5D,CAAC;YAED,IAAI,SAA4C,CAAC;YACjD,IAAI,QAA6B,CAAC;YAElC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBAC1D,SAAS,GAAG,GAAG,CAAC;gBAChB,QAAQ,GAAG,GAAG,CAAC;YACjB,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAExB,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED;;;WAGG;QACH,UAAU,CACR,GAAsB,EACtB,GAAoB;QACpB,6DAA6D;QAC7D,IAAmB;YAEnB,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC;YACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAEvC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAE1B,MAAM,WAAW,GAAG,KAAK,CAAC,eAAe,CAAoB,QAAQ,CAAC,CAAC;YAEvE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBACpD,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;gBAChC,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,GAAG,CAAC;gBAEvC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBAC1C,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;gBAC5B,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;gBACpD,MAAM,YAAY,GAChB,OAAO,EAAE,CAAC,eAAe,CAAC,IAAI,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC;gBAE3D,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE;oBAC5C,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;oBACjD,YAAY,EACV,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;iBAC9D,CAAC,CAAC;gBAEH,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YAED,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,CAAC;QAED;;;;;;WAMG;QACH,OAAO,CACL,GAAkB,EAClB,GAAoB;QACpB,6DAA6D;QAC7D,IAAmB;YAEnB,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC;YACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAEvC,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC1B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"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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"}