cacheable 1.3.0 → 1.6.0

package/README.md

@@ -9,7 +9,7 @@
 [![npm](https://img.shields.io/npm/dm/cacheable.svg)](https://www.npmjs.com/package/cacheable)
 [![npm](https://img.shields.io/npm/v/cacheable)](https://www.npmjs.com/package/cacheable)
 
-`cacheable` is a high performance layer 1 / layer 2 caching engine that is focused on distributed caching with enterprise features such as `CacheSync`. It is built on top of the robust storage engine [Keyv](https://keyv.org) and provides a simple API to cache and retrieve data.
+`cacheable` is a high performance layer 1 / layer 2 caching engine that is focused on distributed caching with enterprise features such as `CacheSync` (coming soon). It is built on top of the robust storage engine [Keyv](https://keyv.org) and provides a simple API to cache and retrieve data.
 
 * Simple to use with robust API
 * Not bloated with additional modules
@@ -25,7 +25,7 @@
 
 ## Getting Started
 
-`cacheable` is primarily used as an extension to you caching engine with a robust storage backend [Keyv](https://keyv.org), Memonization, Hooks, Events, and Statistics.
+`cacheable` is primarily used as an extension to you caching engine with a robust storage backend [Keyv](https://keyv.org), Memonization (Wrap), Hooks, Events, and Statistics.
 
 ```bash
 npm install cacheable
@@ -115,7 +115,6 @@ const cache = new Cacheable({secondary, nonBlocking: true});
 
 `cacheable` has a feature called `CacheSync` that is coming soon. This feature will allow you to have distributed caching with Pub/Sub. This will allow you to have multiple instances of `cacheable` running and when a value is set, deleted, or cleared it will update all instances of `cacheable` with the same value. Current plan is to support the following:
 
-* [Google Pub/Sub](https://cloud.google.com/pubsub)
 * [AWS SQS](https://aws.amazon.com/sqs)
 * [RabbitMQ](https://www.rabbitmq.com)
 * [Nats](https://nats.io)
@@ -153,15 +152,15 @@ _This does not enable statistics for your layer 2 cache as that is a distributed
 
 ## API
 
-* `set(key, value, ttl? | [{string, string, ttl?}])`: Sets a value in the cache.
+* `set(key, value, ttl?)`: Sets a value in the cache.
 * `setMany([{key, value, ttl?}])`: Sets multiple values in the cache.
-* `get(key | [keys])`: Gets a value from the cache.
+* `get(key)`: Gets a value from the cache.
 * `getMany([keys])`: Gets multiple values from the cache.
-* `has(key | [key])`: Checks if a value exists in the cache.
+* `has(key)`: Checks if a value exists in the cache.
 * `hasMany([keys])`: Checks if multiple values exist in the cache.
 * `take(key)`: Takes a value from the cache and deletes it.
 * `takeMany([keys])`: Takes multiple values from the cache and deletes them.
-* `delete(key | [key])`: Deletes a value from the cache.
+* `delete(key)`: Deletes a value from the cache.
 * `deleteMany([keys])`: Deletes multiple values from the cache.
 * `clear()`: Clears the cache stores. Be careful with this as it will clear both layer 1 and layer 2.
 * `wrap(function, options)`: Wraps a function in a cache. (coming soon)
@@ -187,14 +186,23 @@ const options = {
   lruSize: 1000, // the size of the LRU cache (default is 0 which is unlimited)
 }
 const cache = new CacheableMemory(options);
-await cache.set('key', 'value');
-const value = await cache.get('key'); // value
+cache.set('key', 'value');
+const value = cache.get('key'); // value
 ```
 
 You can use `CacheableMemory` as a standalone cache or as a primary store for `cacheable`. You can also set the `useClones` property to `false` if you want to use the same reference for the values. This is useful if you are using large objects and want to save memory. The `lruSize` property is the size of the LRU cache and is set to `0` by default which is unlimited. When setting the `lruSize` property it will limit the number of keys in the cache.
 
 This simple in-memory cache uses multiple Map objects and a with `expiration` and `lru` policies if set to manage the in memory cache at scale.
 
+By default we use lazy expiration deletion which means on `get` and `getMany` type functions we look if it is expired and then delete it. If you want to have a more aggressive expiration policy you can set the `checkInterval` property to a value greater than `0` which will check for expired keys at the interval you set.
+
+### CacheableMemory Options
+
+* `ttl`: The time to live for the cache in milliseconds.
+* `useClones`: If the cache should use clones for the values. Default is `true`.
+* `lruSize`: The size of the LRU cache. Default is `0` which is unlimited.
+* `checkInterval`: The interval to check for expired keys in milliseconds. Default is `0` which is disabled.
+
 ### CacheableMemory API
 
 * `set(key, value, ttl?)`: Sets a value in the cache.
@@ -204,6 +212,9 @@ This simple in-memory cache uses multiple Map objects and a with `expiration` an
 * `clear()`: Clears the cache.
 * `size()`: The number of keys in the cache.
 * `keys()`: The keys in the cache.
+* `checkExpired()`: Checks for expired keys in the cache. This is used by the `checkInterval` property.
+* `startIntervalCheck()`: Starts the interval check for expired keys if `checkInterval` is above 0 ms.
+* `stopIntervalCheck()`: Stops the interval check for expired keys.
 
 
 ## How to Contribute

package/dist/index.cjs

@@ -24,187 +24,13 @@ __export(src_exports, {
   CacheableEvents: () => CacheableEvents,
   CacheableHooks: () => CacheableHooks,
   CacheableMemory: () => CacheableMemory,
-  CacheableStats: () => CacheableStats
+  CacheableStats: () => CacheableStats,
+  KeyvCacheableMemory: () => KeyvCacheableMemory
 });
 module.exports = __toCommonJS(src_exports);
 var import_keyv = require("keyv");
 var import_hookified = require("hookified");
 
-// src/stats.ts
-var CacheableStats = class {
-  _hits = 0;
-  _misses = 0;
-  _gets = 0;
-  _sets = 0;
-  _deletes = 0;
-  _clears = 0;
-  _vsize = 0;
-  _ksize = 0;
-  _count = 0;
-  _enabled = false;
-  constructor(options) {
-    if (options?.enabled) {
-      this._enabled = options.enabled;
-    }
-  }
-  get enabled() {
-    return this._enabled;
-  }
-  set enabled(enabled) {
-    this._enabled = enabled;
-  }
-  get hits() {
-    return this._hits;
-  }
-  get misses() {
-    return this._misses;
-  }
-  get gets() {
-    return this._gets;
-  }
-  get sets() {
-    return this._sets;
-  }
-  get deletes() {
-    return this._deletes;
-  }
-  get clears() {
-    return this._clears;
-  }
-  get vsize() {
-    return this._vsize;
-  }
-  get ksize() {
-    return this._ksize;
-  }
-  get count() {
-    return this._count;
-  }
-  incrementHits() {
-    if (!this._enabled) {
-      return;
-    }
-    this._hits++;
-  }
-  incrementMisses() {
-    if (!this._enabled) {
-      return;
-    }
-    this._misses++;
-  }
-  incrementGets() {
-    if (!this._enabled) {
-      return;
-    }
-    this._gets++;
-  }
-  incrementSets() {
-    if (!this._enabled) {
-      return;
-    }
-    this._sets++;
-  }
-  incrementDeletes() {
-    if (!this._enabled) {
-      return;
-    }
-    this._deletes++;
-  }
-  incrementClears() {
-    if (!this._enabled) {
-      return;
-    }
-    this._clears++;
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  incrementVSize(value) {
-    if (!this._enabled) {
-      return;
-    }
-    this._vsize += this.roughSizeOfObject(value);
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  decreaseVSize(value) {
-    if (!this._enabled) {
-      return;
-    }
-    this._vsize -= this.roughSizeOfObject(value);
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  incrementKSize(key) {
-    if (!this._enabled) {
-      return;
-    }
-    this._ksize += this.roughSizeOfString(key);
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  decreaseKSize(key) {
-    if (!this._enabled) {
-      return;
-    }
-    this._ksize -= this.roughSizeOfString(key);
-  }
-  incrementCount() {
-    if (!this._enabled) {
-      return;
-    }
-    this._count++;
-  }
-  decreaseCount() {
-    if (!this._enabled) {
-      return;
-    }
-    this._count--;
-  }
-  setCount(count) {
-    if (!this._enabled) {
-      return;
-    }
-    this._count = count;
-  }
-  roughSizeOfString(value) {
-    return value.length * 2;
-  }
-  roughSizeOfObject(object) {
-    const objectList = [];
-    const stack = [object];
-    let bytes = 0;
-    while (stack.length > 0) {
-      const value = stack.pop();
-      if (typeof value === "boolean") {
-        bytes += 4;
-      } else if (typeof value === "string") {
-        bytes += value.length * 2;
-      } else if (typeof value === "number") {
-        bytes += 8;
-      } else if (typeof value === "object" && value !== null && !objectList.includes(value)) {
-        objectList.push(value);
-        for (const key in value) {
-          bytes += key.length * 2;
-          stack.push(value[key]);
-        }
-      }
-    }
-    return bytes;
-  }
-  reset() {
-    this._hits = 0;
-    this._misses = 0;
-    this._gets = 0;
-    this._sets = 0;
-    this._deletes = 0;
-    this._clears = 0;
-    this._vsize = 0;
-    this._ksize = 0;
-    this._count = 0;
-  }
-  resetStoreValues() {
-    this._vsize = 0;
-    this._ksize = 0;
-    this._count = 0;
-  }
-};
-
 // src/memory-lru.ts
 var ListNode = class {
   // eslint-disable-next-line @typescript-eslint/parameter-properties
@@ -293,8 +119,15 @@ var CacheableMemory = class {
   _hash9 = /* @__PURE__ */ new Map();
   _lru = new DoublyLinkedList();
   _ttl = 0;
+  // Turned off by default
   _useClone = true;
+  // Turned on by default
   _lruSize = 0;
+  // Turned off by default
+  _checkInterval = 0;
+  // Turned off by default
+  _interval = 0;
+  // Turned off by default
   constructor(options) {
     if (options?.ttl) {
       this._ttl = options.ttl;
@@ -305,6 +138,10 @@ var CacheableMemory = class {
     if (options?.lruSize) {
       this._lruSize = options.lruSize;
     }
+    if (options?.checkInterval) {
+      this._checkInterval = options.checkInterval;
+    }
+    this.startIntervalCheck();
   }
   get ttl() {
     return this._ttl;
@@ -325,6 +162,12 @@ var CacheableMemory = class {
     this._lruSize = value;
     this.lruResize();
   }
+  get checkInterval() {
+    return this._checkInterval;
+  }
+  set checkInterval(value) {
+    this._checkInterval = value;
+  }
   get size() {
     return this._hash0.size + this._hash1.size + this._hash2.size + this._hash3.size + this._hash4.size + this._hash5.size + this._hash6.size + this._hash7.size + this._hash8.size + this._hash9.size;
   }
@@ -482,6 +325,28 @@ var CacheableMemory = class {
       }
     }
   }
+  checkExpiration() {
+    const stores = this.concatStores();
+    for (const item of stores.values()) {
+      if (item.expires && Date.now() > item.expires) {
+        this.delete(item.key);
+      }
+    }
+  }
+  startIntervalCheck() {
+    if (this._checkInterval > 0) {
+      this._interval = setInterval(() => {
+        this.checkExpiration();
+      }, this._checkInterval);
+    }
+  }
+  stopIntervalCheck() {
+    if (this._interval) {
+      clearInterval(this._interval);
+    }
+    this._interval = 0;
+    this._checkInterval = 0;
+  }
   isPrimitive(value) {
     const result = false;
     if (value === null || value === void 0) {
@@ -498,6 +363,236 @@ var CacheableMemory = class {
   }
 };
 
+// src/keyv-memory.ts
+var KeyvCacheableMemory = class {
+  opts = {
+    ttl: 0,
+    useClone: true,
+    lruSize: 0,
+    checkInterval: 0
+  };
+  namespace;
+  _cache = new CacheableMemory();
+  constructor(options) {
+    if (options) {
+      this.opts = options;
+      this._cache = new CacheableMemory(options);
+    }
+  }
+  async get(key) {
+    const result = this._cache.get(key);
+    console.log("result", result);
+    if (result) {
+      return result;
+    }
+    return void 0;
+  }
+  set(key, value, ttl) {
+    this._cache.set(key, value, ttl);
+  }
+  async delete(key) {
+    this._cache.delete(key);
+    return true;
+  }
+  async clear() {
+    this._cache.clear();
+  }
+  async has(key) {
+    return this._cache.has(key);
+  }
+  async getMany(keys) {
+    const result = [];
+    for (const key of keys) {
+      result.push(this._cache.get(key));
+    }
+    return result;
+  }
+  async deleteMany(key) {
+    for (const k of key) {
+      this._cache.delete(k);
+    }
+    return true;
+  }
+  on(event, listener) {
+    return this;
+  }
+};
+
+// src/stats.ts
+var CacheableStats = class {
+  _hits = 0;
+  _misses = 0;
+  _gets = 0;
+  _sets = 0;
+  _deletes = 0;
+  _clears = 0;
+  _vsize = 0;
+  _ksize = 0;
+  _count = 0;
+  _enabled = false;
+  constructor(options) {
+    if (options?.enabled) {
+      this._enabled = options.enabled;
+    }
+  }
+  get enabled() {
+    return this._enabled;
+  }
+  set enabled(enabled) {
+    this._enabled = enabled;
+  }
+  get hits() {
+    return this._hits;
+  }
+  get misses() {
+    return this._misses;
+  }
+  get gets() {
+    return this._gets;
+  }
+  get sets() {
+    return this._sets;
+  }
+  get deletes() {
+    return this._deletes;
+  }
+  get clears() {
+    return this._clears;
+  }
+  get vsize() {
+    return this._vsize;
+  }
+  get ksize() {
+    return this._ksize;
+  }
+  get count() {
+    return this._count;
+  }
+  incrementHits() {
+    if (!this._enabled) {
+      return;
+    }
+    this._hits++;
+  }
+  incrementMisses() {
+    if (!this._enabled) {
+      return;
+    }
+    this._misses++;
+  }
+  incrementGets() {
+    if (!this._enabled) {
+      return;
+    }
+    this._gets++;
+  }
+  incrementSets() {
+    if (!this._enabled) {
+      return;
+    }
+    this._sets++;
+  }
+  incrementDeletes() {
+    if (!this._enabled) {
+      return;
+    }
+    this._deletes++;
+  }
+  incrementClears() {
+    if (!this._enabled) {
+      return;
+    }
+    this._clears++;
+  }
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  incrementVSize(value) {
+    if (!this._enabled) {
+      return;
+    }
+    this._vsize += this.roughSizeOfObject(value);
+  }
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  decreaseVSize(value) {
+    if (!this._enabled) {
+      return;
+    }
+    this._vsize -= this.roughSizeOfObject(value);
+  }
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  incrementKSize(key) {
+    if (!this._enabled) {
+      return;
+    }
+    this._ksize += this.roughSizeOfString(key);
+  }
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  decreaseKSize(key) {
+    if (!this._enabled) {
+      return;
+    }
+    this._ksize -= this.roughSizeOfString(key);
+  }
+  incrementCount() {
+    if (!this._enabled) {
+      return;
+    }
+    this._count++;
+  }
+  decreaseCount() {
+    if (!this._enabled) {
+      return;
+    }
+    this._count--;
+  }
+  setCount(count) {
+    if (!this._enabled) {
+      return;
+    }
+    this._count = count;
+  }
+  roughSizeOfString(value) {
+    return value.length * 2;
+  }
+  roughSizeOfObject(object) {
+    const objectList = [];
+    const stack = [object];
+    let bytes = 0;
+    while (stack.length > 0) {
+      const value = stack.pop();
+      if (typeof value === "boolean") {
+        bytes += 4;
+      } else if (typeof value === "string") {
+        bytes += value.length * 2;
+      } else if (typeof value === "number") {
+        bytes += 8;
+      } else if (typeof value === "object" && value !== null && !objectList.includes(value)) {
+        objectList.push(value);
+        for (const key in value) {
+          bytes += key.length * 2;
+          stack.push(value[key]);
+        }
+      }
+    }
+    return bytes;
+  }
+  reset() {
+    this._hits = 0;
+    this._misses = 0;
+    this._gets = 0;
+    this._sets = 0;
+    this._deletes = 0;
+    this._clears = 0;
+    this._vsize = 0;
+    this._ksize = 0;
+    this._count = 0;
+  }
+  resetStoreValues() {
+    this._vsize = 0;
+    this._ksize = 0;
+    this._count = 0;
+  }
+};
+
 // src/index.ts
 var CacheableHooks = /* @__PURE__ */ ((CacheableHooks2) => {
   CacheableHooks2["BEFORE_SET"] = "BEFORE_SET";
@@ -515,7 +610,7 @@ var CacheableEvents = /* @__PURE__ */ ((CacheableEvents2) => {
   return CacheableEvents2;
 })(CacheableEvents || {});
 var Cacheable = class extends import_hookified.Hookified {
-  _primary = new import_keyv.Keyv({ store: new CacheableMemory() });
+  _primary = new import_keyv.Keyv({ store: new KeyvCacheableMemory() });
   _secondary;
   _nonBlocking = false;
   _ttl;
@@ -823,5 +918,6 @@ var Cacheable = class extends import_hookified.Hookified {
   CacheableEvents,
   CacheableHooks,
   CacheableMemory,
-  CacheableStats
+  CacheableStats,
+  KeyvCacheableMemory
 });

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Keyv, KeyvStoreAdapter } from 'keyv';
+import { KeyvStoreAdapter, StoredData, Keyv } from 'keyv';
 import { Hookified } from 'hookified';
 
 type CacheableOptions$1 = {
@@ -50,6 +50,7 @@ type CacheableMemoryOptions = {
     ttl?: number;
     useClone?: boolean;
     lruSize?: number;
+    checkInterval?: number;
 };
 declare class CacheableMemory {
     private readonly _hashCache;
@@ -67,6 +68,8 @@ declare class CacheableMemory {
     private _ttl;
     private _useClone;
     private _lruSize;
+    private _checkInterval;
+    private _interval;
     constructor(options?: CacheableMemoryOptions);
     get ttl(): number;
     set ttl(value: number);
@@ -74,6 +77,8 @@ declare class CacheableMemory {
     set useClone(value: boolean);
     get lruSize(): number;
     set lruSize(value: number);
+    get checkInterval(): number;
+    set checkInterval(value: number);
     get size(): number;
     get keys(): IterableIterator<string>;
     get<T>(key: string): any;
@@ -88,10 +93,28 @@ declare class CacheableMemory {
     lruAddToFront(key: string): void;
     lruMoveToFront(key: string): void;
     lruResize(): void;
+    checkExpiration(): void;
+    startIntervalCheck(): void;
+    stopIntervalCheck(): void;
     private isPrimitive;
     private concatStores;
 }
 
+declare class KeyvCacheableMemory implements KeyvStoreAdapter {
+    opts: CacheableMemoryOptions;
+    namespace?: string | undefined;
+    private readonly _cache;
+    constructor(options?: CacheableMemoryOptions);
+    get<Value>(key: string): Promise<StoredData<Value> | undefined>;
+    set(key: string, value: any, ttl?: number): void;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    has?(key: string): Promise<boolean>;
+    getMany?<Value>(keys: string[]): Promise<Array<StoredData<Value | undefined>>>;
+    deleteMany?(key: string[]): Promise<boolean>;
+    on(event: string, listener: (...arguments_: any[]) => void): this;
+}
+
 declare enum CacheableHooks {
     BEFORE_SET = "BEFORE_SET",
     AFTER_SET = "AFTER_SET",
@@ -152,4 +175,4 @@ declare class Cacheable extends Hookified {
     private hasManyKeyv;
 }
 
-export { Cacheable, CacheableEvents, CacheableHooks, type CacheableItem, CacheableMemory, type CacheableOptions, CacheableStats };
+export { Cacheable, CacheableEvents, CacheableHooks, type CacheableItem, CacheableMemory, type CacheableOptions, CacheableStats, KeyvCacheableMemory };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Keyv, KeyvStoreAdapter } from 'keyv';
+import { KeyvStoreAdapter, StoredData, Keyv } from 'keyv';
 import { Hookified } from 'hookified';
 
 type CacheableOptions$1 = {
@@ -50,6 +50,7 @@ type CacheableMemoryOptions = {
     ttl?: number;
     useClone?: boolean;
     lruSize?: number;
+    checkInterval?: number;
 };
 declare class CacheableMemory {
     private readonly _hashCache;
@@ -67,6 +68,8 @@ declare class CacheableMemory {
     private _ttl;
     private _useClone;
     private _lruSize;
+    private _checkInterval;
+    private _interval;
     constructor(options?: CacheableMemoryOptions);
     get ttl(): number;
     set ttl(value: number);
@@ -74,6 +77,8 @@ declare class CacheableMemory {
     set useClone(value: boolean);
     get lruSize(): number;
     set lruSize(value: number);
+    get checkInterval(): number;
+    set checkInterval(value: number);
     get size(): number;
     get keys(): IterableIterator<string>;
     get<T>(key: string): any;
@@ -88,10 +93,28 @@ declare class CacheableMemory {
     lruAddToFront(key: string): void;
     lruMoveToFront(key: string): void;
     lruResize(): void;
+    checkExpiration(): void;
+    startIntervalCheck(): void;
+    stopIntervalCheck(): void;
     private isPrimitive;
     private concatStores;
 }
 
+declare class KeyvCacheableMemory implements KeyvStoreAdapter {
+    opts: CacheableMemoryOptions;
+    namespace?: string | undefined;
+    private readonly _cache;
+    constructor(options?: CacheableMemoryOptions);
+    get<Value>(key: string): Promise<StoredData<Value> | undefined>;
+    set(key: string, value: any, ttl?: number): void;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    has?(key: string): Promise<boolean>;
+    getMany?<Value>(keys: string[]): Promise<Array<StoredData<Value | undefined>>>;
+    deleteMany?(key: string[]): Promise<boolean>;
+    on(event: string, listener: (...arguments_: any[]) => void): this;
+}
+
 declare enum CacheableHooks {
     BEFORE_SET = "BEFORE_SET",
     AFTER_SET = "AFTER_SET",
@@ -152,4 +175,4 @@ declare class Cacheable extends Hookified {
     private hasManyKeyv;
 }
 
-export { Cacheable, CacheableEvents, CacheableHooks, type CacheableItem, CacheableMemory, type CacheableOptions, CacheableStats };
+export { Cacheable, CacheableEvents, CacheableHooks, type CacheableItem, CacheableMemory, type CacheableOptions, CacheableStats, KeyvCacheableMemory };

package/dist/index.js

@@ -2,181 +2,6 @@
 import { Keyv } from "keyv";
 import { Hookified } from "hookified";
 
-// src/stats.ts
-var CacheableStats = class {
-  _hits = 0;
-  _misses = 0;
-  _gets = 0;
-  _sets = 0;
-  _deletes = 0;
-  _clears = 0;
-  _vsize = 0;
-  _ksize = 0;
-  _count = 0;
-  _enabled = false;
-  constructor(options) {
-    if (options?.enabled) {
-      this._enabled = options.enabled;
-    }
-  }
-  get enabled() {
-    return this._enabled;
-  }
-  set enabled(enabled) {
-    this._enabled = enabled;
-  }
-  get hits() {
-    return this._hits;
-  }
-  get misses() {
-    return this._misses;
-  }
-  get gets() {
-    return this._gets;
-  }
-  get sets() {
-    return this._sets;
-  }
-  get deletes() {
-    return this._deletes;
-  }
-  get clears() {
-    return this._clears;
-  }
-  get vsize() {
-    return this._vsize;
-  }
-  get ksize() {
-    return this._ksize;
-  }
-  get count() {
-    return this._count;
-  }
-  incrementHits() {
-    if (!this._enabled) {
-      return;
-    }
-    this._hits++;
-  }
-  incrementMisses() {
-    if (!this._enabled) {
-      return;
-    }
-    this._misses++;
-  }
-  incrementGets() {
-    if (!this._enabled) {
-      return;
-    }
-    this._gets++;
-  }
-  incrementSets() {
-    if (!this._enabled) {
-      return;
-    }
-    this._sets++;
-  }
-  incrementDeletes() {
-    if (!this._enabled) {
-      return;
-    }
-    this._deletes++;
-  }
-  incrementClears() {
-    if (!this._enabled) {
-      return;
-    }
-    this._clears++;
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  incrementVSize(value) {
-    if (!this._enabled) {
-      return;
-    }
-    this._vsize += this.roughSizeOfObject(value);
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  decreaseVSize(value) {
-    if (!this._enabled) {
-      return;
-    }
-    this._vsize -= this.roughSizeOfObject(value);
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  incrementKSize(key) {
-    if (!this._enabled) {
-      return;
-    }
-    this._ksize += this.roughSizeOfString(key);
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  decreaseKSize(key) {
-    if (!this._enabled) {
-      return;
-    }
-    this._ksize -= this.roughSizeOfString(key);
-  }
-  incrementCount() {
-    if (!this._enabled) {
-      return;
-    }
-    this._count++;
-  }
-  decreaseCount() {
-    if (!this._enabled) {
-      return;
-    }
-    this._count--;
-  }
-  setCount(count) {
-    if (!this._enabled) {
-      return;
-    }
-    this._count = count;
-  }
-  roughSizeOfString(value) {
-    return value.length * 2;
-  }
-  roughSizeOfObject(object) {
-    const objectList = [];
-    const stack = [object];
-    let bytes = 0;
-    while (stack.length > 0) {
-      const value = stack.pop();
-      if (typeof value === "boolean") {
-        bytes += 4;
-      } else if (typeof value === "string") {
-        bytes += value.length * 2;
-      } else if (typeof value === "number") {
-        bytes += 8;
-      } else if (typeof value === "object" && value !== null && !objectList.includes(value)) {
-        objectList.push(value);
-        for (const key in value) {
-          bytes += key.length * 2;
-          stack.push(value[key]);
-        }
-      }
-    }
-    return bytes;
-  }
-  reset() {
-    this._hits = 0;
-    this._misses = 0;
-    this._gets = 0;
-    this._sets = 0;
-    this._deletes = 0;
-    this._clears = 0;
-    this._vsize = 0;
-    this._ksize = 0;
-    this._count = 0;
-  }
-  resetStoreValues() {
-    this._vsize = 0;
-    this._ksize = 0;
-    this._count = 0;
-  }
-};
-
 // src/memory-lru.ts
 var ListNode = class {
   // eslint-disable-next-line @typescript-eslint/parameter-properties
@@ -265,8 +90,15 @@ var CacheableMemory = class {
   _hash9 = /* @__PURE__ */ new Map();
   _lru = new DoublyLinkedList();
   _ttl = 0;
+  // Turned off by default
   _useClone = true;
+  // Turned on by default
   _lruSize = 0;
+  // Turned off by default
+  _checkInterval = 0;
+  // Turned off by default
+  _interval = 0;
+  // Turned off by default
   constructor(options) {
     if (options?.ttl) {
       this._ttl = options.ttl;
@@ -277,6 +109,10 @@ var CacheableMemory = class {
     if (options?.lruSize) {
       this._lruSize = options.lruSize;
     }
+    if (options?.checkInterval) {
+      this._checkInterval = options.checkInterval;
+    }
+    this.startIntervalCheck();
   }
   get ttl() {
     return this._ttl;
@@ -297,6 +133,12 @@ var CacheableMemory = class {
     this._lruSize = value;
     this.lruResize();
   }
+  get checkInterval() {
+    return this._checkInterval;
+  }
+  set checkInterval(value) {
+    this._checkInterval = value;
+  }
   get size() {
     return this._hash0.size + this._hash1.size + this._hash2.size + this._hash3.size + this._hash4.size + this._hash5.size + this._hash6.size + this._hash7.size + this._hash8.size + this._hash9.size;
   }
@@ -454,6 +296,28 @@ var CacheableMemory = class {
       }
     }
   }
+  checkExpiration() {
+    const stores = this.concatStores();
+    for (const item of stores.values()) {
+      if (item.expires && Date.now() > item.expires) {
+        this.delete(item.key);
+      }
+    }
+  }
+  startIntervalCheck() {
+    if (this._checkInterval > 0) {
+      this._interval = setInterval(() => {
+        this.checkExpiration();
+      }, this._checkInterval);
+    }
+  }
+  stopIntervalCheck() {
+    if (this._interval) {
+      clearInterval(this._interval);
+    }
+    this._interval = 0;
+    this._checkInterval = 0;
+  }
   isPrimitive(value) {
     const result = false;
     if (value === null || value === void 0) {
@@ -470,6 +334,236 @@ var CacheableMemory = class {
   }
 };
 
+// src/keyv-memory.ts
+var KeyvCacheableMemory = class {
+  opts = {
+    ttl: 0,
+    useClone: true,
+    lruSize: 0,
+    checkInterval: 0
+  };
+  namespace;
+  _cache = new CacheableMemory();
+  constructor(options) {
+    if (options) {
+      this.opts = options;
+      this._cache = new CacheableMemory(options);
+    }
+  }
+  async get(key) {
+    const result = this._cache.get(key);
+    console.log("result", result);
+    if (result) {
+      return result;
+    }
+    return void 0;
+  }
+  set(key, value, ttl) {
+    this._cache.set(key, value, ttl);
+  }
+  async delete(key) {
+    this._cache.delete(key);
+    return true;
+  }
+  async clear() {
+    this._cache.clear();
+  }
+  async has(key) {
+    return this._cache.has(key);
+  }
+  async getMany(keys) {
+    const result = [];
+    for (const key of keys) {
+      result.push(this._cache.get(key));
+    }
+    return result;
+  }
+  async deleteMany(key) {
+    for (const k of key) {
+      this._cache.delete(k);
+    }
+    return true;
+  }
+  on(event, listener) {
+    return this;
+  }
+};
+
+// src/stats.ts
+var CacheableStats = class {
+  _hits = 0;
+  _misses = 0;
+  _gets = 0;
+  _sets = 0;
+  _deletes = 0;
+  _clears = 0;
+  _vsize = 0;
+  _ksize = 0;
+  _count = 0;
+  _enabled = false;
+  constructor(options) {
+    if (options?.enabled) {
+      this._enabled = options.enabled;
+    }
+  }
+  get enabled() {
+    return this._enabled;
+  }
+  set enabled(enabled) {
+    this._enabled = enabled;
+  }
+  get hits() {
+    return this._hits;
+  }
+  get misses() {
+    return this._misses;
+  }
+  get gets() {
+    return this._gets;
+  }
+  get sets() {
+    return this._sets;
+  }
+  get deletes() {
+    return this._deletes;
+  }
+  get clears() {
+    return this._clears;
+  }
+  get vsize() {
+    return this._vsize;
+  }
+  get ksize() {
+    return this._ksize;
+  }
+  get count() {
+    return this._count;
+  }
+  incrementHits() {
+    if (!this._enabled) {
+      return;
+    }
+    this._hits++;
+  }
+  incrementMisses() {
+    if (!this._enabled) {
+      return;
+    }
+    this._misses++;
+  }
+  incrementGets() {
+    if (!this._enabled) {
+      return;
+    }
+    this._gets++;
+  }
+  incrementSets() {
+    if (!this._enabled) {
+      return;
+    }
+    this._sets++;
+  }
+  incrementDeletes() {
+    if (!this._enabled) {
+      return;
+    }
+    this._deletes++;
+  }
+  incrementClears() {
+    if (!this._enabled) {
+      return;
+    }
+    this._clears++;
+  }
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  incrementVSize(value) {
+    if (!this._enabled) {
+      return;
+    }
+    this._vsize += this.roughSizeOfObject(value);
+  }
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  decreaseVSize(value) {
+    if (!this._enabled) {
+      return;
+    }
+    this._vsize -= this.roughSizeOfObject(value);
+  }
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  incrementKSize(key) {
+    if (!this._enabled) {
+      return;
+    }
+    this._ksize += this.roughSizeOfString(key);
+  }
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  decreaseKSize(key) {
+    if (!this._enabled) {
+      return;
+    }
+    this._ksize -= this.roughSizeOfString(key);
+  }
+  incrementCount() {
+    if (!this._enabled) {
+      return;
+    }
+    this._count++;
+  }
+  decreaseCount() {
+    if (!this._enabled) {
+      return;
+    }
+    this._count--;
+  }
+  setCount(count) {
+    if (!this._enabled) {
+      return;
+    }
+    this._count = count;
+  }
+  roughSizeOfString(value) {
+    return value.length * 2;
+  }
+  roughSizeOfObject(object) {
+    const objectList = [];
+    const stack = [object];
+    let bytes = 0;
+    while (stack.length > 0) {
+      const value = stack.pop();
+      if (typeof value === "boolean") {
+        bytes += 4;
+      } else if (typeof value === "string") {
+        bytes += value.length * 2;
+      } else if (typeof value === "number") {
+        bytes += 8;
+      } else if (typeof value === "object" && value !== null && !objectList.includes(value)) {
+        objectList.push(value);
+        for (const key in value) {
+          bytes += key.length * 2;
+          stack.push(value[key]);
+        }
+      }
+    }
+    return bytes;
+  }
+  reset() {
+    this._hits = 0;
+    this._misses = 0;
+    this._gets = 0;
+    this._sets = 0;
+    this._deletes = 0;
+    this._clears = 0;
+    this._vsize = 0;
+    this._ksize = 0;
+    this._count = 0;
+  }
+  resetStoreValues() {
+    this._vsize = 0;
+    this._ksize = 0;
+    this._count = 0;
+  }
+};
+
 // src/index.ts
 var CacheableHooks = /* @__PURE__ */ ((CacheableHooks2) => {
   CacheableHooks2["BEFORE_SET"] = "BEFORE_SET";
@@ -487,7 +581,7 @@ var CacheableEvents = /* @__PURE__ */ ((CacheableEvents2) => {
   return CacheableEvents2;
 })(CacheableEvents || {});
 var Cacheable = class extends Hookified {
-  _primary = new Keyv({ store: new CacheableMemory() });
+  _primary = new Keyv({ store: new KeyvCacheableMemory() });
   _secondary;
   _nonBlocking = false;
   _ttl;
@@ -794,5 +888,6 @@ export {
   CacheableEvents,
   CacheableHooks,
   CacheableMemory,
-  CacheableStats
+  CacheableStats,
+  KeyvCacheableMemory
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cacheable",
-  "version": "1.3.0",
+  "version": "1.6.0",
   "description": "Simple Caching Engine using Keyv",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -18,6 +18,7 @@
   "private": false,
   "devDependencies": {
     "@keyv/redis": "^3.0.1",
+    "@types/node": "^22.6.1",
     "@vitest/coverage-v8": "^2.1.1",
     "lru-cache": "^11.0.1",
     "rimraf": "^6.0.1",