express-memorize 2.3.1 → 2.5.0

package/dist/domain/Memorize.d.ts

@@ -8,6 +8,7 @@ import { MemorizeExpireEvent } from './MemorizeExpireEvent';
 import { MemorizeEmptyEvent } from './MemorizeEmptyEvent';
 import { MemorizeEvictEvent } from './MemorizeEvictEvent';
 import { MemorizeStats } from './MemorizeStats';
+import { MemorizeBatchOptions } from './MemorizeBatchOptions';
 import { MemorizeStore } from '../MemorizeStore';
 /**
  * The cache instance returned by {@link memorize}.
@@ -78,6 +79,16 @@ export interface Memorize {
      * ```
      */
     set<T>(key: string, value: T, ttl?: number): void;
+    /**
+     * Async variant of {@link set}. It yields back to the event loop before
+     * serializing and storing the value, which helps when many direct-cache writes
+     * are processed with `await` in a loop.
+     *
+     * @param key - Cache key.
+     * @param value - Value to cache.
+     * @param ttl - Time-to-live in milliseconds. Defaults to the global TTL.
+     */
+    setAsync<T>(key: string, value: T, ttl?: number): Promise<void>;
     /**
      * Returns the cached value for the given key, or `undefined` if the key does
      * not exist or has expired.
@@ -93,6 +104,13 @@ export interface Memorize {
      * ```
      */
     getValue<T>(key: string): T | undefined;
+    /**
+     * Async variant of {@link getValue}. It yields back to the event loop before
+     * deserializing the cached value.
+     *
+     * @param key - Cache key.
+     */
+    getValueAsync<T>(key: string): Promise<T | undefined>;
     /**
      * Returns the cached value for the given key if it exists, otherwise calls
      * `factory`, caches the result, and returns it.
@@ -108,6 +126,16 @@ export interface Memorize {
      * ```
      */
     remember<T>(key: string, factory: () => T | Promise<T>, ttl?: number): Promise<T>;
+    /**
+     * Async variant of {@link remember}. It uses {@link getValueAsync} and
+     * {@link setAsync} for cooperative yielding around direct-cache
+     * serialization/deserialization.
+     *
+     * @param key - Cache key.
+     * @param factory - Async or sync function that produces the value on a cache miss.
+     * @param ttl - Time-to-live in milliseconds. Defaults to the global TTL.
+     */
+    rememberAsync<T>(key: string, factory: () => T | Promise<T>, ttl?: number): Promise<T>;
     /**
      * Returns the {@link CacheInfo} for a specific cache key, or `null` if the key
      * does not exist or has expired.
@@ -130,6 +158,20 @@ export interface Memorize {
      * ```
      */
     getAll(): Record<string, CacheInfo>;
+    /**
+     * Async variant of {@link getAll}. It scans entries in batches and yields
+     * back to the event loop between batches, which reduces long synchronous
+     * pauses on large stores.
+     *
+     * @param options - Batch options.
+     * @returns All active cache entries keyed by cache key.
+     *
+     * @example
+     * ```ts
+     * const entries = await cache.getAllAsync({ batchSize: 500 });
+     * ```
+     */
+    getAllAsync(options?: MemorizeBatchOptions): Promise<Record<string, CacheInfo>>;
     /**
      * Removes a single entry from the cache and emits a {@link MemorizeEventType.Delete} event.
      *
@@ -171,6 +213,21 @@ export interface Memorize {
      * ```
      */
     deleteMatching(pattern: string): number;
+    /**
+     * Async variant of {@link deleteMatching}. It removes matching entries in
+     * batches and yields back to the event loop between batches, which reduces
+     * long synchronous pauses on large stores.
+     *
+     * @param pattern - Glob pattern to match against cache keys.
+     * @param options - Batch options.
+     * @returns The number of entries removed.
+     *
+     * @example
+     * ```ts
+     * await cache.deleteMatchingAsync('/api/users/*', { batchSize: 500 });
+     * ```
+     */
+    deleteMatchingAsync(pattern: string, options?: MemorizeBatchOptions): Promise<number>;
     /**
      * Removes **all** entries from the cache and emits a {@link MemorizeEventType.Delete}
      * event for each.
@@ -181,6 +238,20 @@ export interface Memorize {
      * ```
      */
     clear(): void;
+    /**
+     * Async variant of {@link clear}. It removes entries in batches and yields
+     * back to the event loop between batches, which reduces long synchronous
+     * pauses on large stores.
+     *
+     * @param options - Batch options.
+     * @returns The number of entries removed.
+     *
+     * @example
+     * ```ts
+     * await cache.clearAsync({ batchSize: 500 });
+     * ```
+     */
+    clearAsync(options?: MemorizeBatchOptions): Promise<number>;
     /**
      * Registers a listener for cache events.
      *

package/dist/domain/Memorize.d.ts.map

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

package/dist/domain/MemorizeBatchOptions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Options for cache operations that can yield between batches to reduce
+ * event-loop blocking on large stores.
+ */
+export interface MemorizeBatchOptions {
+    /**
+     * Number of entries to process before yielding back to the event loop.
+     *
+     * @defaultValue 1000
+     */
+    batchSize?: number;
+}
+//# sourceMappingURL=MemorizeBatchOptions.d.ts.map

package/dist/domain/MemorizeBatchOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemorizeBatchOptions.d.ts","sourceRoot":"","sources":["../../src/domain/MemorizeBatchOptions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/domain/MemorizeBatchOptions.js

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

package/dist/domain/MemorizeBatchOptions.js.map

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

package/dist/domain/MemorizeOptions.d.ts

@@ -26,6 +26,62 @@ export interface MemorizeOptions {
      * ```
      */
     maxEntries?: number;
+    /**
+     * Maximum serialized byte size allowed for a single entry.
+     *
+     * Entries larger than this limit are skipped by default. Set
+     * {@link MemorizeOptions.sizeLimitAction} to `'throw'` to fail instead.
+     */
+    maxValueBytes?: number;
+    /**
+     * Maximum approximate byte size allowed for the whole cache.
+     *
+     * When the limit is reached, least-recently-used entries are evicted until
+     * the new entry fits. Entries larger than this limit are skipped by default.
+     */
+    maxTotalBytes?: number;
+    /**
+     * Behavior when a single entry exceeds `maxValueBytes` or `maxTotalBytes`.
+     *
+     * - `'skip'` — do not store the oversized entry.
+     * - `'throw'` — throw a `RangeError`.
+     *
+     * @defaultValue 'skip'
+     */
+    sizeLimitAction?: 'skip' | 'throw';
+    /**
+     * Async serializer backend used by `setAsync`, `getValueAsync`, and
+     * `rememberAsync`.
+     *
+     * - `'yield'` — yield to the event loop, then serialize on the main thread.
+     * - `'worker'` — offload built-in serializer work to `worker_threads`.
+     *
+     * Custom serializer objects always fall back to `'yield'` because functions
+     * cannot be transferred to a worker.
+     *
+     * @defaultValue 'yield'
+     */
+    asyncSerializer?: 'yield' | 'worker';
+    /**
+     * Maximum number of lazy worker threads used by `asyncSerializer: 'worker'`.
+     *
+     * - `'auto'` — choose a conservative count from available CPU parallelism.
+     * - `number` — requested worker count, clamped to available parallelism and
+     *   an internal safety cap.
+     *
+     * @defaultValue 'auto'
+     */
+    asyncSerializerWorkers?: 'auto' | number;
+    /**
+     * Minimum estimated serialized byte size required before `setAsync` /
+     * `getValueAsync` offloads work to a worker.
+     *
+     * Smaller values use cooperative yielding on the main thread to avoid worker
+     * overhead. Only applies when `asyncSerializer: 'worker'`.
+     *
+     * @defaultValue 65536
+     */
+    asyncSerializerThresholdBytes?: number;
     /**
      * Serializer used by {@link Memorize.set} and {@link Memorize.getValue}.
      *

package/dist/domain/MemorizeOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemorizeOptions.d.ts","sourceRoot":"","sources":["../../src/domain/MemorizeOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B"}
+{"version":3,"file":"MemorizeOptions.d.ts","sourceRoot":"","sources":["../../src/domain/MemorizeOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnC;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAErC;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzC;;;;;;;;OAQG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAC;IAEvC;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B"}

package/dist/domain/MemorizeStats.d.ts

@@ -6,6 +6,10 @@ export interface MemorizeStats {
     entries: number;
     /** Configured maximum number of entries, or `null` if unlimited. */
     maxEntries: number | null;
+    /** Configured maximum byte size for a single entry, or `null` if unlimited. */
+    maxValueBytes: number | null;
+    /** Configured maximum byte size for the whole cache, or `null` if unlimited. */
+    maxTotalBytes: number | null;
     /** Approximate total byte size of all cached bodies. */
     byteSize: number;
 }

package/dist/domain/MemorizeStats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemorizeStats.d.ts","sourceRoot":"","sources":["../../src/domain/MemorizeStats.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"MemorizeStats.d.ts","sourceRoot":"","sources":["../../src/domain/MemorizeStats.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+EAA+E;IAC/E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gFAAgF;IAChF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/domain/index.d.ts

@@ -10,5 +10,6 @@ export type { MemorizeEvictEvent } from './MemorizeEvictEvent';
 export type { MemorizeStats } from './MemorizeStats';
 export type { MemorizeOptions } from './MemorizeOptions';
 export type { MemorizeCallOptions } from './MemorizeCallOptions';
+export type { MemorizeBatchOptions } from './MemorizeBatchOptions';
 export type { Memorize } from './Memorize';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/memorize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memorize.d.ts","sourceRoot":"","sources":["../src/memorize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGnE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAiDhE"}
+{"version":3,"file":"memorize.d.ts","sourceRoot":"","sources":["../src/memorize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAInE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC;AAoC/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAkKhE"}

package/dist/memorize.js

@@ -4,6 +4,44 @@ exports.memorize = memorize;
 const MemorizeStore_1 = require("./MemorizeStore");
 const express_1 = require("./adapters/express");
 const serializer_1 = require("./serializer");
+const asyncSerializer_1 = require("./asyncSerializer");
+function serializedByteSize(body) {
+    return Buffer.isBuffer(body) ? body.byteLength : Buffer.byteLength(body);
+}
+function estimateAsyncInputSize(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 Number.POSITIVE_INFINITY;
+    }
+}
+function normalizeAsyncSerializerThreshold(value) {
+    if (value === undefined)
+        return 64000;
+    if (!Number.isFinite(value) || value < 0) {
+        throw new RangeError('asyncSerializerThresholdBytes must be greater than or equal to 0');
+    }
+    return value;
+}
+function yieldToEventLoop() {
+    return new Promise((resolve) => setImmediate(resolve));
+}
+function nextVersion(versions, key) {
+    var _a;
+    const version = ((_a = versions.get(key)) !== null && _a !== void 0 ? _a : 0) + 1;
+    versions.set(key, version);
+    return version;
+}
 /**
  * Creates an in-memory cache instance.
  *
@@ -55,18 +93,46 @@ const serializer_1 = require("./serializer");
  * ```
  */
 function memorize(options = {}) {
-    const { ttl, maxEntries, serializer: serializerOption } = options;
-    const store = new MemorizeStore_1.MemorizeStore(maxEntries);
+    const { ttl, maxEntries, maxValueBytes, maxTotalBytes, sizeLimitAction, asyncSerializer: asyncSerializerMode = 'yield', asyncSerializerWorkers, asyncSerializerThresholdBytes, serializer: serializerOption, } = options;
+    const store = new MemorizeStore_1.MemorizeStore({ maxEntries, maxValueBytes, maxTotalBytes, sizeLimitAction });
     const serializer = (0, serializer_1.createSerializer)(serializerOption);
+    const workerSerializer = asyncSerializerMode === 'worker'
+        ? (0, asyncSerializer_1.createWorkerAsyncSerializer)(serializerOption, asyncSerializerWorkers)
+        : null;
+    const workerThresholdBytes = normalizeAsyncSerializerThreshold(asyncSerializerThresholdBytes);
     const expressMiddleware = (0, express_1.createExpressMiddleware)(store, ttl);
+    const keyVersions = new Map();
+    const inFlightRemember = new Map();
+    let mutationEpoch = 0;
     const cache = function (callOptions) {
         return expressMiddleware(callOptions);
     };
     cache.express = (callOptions) => expressMiddleware(callOptions);
     cache.set = (key, value, entryTtl) => {
+        nextVersion(keyVersions, key);
         const body = serializer.serialize(value);
         const contentType = Buffer.isBuffer(body) ? 'application/octet-stream' : 'application/json';
-        store.set(key, { body, statusCode: 200, contentType }, entryTtl !== null && entryTtl !== void 0 ? entryTtl : ttl);
+        store.set(key, { body, statusCode: 200, contentType, size: serializedByteSize(body) }, entryTtl !== null && entryTtl !== void 0 ? entryTtl : ttl);
+    };
+    cache.setAsync = async (key, value, entryTtl) => {
+        const version = nextVersion(keyVersions, key);
+        const epoch = mutationEpoch;
+        await yieldToEventLoop();
+        if (!workerSerializer || estimateAsyncInputSize(value) < workerThresholdBytes) {
+            if (keyVersions.get(key) !== version || mutationEpoch !== epoch)
+                return;
+            const body = serializer.serialize(value);
+            if (keyVersions.get(key) !== version || mutationEpoch !== epoch)
+                return;
+            const contentType = Buffer.isBuffer(body) ? 'application/octet-stream' : 'application/json';
+            store.set(key, { body, statusCode: 200, contentType, size: serializedByteSize(body) }, entryTtl !== null && entryTtl !== void 0 ? entryTtl : ttl);
+            return;
+        }
+        const body = await workerSerializer.serialize(value);
+        if (keyVersions.get(key) !== version || mutationEpoch !== epoch)
+            return;
+        const contentType = Buffer.isBuffer(body) ? 'application/octet-stream' : 'application/json';
+        store.set(key, { body, statusCode: 200, contentType, size: serializedByteSize(body) }, entryTtl !== null && entryTtl !== void 0 ? entryTtl : ttl);
     };
     cache.getValue = (key) => {
         const entry = store.getRaw(key);
@@ -79,19 +145,97 @@ function memorize(options = {}) {
             return undefined;
         }
     };
+    cache.getValueAsync = async (key) => {
+        await yieldToEventLoop();
+        if (!workerSerializer)
+            return cache.getValue(key);
+        const entry = store.getRaw(key);
+        if (!entry)
+            return undefined;
+        if (entry.size < workerThresholdBytes) {
+            try {
+                return serializer.deserialize(entry.body);
+            }
+            catch (_a) {
+                return undefined;
+            }
+        }
+        try {
+            return await workerSerializer.deserialize(entry.body);
+        }
+        catch (_b) {
+            return undefined;
+        }
+    };
     cache.remember = async (key, factory, rememberTtl) => {
         const existing = cache.getValue(key);
         if (existing !== undefined)
             return existing;
-        const value = await factory();
-        cache.set(key, value, rememberTtl);
-        return value;
+        const inFlight = inFlightRemember.get(key);
+        if (inFlight)
+            return inFlight;
+        const promise = (async () => {
+            const value = await factory();
+            cache.set(key, value, rememberTtl);
+            return value;
+        })();
+        inFlightRemember.set(key, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            if (inFlightRemember.get(key) === promise) {
+                inFlightRemember.delete(key);
+            }
+        }
+    };
+    cache.rememberAsync = async (key, factory, rememberTtl) => {
+        const existing = await cache.getValueAsync(key);
+        if (existing !== undefined)
+            return existing;
+        const inFlight = inFlightRemember.get(key);
+        if (inFlight)
+            return inFlight;
+        const promise = (async () => {
+            const value = await factory();
+            await cache.setAsync(key, value, rememberTtl);
+            return value;
+        })();
+        inFlightRemember.set(key, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            if (inFlightRemember.get(key) === promise) {
+                inFlightRemember.delete(key);
+            }
+        }
     };
     cache.get = (key) => store.get(key);
     cache.getAll = () => store.getAll();
-    cache.delete = (key) => store.delete(key);
-    cache.deleteMatching = (pattern) => store.deleteMatching(pattern);
-    cache.clear = () => store.clear();
+    cache.getAllAsync = (batchOptions) => store.getAllAsync(batchOptions);
+    cache.delete = (key) => {
+        nextVersion(keyVersions, key);
+        return store.delete(key);
+    };
+    cache.deleteMatching = (pattern) => {
+        mutationEpoch++;
+        return store.deleteMatching(pattern);
+    };
+    cache.deleteMatchingAsync = (pattern, batchOptions) => {
+        mutationEpoch++;
+        return store.deleteMatchingAsync(pattern, batchOptions);
+    };
+    cache.clear = () => {
+        mutationEpoch++;
+        keyVersions.clear();
+        store.clear();
+    };
+    cache.clearAsync = async (batchOptions) => {
+        mutationEpoch++;
+        keyVersions.clear();
+        return store.clearAsync(batchOptions);
+    };
     cache.on = store.on.bind(store);
     cache.size = () => store.size();
     cache.byteSize = () => store.byteSize();

package/dist/memorize.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-memorize",
-  "version": "2.3.1",
+  "version": "2.5.0",
   "description": "In-memory cache middleware for Express.js. Caches GET responses with optional TTL — zero dependencies, fully typed.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -54,6 +54,7 @@
     "test:watch": "jest --watch",
     "prepublishOnly": "npm test && npm run build",
     "bench": "tsx bench/index.ts",
+    "bench:eventloop": "tsx bench/eventloop-only.ts",
     "docs": "typedoc",
     "docs:watch": "typedoc --watch"
   },