express-memorize 1.4.0 → 1.5.0

package/dist/MemorizeStore.js

@@ -4,21 +4,55 @@ exports.MemorizeStore = exports.MemorizeEventType = void 0;
 const globToRegex_1 = require("./utils/globToRegex");
 const MemorizeEventType_1 = require("./domain/MemorizeEventType");
 Object.defineProperty(exports, "MemorizeEventType", { enumerable: true, get: function () { return MemorizeEventType_1.MemorizeEventType; } });
+const DEFAULT_TTL = 60000;
+function estimateByteSize(value) {
+    var _a;
+    if (typeof value === 'string')
+        return Buffer.byteLength(value);
+    if (Buffer.isBuffer(value))
+        return value.byteLength;
+    if (value instanceof ArrayBuffer)
+        return value.byteLength;
+    if (ArrayBuffer.isView(value))
+        return value.byteLength;
+    try {
+        return Buffer.byteLength((_a = JSON.stringify(value)) !== null && _a !== void 0 ? _a : '');
+    }
+    catch (_b) {
+        return 0;
+    }
+}
+function normalizeTtl(ttl) {
+    if (ttl === Infinity) {
+        return { expiresAt: null, timerTtl: null };
+    }
+    const effectiveTtl = ttl !== null && ttl !== void 0 ? ttl : DEFAULT_TTL;
+    if (typeof effectiveTtl !== 'number' || Number.isNaN(effectiveTtl) || !Number.isFinite(effectiveTtl)) {
+        throw new TypeError('ttl must be a finite number or Infinity');
+    }
+    if (effectiveTtl < 0) {
+        throw new RangeError('ttl must be greater than or equal to 0');
+    }
+    return { expiresAt: Date.now() + effectiveTtl, timerTtl: effectiveTtl };
+}
 /**
- * Low-level in-memory key-value store with optional TTL and event emission.
+ * Low-level in-memory key-value store with optional TTL, LRU eviction, and event emission.
  *
  * You do not usually interact with this class directly — use the {@link memorize} factory
  * instead, which wraps this store in an Express middleware.
  */
 class MemorizeStore {
-    constructor() {
+    constructor(_maxEntries) {
+        this._maxEntries = _maxEntries;
         this._store = new Map();
         this._timers = new Map();
+        this._totalByteSize = 0;
         this._listeners = {
             [MemorizeEventType_1.MemorizeEventType.Set]: [],
             [MemorizeEventType_1.MemorizeEventType.Delete]: [],
             [MemorizeEventType_1.MemorizeEventType.Expire]: [],
             [MemorizeEventType_1.MemorizeEventType.Empty]: [],
+            [MemorizeEventType_1.MemorizeEventType.Evict]: [],
         };
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -29,25 +63,36 @@ class MemorizeStore {
      * Stores an entry in the cache.
      *
      * If an entry already exists for the given key its TTL timer is reset and the
-     * value is overwritten. Emits a {@link MemorizeEventType.Set} event.
+     * value is overwritten. If `maxEntries` is configured and the store is full,
+     * the least-recently-used entry is evicted first. Emits a {@link MemorizeEventType.Set} event.
      *
      * @param key - The cache key (typically `req.originalUrl`).
      * @param entry - The response data to store.
-     * @param ttl - Time-to-live in milliseconds. Omit or pass `null` for no expiry.
+     * @param ttl - Time-to-live in milliseconds. Omit or pass `null` to use the default TTL.
+     * Pass `Infinity` for no expiry.
      */
     set(key, entry, ttl) {
+        if (this._maxEntries && !this._store.has(key) && this._store.size >= this._maxEntries) {
+            this._evictLRU();
+        }
         if (this._timers.has(key)) {
             clearTimeout(this._timers.get(key));
             this._timers.delete(key);
         }
-        const expiresAt = ttl ? Date.now() + ttl : null;
-        const stored = { ...entry, expiresAt, hits: 1 };
+        const existing = this._store.get(key);
+        if (existing) {
+            this._totalByteSize -= existing.size;
+        }
+        const { expiresAt, timerTtl } = normalizeTtl(ttl);
+        const size = estimateByteSize(entry.body);
+        const stored = { ...entry, expiresAt, hits: 1, size };
         this._store.set(key, stored);
-        this._emit(MemorizeEventType_1.MemorizeEventType.Set, { type: MemorizeEventType_1.MemorizeEventType.Set, key, ...entry, expiresAt });
-        if (ttl) {
+        this._totalByteSize += size;
+        this._emit(MemorizeEventType_1.MemorizeEventType.Set, { type: MemorizeEventType_1.MemorizeEventType.Set, key, ...entry, expiresAt, size });
+        if (timerTtl !== null) {
             const timer = setTimeout(() => {
                 this._evict(key, MemorizeEventType_1.MemorizeEventType.Expire);
-            }, ttl);
+            }, timerTtl);
             if (typeof timer === 'object' && 'unref' in timer)
                 timer.unref();
             this._timers.set(key, timer);
@@ -63,7 +108,7 @@ class MemorizeStore {
         const entry = this._store.get(key);
         if (!entry)
             return null;
-        if (entry.expiresAt && Date.now() > entry.expiresAt) {
+        if (entry.expiresAt && Date.now() >= entry.expiresAt) {
             this._evict(key, MemorizeEventType_1.MemorizeEventType.Expire);
             return null;
         }
@@ -76,7 +121,7 @@ class MemorizeStore {
     getAll() {
         const result = {};
         for (const [key, entry] of this._store) {
-            if (entry.expiresAt && Date.now() > entry.expiresAt) {
+            if (entry.expiresAt && Date.now() >= entry.expiresAt) {
                 this._evict(key, MemorizeEventType_1.MemorizeEventType.Expire);
                 continue;
             }
@@ -124,14 +169,39 @@ class MemorizeStore {
      * for each entry.
      */
     clear() {
-        for (const key of this._store.keys()) {
+        for (const key of [...this._store.keys()]) {
             this._evict(key, MemorizeEventType_1.MemorizeEventType.Delete);
         }
     }
+    /**
+     * Returns the number of active cache entries.
+     */
+    size() {
+        return this._store.size;
+    }
+    /**
+     * Returns the approximate total byte size of all cached bodies.
+     *
+     * The value is an estimate and may not reflect actual memory usage.
+     */
+    byteSize() {
+        return this._totalByteSize;
+    }
+    /**
+     * Returns aggregate cache statistics.
+     */
+    getStats() {
+        var _a;
+        return {
+            entries: this._store.size,
+            maxEntries: (_a = this._maxEntries) !== null && _a !== void 0 ? _a : null,
+            byteSize: this._totalByteSize,
+        };
+    }
     /**
      * Returns the raw {@link CacheEntry} for the given key without formatting metadata,
      * or `null` if the entry is missing or expired. Used internally by the middleware
-     * to serve cached responses.
+     * to serve cached responses. Updates LRU order and increments the hit counter.
      *
      * @param key - The cache key to look up.
      * @internal
@@ -140,18 +210,31 @@ class MemorizeStore {
         const entry = this._store.get(key);
         if (!entry)
             return null;
-        if (entry.expiresAt && Date.now() > entry.expiresAt) {
+        if (entry.expiresAt && Date.now() >= entry.expiresAt) {
             this._evict(key, MemorizeEventType_1.MemorizeEventType.Expire);
             return null;
         }
+        // Move to most-recently-used position for LRU eviction
+        this._store.delete(key);
+        this._store.set(key, entry);
         entry.hits++;
         return entry;
     }
+    _evictLRU() {
+        const firstKey = this._store.keys().next().value;
+        if (firstKey !== undefined) {
+            this._evict(firstKey, MemorizeEventType_1.MemorizeEventType.Evict);
+        }
+    }
     _evict(key, reason) {
         if (this._timers.has(key)) {
             clearTimeout(this._timers.get(key));
             this._timers.delete(key);
         }
+        const entry = this._store.get(key);
+        if (entry) {
+            this._totalByteSize = Math.max(0, this._totalByteSize - entry.size);
+        }
         this._store.delete(key);
         this._emit(reason, { type: reason, key });
         if (this._store.size === 0) {
@@ -171,6 +254,7 @@ class MemorizeStore {
             contentType: entry.contentType,
             expiresAt: entry.expiresAt,
             hits: entry.hits,
+            size: entry.size,
             remainingTtl: entry.expiresAt ? Math.max(0, entry.expiresAt - Date.now()) : null,
         };
     }

package/dist/MemorizeStore.js.map

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

package/dist/adapters/express.d.ts

@@ -0,0 +1,25 @@
+import { RequestHandler } from 'express';
+import type { Memorize } from '../domain/Memorize';
+import { MemorizeStore } from '../MemorizeStore';
+import { MemorizeCallOptions } from '../domain/MemorizeCallOptions';
+/**
+ * Creates an Express `RequestHandler` that caches `GET` responses using the
+ * provided {@link Memorize} instance.
+ *
+ * Import from `express-memorize/express` when you need the adapter directly,
+ * without going through the `memorize()` factory.
+ *
+ * @example
+ * ```ts
+ * import { memorize } from 'express-memorize';
+ * import { createExpressAdapter } from 'express-memorize/express';
+ *
+ * const cache = memorize({ ttl: 30_000 });
+ * app.get('/users', createExpressAdapter(cache), handler);
+ * app.get('/products', createExpressAdapter(cache, { ttl: 5_000 }), handler);
+ * ```
+ */
+export declare function createExpressAdapter(cache: Memorize, options?: MemorizeCallOptions): RequestHandler;
+/** @internal Used by the memorize() factory. */
+export declare function createExpressMiddleware(store: MemorizeStore, globalTtl?: number): (callOptions?: MemorizeCallOptions) => RequestHandler;
+//# sourceMappingURL=express.d.ts.map

package/dist/adapters/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/adapters/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,cAAc,CAEhB;AAED,gDAAgD;AAChD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,CAAC,WAAW,CAAC,EAAE,mBAAmB,KAAK,cAAc,CAwCvD"}

package/dist/adapters/express.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExpressAdapter = createExpressAdapter;
+exports.createExpressMiddleware = createExpressMiddleware;
+/**
+ * Creates an Express `RequestHandler` that caches `GET` responses using the
+ * provided {@link Memorize} instance.
+ *
+ * Import from `express-memorize/express` when you need the adapter directly,
+ * without going through the `memorize()` factory.
+ *
+ * @example
+ * ```ts
+ * import { memorize } from 'express-memorize';
+ * import { createExpressAdapter } from 'express-memorize/express';
+ *
+ * const cache = memorize({ ttl: 30_000 });
+ * app.get('/users', createExpressAdapter(cache), handler);
+ * app.get('/products', createExpressAdapter(cache, { ttl: 5_000 }), handler);
+ * ```
+ */
+function createExpressAdapter(cache, options) {
+    return cache.express(options);
+}
+/** @internal Used by the memorize() factory. */
+function createExpressMiddleware(store, globalTtl) {
+    return function (callOptions) {
+        var _a;
+        const effectiveTtl = (_a = callOptions === null || callOptions === void 0 ? void 0 : callOptions.ttl) !== null && _a !== void 0 ? _a : globalTtl;
+        return function (req, res, next) {
+            if (req.method !== 'GET') {
+                next();
+                return;
+            }
+            if (callOptions === null || callOptions === void 0 ? void 0 : callOptions.noCache) {
+                res.setHeader('X-Cache', 'BYPASS');
+                next();
+                return;
+            }
+            const key = req.originalUrl;
+            const cached = store.getRaw(key);
+            if (cached) {
+                res.setHeader('X-Cache', 'HIT');
+                res.setHeader('Content-Type', cached.contentType);
+                res.status(cached.statusCode).send(cached.body);
+                return;
+            }
+            const originalSend = res.send.bind(res);
+            res.send = function (body) {
+                var _a;
+                if (res.statusCode >= 200 && res.statusCode < 300) {
+                    const contentType = (_a = res.getHeader('Content-Type')) !== null && _a !== void 0 ? _a : 'application/octet-stream';
+                    store.set(key, { body, statusCode: res.statusCode, contentType }, effectiveTtl);
+                }
+                res.setHeader('X-Cache', 'MISS');
+                return originalSend(body);
+            };
+            next();
+        };
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/adapters/express.ts"],"names":[],"mappings":";;AAsBA,oDAKC;AAGD,0DA2CC;AApED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,oBAAoB,CAClC,KAAe,EACf,OAA6B;IAE7B,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,gDAAgD;AAChD,SAAgB,uBAAuB,CACrC,KAAoB,EACpB,SAAkB;IAElB,OAAO,UAAU,WAAiC;;QAChD,MAAM,YAAY,GAAG,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,GAAG,mCAAI,SAAS,CAAC;QAEnD,OAAO,UAAU,GAAY,EAAE,GAAa,EAAE,IAAkB;YAC9D,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACzB,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YAED,IAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,OAAO,EAAE,CAAC;gBACzB,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBACnC,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YAED,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEjC,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAChC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;gBAClD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YAED,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiC,CAAC;YAExE,GAAG,CAAC,IAAI,GAAG,UAAU,IAAc;;gBACjC,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;oBAClD,MAAM,WAAW,GAAG,MAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAY,mCAAI,0BAA0B,CAAC;oBAC5F,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;gBAClF,CAAC;gBACD,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACjC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC;YAEF,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/adapters/fetch.d.ts

@@ -0,0 +1,45 @@
+import type { Memorize } from '../domain/Memorize';
+type FetchHandler = (request: Request) => Promise<Response>;
+export interface FetchAdapterOptions {
+    /** Time-to-live in milliseconds. Defaults to the global TTL. */
+    ttl?: number;
+    /** Skip caching. Sets `X-Cache: BYPASS`. */
+    noCache?: boolean;
+    /** Custom cache key extractor. Defaults to `pathname + search`. */
+    key?: (request: Request) => string;
+}
+/**
+ * Wraps a Fetch API handler with in-memory caching for `GET` requests with
+ * `2xx` responses.
+ *
+ * Works in any runtime that supports the Web-standard `Request` and `Response`
+ * APIs: Node.js, Bun, Deno, Cloudflare Workers, and similar environments.
+ *
+ * @param cache - The {@link Memorize} instance to use as the backing store.
+ * @param handler - The original fetch handler to wrap.
+ * @param options - Optional per-handler options.
+ *
+ * @example Serverless handler
+ * ```ts
+ * import { memorize } from 'express-memorize';
+ * import { cacheFetchHandler } from 'express-memorize/fetch';
+ *
+ * const cache = memorize({ ttl: 30_000 });
+ *
+ * export default cacheFetchHandler(cache, async (request) => {
+ *   const users = await usersService.findAll();
+ *   return Response.json(users);
+ * });
+ * ```
+ *
+ * @example With options
+ * ```ts
+ * const handler = cacheFetchHandler(cache, originalHandler, {
+ *   ttl: 60_000,
+ *   key: (req) => new URL(req.url).pathname,
+ * });
+ * ```
+ */
+export declare function cacheFetchHandler(cache: Memorize, handler: FetchHandler, options?: FetchAdapterOptions): FetchHandler;
+export {};
+//# sourceMappingURL=fetch.d.ts.map

package/dist/adapters/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/adapters/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAyCd"}

package/dist/adapters/fetch.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheFetchHandler = cacheFetchHandler;
+/**
+ * Wraps a Fetch API handler with in-memory caching for `GET` requests with
+ * `2xx` responses.
+ *
+ * Works in any runtime that supports the Web-standard `Request` and `Response`
+ * APIs: Node.js, Bun, Deno, Cloudflare Workers, and similar environments.
+ *
+ * @param cache - The {@link Memorize} instance to use as the backing store.
+ * @param handler - The original fetch handler to wrap.
+ * @param options - Optional per-handler options.
+ *
+ * @example Serverless handler
+ * ```ts
+ * import { memorize } from 'express-memorize';
+ * import { cacheFetchHandler } from 'express-memorize/fetch';
+ *
+ * const cache = memorize({ ttl: 30_000 });
+ *
+ * export default cacheFetchHandler(cache, async (request) => {
+ *   const users = await usersService.findAll();
+ *   return Response.json(users);
+ * });
+ * ```
+ *
+ * @example With options
+ * ```ts
+ * const handler = cacheFetchHandler(cache, originalHandler, {
+ *   ttl: 60_000,
+ *   key: (req) => new URL(req.url).pathname,
+ * });
+ * ```
+ */
+function cacheFetchHandler(cache, handler, options) {
+    return async (request) => {
+        var _a;
+        if (request.method !== 'GET') {
+            return handler(request);
+        }
+        if (options === null || options === void 0 ? void 0 : options.noCache) {
+            const response = await handler(request);
+            const headers = new Headers(response.headers);
+            headers.set('X-Cache', 'BYPASS');
+            return new Response(response.body, { status: response.status, headers });
+        }
+        const { pathname, search } = new URL(request.url);
+        const key = (options === null || options === void 0 ? void 0 : options.key) ? options.key(request) : pathname + search;
+        const cached = cache._store.getRaw(key);
+        if (cached) {
+            return new Response(cached.body, {
+                status: cached.statusCode,
+                headers: {
+                    'Content-Type': cached.contentType,
+                    'X-Cache': 'HIT',
+                },
+            });
+        }
+        const response = await handler(request);
+        if (response.status >= 200 && response.status < 300) {
+            const body = await response.clone().text();
+            const contentType = (_a = response.headers.get('Content-Type')) !== null && _a !== void 0 ? _a : 'application/octet-stream';
+            cache._store.set(key, { body, statusCode: response.status, contentType }, options === null || options === void 0 ? void 0 : options.ttl);
+            const headers = new Headers(response.headers);
+            headers.set('X-Cache', 'MISS');
+            return new Response(body, { status: response.status, headers });
+        }
+        return response;
+    };
+}
+//# sourceMappingURL=fetch.js.map

package/dist/adapters/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/adapters/fetch.ts"],"names":[],"mappings":";;AA6CA,8CA6CC;AA7ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,iBAAiB,CAC/B,KAAe,EACf,OAAqB,EACrB,OAA6B;IAE7B,OAAO,KAAK,EAAE,OAAgB,EAAqB,EAAE;;QACnD,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACjC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,EAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;QACpE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAExC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAc,EAAE;gBACzC,MAAM,EAAE,MAAM,CAAC,UAAU;gBACzB,OAAO,EAAE;oBACP,cAAc,EAAE,MAAM,CAAC,WAAW;oBAClC,SAAS,EAAE,KAAK;iBACjB;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QAExC,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,WAAW,GAAG,MAAA,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,mCAAI,0BAA0B,CAAC;YACvF,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,CAAC,CAAC;YAExF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC/B,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/adapters/hono.d.ts

@@ -0,0 +1,34 @@
+import type { Context, MiddlewareHandler } from 'hono';
+import type { Memorize } from '../domain/Memorize';
+export interface HonoCallOptions {
+    /** Time-to-live in milliseconds. Defaults to the global TTL. */
+    ttl?: number;
+    /** Skip caching for this route. Sets `X-Cache: BYPASS`. */
+    noCache?: boolean;
+    /** Custom cache key extractor. Defaults to `c.req.url`. */
+    key?: (c: Context) => string;
+}
+/**
+ * Creates a Hono middleware that caches `GET` responses with a `2xx` status code.
+ *
+ * Requires `hono` to be installed as a peer dependency.
+ *
+ * @param cache - The {@link Memorize} instance to use as the backing store.
+ * @param options - Optional per-route options.
+ *
+ * @example
+ * ```ts
+ * import { Hono } from 'hono';
+ * import { memorize } from 'express-memorize';
+ * import { createHonoMiddleware } from 'express-memorize/hono';
+ *
+ * const app = new Hono();
+ * const cache = memorize({ ttl: 30_000 });
+ *
+ * app.get('/users', createHonoMiddleware(cache), async (c) => {
+ *   return c.json(await usersService.findAll());
+ * });
+ * ```
+ */
+export declare function createHonoMiddleware(cache: Memorize, options?: HonoCallOptions): MiddlewareHandler;
+//# sourceMappingURL=hono.d.ts.map

package/dist/adapters/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/adapters/hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAQ,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,iBAAiB,CA0ClG"}

package/dist/adapters/hono.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHonoMiddleware = createHonoMiddleware;
+/**
+ * Creates a Hono middleware that caches `GET` responses with a `2xx` status code.
+ *
+ * Requires `hono` to be installed as a peer dependency.
+ *
+ * @param cache - The {@link Memorize} instance to use as the backing store.
+ * @param options - Optional per-route options.
+ *
+ * @example
+ * ```ts
+ * import { Hono } from 'hono';
+ * import { memorize } from 'express-memorize';
+ * import { createHonoMiddleware } from 'express-memorize/hono';
+ *
+ * const app = new Hono();
+ * const cache = memorize({ ttl: 30_000 });
+ *
+ * app.get('/users', createHonoMiddleware(cache), async (c) => {
+ *   return c.json(await usersService.findAll());
+ * });
+ * ```
+ */
+function createHonoMiddleware(cache, options) {
+    return async (c, next) => {
+        var _a;
+        if (c.req.method !== 'GET') {
+            return next();
+        }
+        if (options === null || options === void 0 ? void 0 : options.noCache) {
+            await next();
+            const headers = new Headers(c.res.headers);
+            headers.set('X-Cache', 'BYPASS');
+            c.res = new Response(c.res.body, { status: c.res.status, headers });
+            return;
+        }
+        const { pathname, search } = new URL(c.req.url);
+        const key = (options === null || options === void 0 ? void 0 : options.key) ? options.key(c) : pathname + search;
+        const cached = cache._store.getRaw(key);
+        if (cached) {
+            return new Response(cached.body, {
+                status: cached.statusCode,
+                headers: {
+                    'Content-Type': cached.contentType,
+                    'X-Cache': 'HIT',
+                },
+            });
+        }
+        await next();
+        const { status } = c.res;
+        if (status >= 200 && status < 300) {
+            const body = await c.res.clone().text();
+            const contentType = (_a = c.res.headers.get('Content-Type')) !== null && _a !== void 0 ? _a : 'application/octet-stream';
+            cache._store.set(key, { body, statusCode: status, contentType }, options === null || options === void 0 ? void 0 : options.ttl);
+            const headers = new Headers(c.res.headers);
+            headers.set('X-Cache', 'MISS');
+            c.res = new Response(body, { status, headers });
+        }
+    };
+}
+//# sourceMappingURL=hono.js.map

package/dist/adapters/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../src/adapters/hono.ts"],"names":[],"mappings":";;AAkCA,oDA0CC;AAhED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,oBAAoB,CAAC,KAAe,EAAE,OAAyB;IAC7E,OAAO,KAAK,EAAE,CAAU,EAAE,IAAU,EAAE,EAAE;;QACtC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACjC,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,EAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;QAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAExC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAc,EAAE;gBACzC,MAAM,EAAE,MAAM,CAAC,UAAU;gBACzB,OAAO,EAAE;oBACP,cAAc,EAAE,MAAM,CAAC,WAAW;oBAClC,SAAS,EAAE,KAAK;iBACjB;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;QAEb,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC;QAEzB,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,WAAW,GAAG,MAAA,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,mCAAI,0BAA0B,CAAC;YACpF,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,CAAC,CAAC;YAE/E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC/B,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/adapters/nestjs.d.ts

@@ -0,0 +1,84 @@
+import type { Memorize } from '../domain/Memorize';
+import type { MemorizeOptions } from '../domain/MemorizeOptions';
+export declare const MEMORIZE_CACHE: unique symbol;
+export declare const MEMORIZE_MODULE_OPTIONS: unique symbol;
+type MetadataTarget = object;
+export interface MemorizeNestExecutionContext {
+    getClass(): MetadataTarget;
+    getHandler(): MetadataTarget;
+    switchToHttp(): {
+        getRequest(): MemorizeNestHttpRequest;
+        getResponse(): MemorizeNestHttpResponse;
+    };
+}
+export interface MemorizeNestCallHandler<T = unknown> {
+    handle(): MemorizeNestObservable<T>;
+}
+export interface MemorizeNestObservable<T = unknown> {
+    subscribe(observerOrNext?: Partial<ObserverLike<T>> | ((value: T) => void), error?: (error: unknown) => void, complete?: () => void): unknown;
+}
+interface ObserverLike<T = unknown> {
+    next(value: T): void;
+    error(error: unknown): void;
+    complete(): void;
+}
+export interface MemorizeNestHttpRequest {
+    method?: string;
+    originalUrl?: string;
+    url?: string;
+}
+export interface MemorizeNestHttpResponse {
+    statusCode?: number;
+    setHeader?: (name: string, value: string) => void;
+    header?: (name: string, value: string) => void;
+    headersSent?: boolean;
+}
+export interface MemorizeNestKeyContext {
+    context: MemorizeNestExecutionContext;
+    request: MemorizeNestHttpRequest;
+}
+export interface MemorizeNestOptions extends MemorizeOptions {
+    /**
+     * Custom request-based cache key generator. Defaults to
+     * `request.originalUrl ?? request.url`.
+     */
+    key?: (ctx: MemorizeNestKeyContext) => string;
+}
+interface DynamicModuleLike {
+    module: unknown;
+    providers: unknown[];
+    exports: unknown[];
+    global?: boolean;
+}
+/**
+ * Decorates a controller or handler with a fixed cache key.
+ */
+export declare function MemorizeCacheKey(key: string): MethodDecorator & ClassDecorator;
+/**
+ * Decorates a controller or handler with a TTL override in milliseconds.
+ */
+export declare function MemorizeTtl(ttl: number): MethodDecorator & ClassDecorator;
+/**
+ * Decorates a controller or handler so the interceptor bypasses cache reads and writes.
+ */
+export declare function MemorizeNoCache(): MethodDecorator & ClassDecorator;
+/**
+ * NestJS interceptor backed by a shared {@link Memorize} cache instance.
+ *
+ * Register through {@link MemorizeModule.forRoot} for dependency injection, or
+ * instantiate directly in tests and small applications.
+ */
+export declare class MemorizeInterceptor {
+    private readonly cache;
+    private readonly options;
+    constructor(cache?: Memorize, options?: MemorizeNestOptions);
+    intercept(context: MemorizeNestExecutionContext, next: MemorizeNestCallHandler): MemorizeNestObservable<unknown>;
+}
+/**
+ * Dynamic Nest module that provides a shared cache and interceptor.
+ */
+export declare class MemorizeModule {
+    static forRoot(options?: MemorizeNestOptions): DynamicModuleLike;
+}
+export {};
+//# sourceMappingURL=nestjs.d.ts.map

package/dist/adapters/nestjs.d.ts.map

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