@hyperttp/cache 1.0.3 → 1.0.4

package/index.d.ts

@@ -0,0 +1,4 @@
+export { withCache } from "./plugin.js";
+export type * from "./types/cache.js";
+export * from "./utils/CacheManager.js";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,mBAAmB,kBAAkB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/index.js

@@ -0,0 +1,3 @@
+export { withCache } from "./plugin.js";
+export * from "./utils/CacheManager.js";
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,cAAc,yBAAyB,CAAC"}

package/package.json

@@ -1,13 +1,10 @@
 {
   "name": "@hyperttp/cache",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "High-performance LRU caching plugin for Hyperttp client",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "main": "./index.js",
+  "types": "./index.d.ts",
   "keywords": [
     "hyperttp"
   ],
@@ -17,10 +14,8 @@
     "type": "git",
     "url": "git+https://github.com/IT-IF-OR/hyperttp-cache.git"
   },
-  "peerDependencies": {
-    "@hyperttp/core": "^1.0.5"
-  },
   "dependencies": {
+    "@hyperttp/core": "^1.1.2",
     "lru-cache": "^11.5.0"
   }
-}
+}

package/{dist/plugin.d.ts → plugin.d.ts}

@@ -1,9 +1,8 @@
 import type { HyperCore, HyperPlugin } from "@hyperttp/core";
 import type { CacheManagerOptions } from "./types/cache.js";
-interface CacheableHyperCore extends HyperCore {
+export interface CacheableHyperCore extends HyperCore {
     clearCache?: () => void;
 }
-export declare function withCache(client: HyperCore, options: CacheManagerOptions): CacheableHyperCore;
 declare module "@hyperttp/core" {
     interface HyperttpPluginsExtension {
         cache?: CacheManagerOptions & {
@@ -11,6 +10,5 @@ declare module "@hyperttp/core" {
         };
     }
 }
-export declare const CachePlugin: HyperPlugin;
-export {};
+export declare function withCache(): HyperPlugin;
 //# sourceMappingURL=plugin.d.ts.map

package/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAmB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,wBAAwB;QAChC,KAAK,CAAC,EAAE,mBAAmB,GAAG;YAC5B,OAAO,EAAE,OAAO,CAAC;SAClB,CAAC;KACH;CACF;AAED,wBAAgB,SAAS,IAAI,WAAW,CA+DvC"}

package/plugin.js

@@ -0,0 +1,52 @@
+import { CacheManager } from "./utils/CacheManager.js";
+export function withCache() {
+    let cache;
+    return {
+        name: "hyperttp-cache",
+        phase: "PREPARE",
+        enabled: (config) => !!config.cache?.enabled,
+        setup(core, config) {
+            cache = new CacheManager(config.cache);
+            core.clearCache = () => cache.clear();
+            if (core && typeof core.getStats === "function") {
+                const originalGetStats = core.getStats.bind(core);
+                core.getStats = () => ({
+                    ...originalGetStats(),
+                    cacheSize: cache?.size ?? 0,
+                });
+            }
+        },
+        wrapDispatch: (next) => {
+            return async (req) => {
+                if (req.method !== "GET")
+                    return next(req);
+                const cached = await cache.get(req.url);
+                if (cached !== undefined) {
+                    return (typeof cached.clone === "function"
+                        ? cached.clone()
+                        : cached);
+                }
+                const result = await next(req);
+                if (result !== undefined) {
+                    const valueToCache = typeof result.clone === "function"
+                        ? result.clone()
+                        : result;
+                    const headers = result.headers;
+                    if (headers) {
+                        const etag = headers["etag"] || headers["ETag"];
+                        const lastModified = headers["last-modified"] || headers["Last-Modified"];
+                        cache.setWithMetadata(req.url, valueToCache, {
+                            etag: typeof etag === "string" ? etag : undefined,
+                            lastModified: typeof lastModified === "string" ? lastModified : undefined,
+                        });
+                    }
+                    else {
+                        cache.set(req.url, valueToCache);
+                    }
+                }
+                return result;
+            };
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAcvD,MAAM,UAAU,SAAS;IACvB,IAAI,KAAoB,CAAC;IAEzB,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO;QAE5C,KAAK,CAAC,IAAwB,EAAE,MAAM;YACpC,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,KAAM,CAAC,CAAC;YAExC,IAAI,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAEtC,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAChD,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC;oBACrB,GAAG,gBAAgB,EAAE;oBACrB,SAAS,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,OAAO,KAAK,EAAW,GAAoB,EAAc,EAAE;gBACzD,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK;oBAAE,OAAO,IAAI,CAAC,GAAG,CAAe,CAAC;gBAEzD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,OAAO,CACL,OAAQ,MAAc,CAAC,KAAK,KAAK,UAAU;wBACzC,CAAC,CAAE,MAAc,CAAC,KAAK,EAAE;wBACzB,CAAC,CAAC,MAAM,CACN,CAAC;gBACT,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;gBAE/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,MAAM,YAAY,GAChB,OAAQ,MAAc,CAAC,KAAK,KAAK,UAAU;wBACzC,CAAC,CAAE,MAAc,CAAC,KAAK,EAAE;wBACzB,CAAC,CAAC,MAAM,CAAC;oBAEb,MAAM,OAAO,GAAI,MAAc,CAAC,OAAO,CAAC;oBACxC,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;wBAChD,MAAM,YAAY,GAChB,OAAO,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;wBAEvD,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE;4BAC3C,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;4BACjD,YAAY,EACV,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;yBAC9D,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;gBAED,OAAO,MAAW,CAAC;YACrB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 IT IF OR
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,96 +0,0 @@
-# @hyperttp/cache
-
-Высокопроизводительный плагин кэширования для HTTP-клиента **Hyperttp**,
-работающий на базе `lru-cache`.
-Перехватывает идемпотентные запросы на фазе управления (`CONTROL`),
-сводя к нулю нагрузку на сеть при повторных вызовах.
-
-## Особенности
-
-- ⚡ **Нулевая задержка**: Проверяет кэш на фазе `CONTROL`,
-полностью минуя сетевой стек.
-- 📦 **LRU Стратегия**:
-Автоматически вытесняет старые данные при достижении лимитов (благодаря `lru-cache`).
-- 📊 **Прозрачная статистика**: Интегрируется в системный вызов `client.getStats()`,
-добавляя метрику `cacheSize`.
-- 🧹 **Ручное управление**:
-Добавляет метод `client.clearCache()` для принудительного сброса данных.
-- 🔒 **Строгая типизация**:
-Полная поддержка TypeScript «из коробки» через Module Augmentation.
-
-## Установка
-
-```bash
-# Использованием bun (рекомендуется)
-bun add @hyperttp/cache
-
-# Или через npm/pnpm
-npm install @hyperttp/cache
-
-```
-
-## Использование
-
-Плагин автоматически обнаруживается менеджером плагинов `Hyperttp`
-(если настроен автоскан `package.json`), либо его можно передать явно.
-
-### Настройка при инициализации клиента
-
-```typescript
-import { HyperClient } from "@hyperttp/core";
-// Импорт нужен для того, чтобы TypeScript подтянул расширение типов для HttpClientOptions
-import "@hyperttp/cache"; 
-
-const client = new HyperClient({
-  verbose: true,
-  cache: {
-    enabled: true,
-    max: 500,              // Максимальное количество объектов в кэше
-    ttl: 1000 * 60 * 5,    // Время жизни кэша (5 минут)
-  }
-});
-
-// Первый запрос пойдет в сеть
-const data1 = await client.get("https://api.example.com/data");
-
-// Второй запрос вернется мгновенно из кэша
-const data2 = await client.get("https://api.example.com/data");
-
-```
-
-### Метрики и управление кэшем
-
-Плагин динамически расширяет инстанс ядра, добавляя методы управления:
-
-```typescript
-// Получить текущий размер кэша вместе с общими метриками ядра
-console.log(client.getStats()); 
-// Выведет: { requests: 2, ..., cacheSize: 1 }
-
-// Полная очистка кэша вручную
-(client as any).clearCache(); 
-
-```
-
-## Как это работает (Архитектура)
-
-Плагин встраивается в «луковичную» (onion) архитектуру запроса на фазе **`CONTROL`**:
-
-```mermaid
-graph LR
-    Req([Запрос]) --> MONITOR --> LOGIC --> CONTROL{Проверка кэша}
-    
-    CONTROL -- Кэш-хит --> Return([Возврат данных])
-    CONTROL -- Кэш-мисс --> FORMAT --> NETWORK --> Save[Запись в Кэш] --> Return
-
-    style CONTROL fill:#f9f,stroke:#333,stroke-width:2px
-    style Return fill:#bbf,stroke:#333,stroke-width:2px
-```
-
-Он перехватывает исключительно `GET` запросы (проверка через флаг `req.isGet`).
-Если URL уже есть в памяти, выполнение сетевой цепочки прерывается,
-и клиент моментально возвращает сохраненный результат.
-
-## Лицензия
-
-MIT © dirold2

package/dist/index.d.ts

@@ -1,4 +0,0 @@
-export { withCache, CachePlugin } from "./plugin.js";
-export type * from "./types/cache.js";
-export * from "./utils/CacheManager.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,mBAAmB,kBAAkB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,3 +0,0 @@
-export { withCache, CachePlugin } from "./plugin.js";
-export * from "./utils/CacheManager.js";
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErD,cAAc,yBAAyB,CAAC"}

package/dist/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EAGZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,UAAU,kBAAmB,SAAQ,SAAS;IAC5C,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CA0BpB;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,wBAAwB;QAChC,KAAK,CAAC,EAAE,mBAAmB,GAAG;YAC5B,OAAO,EAAE,OAAO,CAAC;SAClB,CAAC;KACH;CACF;AAED,eAAO,MAAM,WAAW,EAAE,WAQzB,CAAC"}

package/dist/plugin.js

@@ -1,34 +0,0 @@
-import { CacheManager } from "./utils/CacheManager.js";
-export function withCache(client, options) {
-    const cache = new CacheManager(options);
-    const next = client.dispatch;
-    const originalGetStats = client.getStats.bind(client);
-    client.getStats = () => ({
-        ...originalGetStats(),
-        cacheSize: cache.size ?? 0,
-    });
-    client.dispatch = async (req) => {
-        if (!req.isGet)
-            return next(req);
-        const urlString = typeof req.url === "string" ? req.url : req.url.getURL();
-        const cached = await cache.get(urlString);
-        if (cached !== undefined)
-            return cached;
-        const result = await next(req);
-        if (result !== undefined)
-            cache.set(urlString, result);
-        return result;
-    };
-    const extendedClient = client;
-    extendedClient.clearCache = () => cache.clear();
-    return extendedClient;
-}
-export const CachePlugin = {
-    name: "hyperttp-cache",
-    phase: "CONTROL",
-    enabled: (config) => !!config.cache?.enabled,
-    apply: (client, config) => {
-        return withCache(client, config.cache);
-    },
-};
-//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD,MAAM,UAAU,SAAS,CACvB,MAAiB,EACjB,OAA4B;IAE5B,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEtD,MAAM,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC;QACvB,GAAG,gBAAgB,EAAE;QACrB,SAAS,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,GAAG,KAAK,EAAW,GAAoB,EAAc,EAAE;QACpE,IAAI,CAAC,GAAG,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,GAAG,CAAM,CAAC;QAEtC,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAC3E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAW,CAAC;QAE7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,MAAW,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,MAA4B,CAAC;IACpD,cAAc,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAEhD,OAAO,cAAc,CAAC;AACxB,CAAC;AAUD,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,CAAC,MAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO;IAE/D,KAAK,EAAE,CAAC,MAAiB,EAAE,MAAyB,EAAE,EAAE;QACtD,OAAO,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,KAAM,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC"}