cacheable 1.8.4 → 1.8.6

package/README.md

@@ -1,8 +1,6 @@
 [<img align="center" src="https://cacheable.org/logo.svg" alt="Cacheable" />](https://github.com/jaredwray/cacheable)
 
-# Cacheable
-
-> Simple Caching Engine using Keyv
+> High Performance Layer 1 / Layer 2 Caching with Keyv Storage
 
 [![codecov](https://codecov.io/gh/jaredwray/cacheable/graph/badge.svg?token=lWZ9OBQ7GM)](https://codecov.io/gh/jaredwray/cacheable)
 [![tests](https://github.com/jaredwray/cacheable/actions/workflows/tests.yml/badge.svg)](https://github.com/jaredwray/cacheable/actions/workflows/tests.yml)
@@ -347,11 +345,24 @@ const cache = new CacheableMemory();
 const wrappedFunction = cache.wrap(syncFunction, { ttl: '1h', key: 'syncFunction' });
 console.log(wrappedFunction(2)); // 4
 console.log(wrappedFunction(2)); // 4 from cache
-console.log(cache.get('syncFunction')); // 4
 ```
 
 In this example we are wrapping a `sync` function in a cache with a `ttl` of `1 hour`. This will cache the result of the function for `1 hour` and then expire the value. You can also set the `key` property in the `wrap()` options to set a custom key for the cache.
 
+When an error occurs in the function it will not cache the value and will return the error. This is useful if you want to cache the results of a function but not cache the error. If you want it to cache the error you can set the `cacheError` property to `true` in the `wrap()` options. This is disabled by default.
+
+```javascript
+import { CacheableMemory } from 'cacheable';
+const syncFunction = (value: number) => {
+  throw new Error('error');
+};
+
+const cache = new CacheableMemory();
+const wrappedFunction = cache.wrap(syncFunction, { ttl: '1h', key: 'syncFunction', cacheError: true });
+console.log(wrappedFunction()); // error
+console.log(wrappedFunction()); // error from cache
+```
+
 # Keyv Storage Adapter - KeyvCacheableMemory
 
 `cacheable` comes with a built-in storage adapter for Keyv called `KeyvCacheableMemory`. This takes `CacheableMemory` and creates a storage adapter for Keyv. This is useful if you want to use `CacheableMemory` as a storage adapter for Keyv. Here is an example of how to use `KeyvCacheableMemory`:
@@ -362,7 +373,7 @@ import { KeyvCacheableMemory } from 'cacheable';
 
 const keyv = new Keyv({ store: new KeyvCacheableMemory() });
 await keyv.set('foo', 'bar');
-const value = await keyv.get('key');
+const value = await keyv.get('foo');
 console.log(value); // bar 
 ```
 

package/dist/index.cjs

@@ -35,17 +35,18 @@ __export(src_exports, {
   CacheableHooks: () => CacheableHooks,
   CacheableMemory: () => CacheableMemory,
   CacheableStats: () => CacheableStats,
-  Keyv: () => import_keyv2.Keyv,
+  Keyv: () => import_keyv3.Keyv,
   KeyvCacheableMemory: () => KeyvCacheableMemory,
-  KeyvHooks: () => import_keyv2.KeyvHooks,
+  KeyvHooks: () => import_keyv3.KeyvHooks,
+  createKeyv: () => createKeyv,
   shorthandToMilliseconds: () => shorthandToMilliseconds,
   shorthandToTime: () => shorthandToTime,
   wrap: () => wrap,
   wrapSync: () => wrapSync
 });
 module.exports = __toCommonJS(src_exports);
-var import_keyv = require("keyv");
-var import_hookified = require("hookified");
+var import_keyv2 = require("keyv");
+var import_hookified2 = require("hookified");
 
 // src/shorthand-time.ts
 var shorthandToMilliseconds = (shorthand) => {
@@ -114,6 +115,12 @@ var shorthandToTime = (shorthand, fromDate) => {
   return fromDate.getTime() + milliseconds;
 };
 
+// src/keyv-memory.ts
+var import_keyv = require("keyv");
+
+// src/memory.ts
+var import_hookified = require("hookified");
+
 // src/hash.ts
 var crypto = __toESM(require("crypto"), 1);
 function hash(object, algorithm = "sha256") {
@@ -188,8 +195,15 @@ function wrapSync(function_, options) {
     const cacheKey = createWrapKey(function_, arguments_, keyPrefix);
     let value = cache.get(cacheKey);
     if (value === void 0) {
-      value = function_(...arguments_);
-      cache.set(cacheKey, value, ttl);
+      try {
+        value = function_(...arguments_);
+        cache.set(cacheKey, value, ttl);
+      } catch (error) {
+        cache.emit("error", error);
+        if (options.cacheErrors) {
+          cache.set(cacheKey, error, ttl);
+        }
+      }
     }
     return value;
   };
@@ -198,17 +212,21 @@ function wrap(function_, options) {
   const { ttl, keyPrefix, cache } = options;
   return async function(...arguments_) {
     let value;
-    try {
-      const cacheKey = createWrapKey(function_, arguments_, keyPrefix);
-      value = await cache.get(cacheKey);
-      if (value === void 0) {
-        value = await coalesceAsync(cacheKey, async () => {
+    const cacheKey = createWrapKey(function_, arguments_, keyPrefix);
+    value = await cache.get(cacheKey);
+    if (value === void 0) {
+      value = await coalesceAsync(cacheKey, async () => {
+        try {
           const result = await function_(...arguments_);
           await cache.set(cacheKey, result, ttl);
           return result;
-        });
-      }
-    } catch {
+        } catch (error) {
+          cache.emit("error", error);
+          if (options.cacheErrors) {
+            await cache.set(cacheKey, error, ttl);
+          }
+        }
+      });
     }
     return value;
   };
@@ -294,7 +312,7 @@ var DoublyLinkedList = class {
 };
 
 // src/memory.ts
-var CacheableMemory = class {
+var CacheableMemory = class extends import_hookified.Hookified {
   _lru = new DoublyLinkedList();
   _hashCache = /* @__PURE__ */ new Map();
   _hash0 = /* @__PURE__ */ new Map();
@@ -322,6 +340,7 @@ var CacheableMemory = class {
    * @param {CacheableMemoryOptions} [options] - The options for the CacheableMemory
    */
   constructor(options) {
+    super();
     if (options?.ttl) {
       this.setTtl(options.ttl);
     }
@@ -481,7 +500,8 @@ var CacheableMemory = class {
    * Sets the value of the key
    * @param {string} key - The key to set the value
    * @param {any} value - The value to set
-   * @param {number|string} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
+   * @param {number|string|SetOptions} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
+   * If you want to set expire directly you can do that by setting the expire property in the SetOptions.
    * If you set undefined, it will use the default time-to-live. If both are undefined then it will not have a time-to-live.
    * @returns {void}
    */
@@ -489,9 +509,21 @@ var CacheableMemory = class {
     const store = this.getStore(key);
     let expires;
     if (ttl !== void 0 || this._ttl !== void 0) {
-      const finalTtl = shorthandToTime(ttl ?? this._ttl);
-      if (finalTtl !== void 0) {
-        expires = finalTtl;
+      if (typeof ttl === "object") {
+        if (ttl.expire) {
+          expires = typeof ttl.expire === "number" ? ttl.expire : ttl.expire.getTime();
+        }
+        if (ttl.ttl) {
+          const finalTtl = shorthandToTime(ttl.ttl);
+          if (finalTtl !== void 0) {
+            expires = finalTtl;
+          }
+        }
+      } else {
+        const finalTtl = shorthandToTime(ttl ?? this._ttl);
+        if (finalTtl !== void 0) {
+          expires = finalTtl;
+        }
       }
     }
     if (this._lruSize > 0) {
@@ -742,9 +774,12 @@ var CacheableMemory = class {
    */
   startIntervalCheck() {
     if (this._checkInterval > 0) {
+      if (this._interval) {
+        clearInterval(this._interval);
+      }
       this._interval = setInterval(() => {
         this.checkExpiration();
-      }, this._checkInterval);
+      }, this._checkInterval).unref();
     }
   }
   /**
@@ -867,6 +902,7 @@ var KeyvCacheableMemory = class {
     return this.getStore(this._namespace).has(key);
   }
   on(event, listener) {
+    this.getStore(this._namespace).on(event, listener);
     return this;
   }
   getStore(namespace) {
@@ -879,6 +915,18 @@ var KeyvCacheableMemory = class {
     return this._nCache.get(namespace);
   }
 };
+function createKeyv(options) {
+  const store = new KeyvCacheableMemory(options);
+  const namespace = options?.namespace;
+  let ttl;
+  if (options?.ttl && Number.isInteger(options.ttl)) {
+    ttl = options?.ttl;
+  }
+  const keyv = new import_keyv.Keyv({ store, namespace, ttl });
+  keyv.serialize = void 0;
+  keyv.deserialize = void 0;
+  return keyv;
+}
 
 // src/stats.ts
 var CacheableStats = class {
@@ -1098,7 +1146,7 @@ var CacheableStats = class {
 };
 
 // src/index.ts
-var import_keyv2 = require("keyv");
+var import_keyv3 = require("keyv");
 var CacheableHooks = /* @__PURE__ */ ((CacheableHooks2) => {
   CacheableHooks2["BEFORE_SET"] = "BEFORE_SET";
   CacheableHooks2["AFTER_SET"] = "AFTER_SET";
@@ -1114,8 +1162,8 @@ var CacheableEvents = /* @__PURE__ */ ((CacheableEvents2) => {
   CacheableEvents2["ERROR"] = "error";
   return CacheableEvents2;
 })(CacheableEvents || {});
-var Cacheable = class extends import_hookified.Hookified {
-  _primary = new import_keyv.Keyv({ store: new KeyvCacheableMemory() });
+var Cacheable = class extends import_hookified2.Hookified {
+  _primary = createKeyv();
   _secondary;
   _nonBlocking = false;
   _ttl;
@@ -1274,7 +1322,10 @@ var Cacheable = class extends import_hookified.Hookified {
    * @returns {void}
    */
   setPrimary(primary) {
-    this._primary = primary instanceof import_keyv.Keyv ? primary : new import_keyv.Keyv(primary);
+    this._primary = primary instanceof import_keyv2.Keyv ? primary : new import_keyv2.Keyv(primary);
+    this._primary.on("error", (error) => {
+      this.emit("error" /* ERROR */, error);
+    });
   }
   /**
    * Sets the secondary store for the cacheable instance. If it is set to undefined then the secondary store is disabled.
@@ -1282,7 +1333,10 @@ var Cacheable = class extends import_hookified.Hookified {
    * @returns {void}
    */
   setSecondary(secondary) {
-    this._secondary = secondary instanceof import_keyv.Keyv ? secondary : new import_keyv.Keyv(secondary);
+    this._secondary = secondary instanceof import_keyv2.Keyv ? secondary : new import_keyv2.Keyv(secondary);
+    this._secondary.on("error", (error) => {
+      this.emit("error" /* ERROR */, error);
+    });
   }
   getNameSpace() {
     if (typeof this._namespace === "function") {
@@ -1643,6 +1697,7 @@ var Cacheable = class extends import_hookified.Hookified {
   Keyv,
   KeyvCacheableMemory,
   KeyvHooks,
+  createKeyv,
   shorthandToMilliseconds,
   shorthandToTime,
   wrap,

package/dist/index.d.cts

@@ -112,6 +112,7 @@ type CacheableStoreItem = {
 type WrapFunctionOptions = {
     ttl?: number | string;
     keyPrefix?: string;
+    cacheErrors?: boolean;
 };
 type WrapOptions = WrapFunctionOptions & {
     cache: Cacheable;
@@ -138,7 +139,11 @@ type CacheableMemoryOptions = {
     lruSize?: number;
     checkInterval?: number;
 };
-declare class CacheableMemory {
+type SetOptions = {
+    ttl?: number | string;
+    expire?: number | Date;
+};
+declare class CacheableMemory extends Hookified {
     private _lru;
     private readonly _hashCache;
     private readonly _hash0;
@@ -244,11 +249,12 @@ declare class CacheableMemory {
      * Sets the value of the key
      * @param {string} key - The key to set the value
      * @param {any} value - The value to set
-     * @param {number|string} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
+     * @param {number|string|SetOptions} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
+     * If you want to set expire directly you can do that by setting the expire property in the SetOptions.
      * If you set undefined, it will use the default time-to-live. If both are undefined then it will not have a time-to-live.
      * @returns {void}
      */
-    set(key: string, value: any, ttl?: number | string): void;
+    set(key: string, value: any, ttl?: number | string | SetOptions): void;
     /**
      * Sets the values of the keys
      * @param {CacheableItem[]} items - The items to set
@@ -398,6 +404,12 @@ declare class KeyvCacheableMemory implements KeyvStoreAdapter {
     on(event: string, listener: (...arguments_: any[]) => void): this;
     getStore(namespace?: string): CacheableMemory;
 }
+/**
+ * Creates a new Keyv instance with a new KeyvCacheableMemory store. This also removes the serialize/deserialize methods from the Keyv instance for optimization.
+ * @param options
+ * @returns
+ */
+declare function createKeyv(options?: KeyvCacheableMemoryOptions): Keyv;
 
 declare const shorthandToMilliseconds: (shorthand?: string | number) => number | undefined;
 declare const shorthandToTime: (shorthand?: string | number, fromDate?: Date) => number;
@@ -635,4 +647,4 @@ declare class Cacheable extends Hookified {
     private setTtl;
 }
 
-export { Cacheable, CacheableEvents, CacheableHooks, type CacheableItem, CacheableMemory, type CacheableMemoryOptions, type CacheableOptions, CacheableStats, KeyvCacheableMemory, type WrapOptions, type WrapSyncOptions, shorthandToMilliseconds, shorthandToTime, wrap, wrapSync };
+export { Cacheable, CacheableEvents, CacheableHooks, type CacheableItem, CacheableMemory, type CacheableMemoryOptions, type CacheableOptions, CacheableStats, KeyvCacheableMemory, type WrapOptions, type WrapSyncOptions, createKeyv, shorthandToMilliseconds, shorthandToTime, wrap, wrapSync };

package/dist/index.d.ts

@@ -112,6 +112,7 @@ type CacheableStoreItem = {
 type WrapFunctionOptions = {
     ttl?: number | string;
     keyPrefix?: string;
+    cacheErrors?: boolean;
 };
 type WrapOptions = WrapFunctionOptions & {
     cache: Cacheable;
@@ -138,7 +139,11 @@ type CacheableMemoryOptions = {
     lruSize?: number;
     checkInterval?: number;
 };
-declare class CacheableMemory {
+type SetOptions = {
+    ttl?: number | string;
+    expire?: number | Date;
+};
+declare class CacheableMemory extends Hookified {
     private _lru;
     private readonly _hashCache;
     private readonly _hash0;
@@ -244,11 +249,12 @@ declare class CacheableMemory {
      * Sets the value of the key
      * @param {string} key - The key to set the value
      * @param {any} value - The value to set
-     * @param {number|string} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
+     * @param {number|string|SetOptions} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
+     * If you want to set expire directly you can do that by setting the expire property in the SetOptions.
      * If you set undefined, it will use the default time-to-live. If both are undefined then it will not have a time-to-live.
      * @returns {void}
      */
-    set(key: string, value: any, ttl?: number | string): void;
+    set(key: string, value: any, ttl?: number | string | SetOptions): void;
     /**
      * Sets the values of the keys
      * @param {CacheableItem[]} items - The items to set
@@ -398,6 +404,12 @@ declare class KeyvCacheableMemory implements KeyvStoreAdapter {
     on(event: string, listener: (...arguments_: any[]) => void): this;
     getStore(namespace?: string): CacheableMemory;
 }
+/**
+ * Creates a new Keyv instance with a new KeyvCacheableMemory store. This also removes the serialize/deserialize methods from the Keyv instance for optimization.
+ * @param options
+ * @returns
+ */
+declare function createKeyv(options?: KeyvCacheableMemoryOptions): Keyv;
 
 declare const shorthandToMilliseconds: (shorthand?: string | number) => number | undefined;
 declare const shorthandToTime: (shorthand?: string | number, fromDate?: Date) => number;
@@ -635,4 +647,4 @@ declare class Cacheable extends Hookified {
     private setTtl;
 }
 
-export { Cacheable, CacheableEvents, CacheableHooks, type CacheableItem, CacheableMemory, type CacheableMemoryOptions, type CacheableOptions, CacheableStats, KeyvCacheableMemory, type WrapOptions, type WrapSyncOptions, shorthandToMilliseconds, shorthandToTime, wrap, wrapSync };
+export { Cacheable, CacheableEvents, CacheableHooks, type CacheableItem, CacheableMemory, type CacheableMemoryOptions, type CacheableOptions, CacheableStats, KeyvCacheableMemory, type WrapOptions, type WrapSyncOptions, createKeyv, shorthandToMilliseconds, shorthandToTime, wrap, wrapSync };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
-import { Keyv } from "keyv";
-import { Hookified } from "hookified";
+import { Keyv as Keyv2 } from "keyv";
+import { Hookified as Hookified2 } from "hookified";
 
 // src/shorthand-time.ts
 var shorthandToMilliseconds = (shorthand) => {
@@ -69,6 +69,14 @@ var shorthandToTime = (shorthand, fromDate) => {
   return fromDate.getTime() + milliseconds;
 };
 
+// src/keyv-memory.ts
+import {
+  Keyv
+} from "keyv";
+
+// src/memory.ts
+import { Hookified } from "hookified";
+
 // src/hash.ts
 import * as crypto from "node:crypto";
 function hash(object, algorithm = "sha256") {
@@ -143,8 +151,15 @@ function wrapSync(function_, options) {
     const cacheKey = createWrapKey(function_, arguments_, keyPrefix);
     let value = cache.get(cacheKey);
     if (value === void 0) {
-      value = function_(...arguments_);
-      cache.set(cacheKey, value, ttl);
+      try {
+        value = function_(...arguments_);
+        cache.set(cacheKey, value, ttl);
+      } catch (error) {
+        cache.emit("error", error);
+        if (options.cacheErrors) {
+          cache.set(cacheKey, error, ttl);
+        }
+      }
     }
     return value;
   };
@@ -153,17 +168,21 @@ function wrap(function_, options) {
   const { ttl, keyPrefix, cache } = options;
   return async function(...arguments_) {
     let value;
-    try {
-      const cacheKey = createWrapKey(function_, arguments_, keyPrefix);
-      value = await cache.get(cacheKey);
-      if (value === void 0) {
-        value = await coalesceAsync(cacheKey, async () => {
+    const cacheKey = createWrapKey(function_, arguments_, keyPrefix);
+    value = await cache.get(cacheKey);
+    if (value === void 0) {
+      value = await coalesceAsync(cacheKey, async () => {
+        try {
           const result = await function_(...arguments_);
           await cache.set(cacheKey, result, ttl);
           return result;
-        });
-      }
-    } catch {
+        } catch (error) {
+          cache.emit("error", error);
+          if (options.cacheErrors) {
+            await cache.set(cacheKey, error, ttl);
+          }
+        }
+      });
     }
     return value;
   };
@@ -249,7 +268,7 @@ var DoublyLinkedList = class {
 };
 
 // src/memory.ts
-var CacheableMemory = class {
+var CacheableMemory = class extends Hookified {
   _lru = new DoublyLinkedList();
   _hashCache = /* @__PURE__ */ new Map();
   _hash0 = /* @__PURE__ */ new Map();
@@ -277,6 +296,7 @@ var CacheableMemory = class {
    * @param {CacheableMemoryOptions} [options] - The options for the CacheableMemory
    */
   constructor(options) {
+    super();
     if (options?.ttl) {
       this.setTtl(options.ttl);
     }
@@ -436,7 +456,8 @@ var CacheableMemory = class {
    * Sets the value of the key
    * @param {string} key - The key to set the value
    * @param {any} value - The value to set
-   * @param {number|string} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
+   * @param {number|string|SetOptions} [ttl] - Time to Live - If you set a number it is miliseconds, if you set a string it is a human-readable.
+   * If you want to set expire directly you can do that by setting the expire property in the SetOptions.
    * If you set undefined, it will use the default time-to-live. If both are undefined then it will not have a time-to-live.
    * @returns {void}
    */
@@ -444,9 +465,21 @@ var CacheableMemory = class {
     const store = this.getStore(key);
     let expires;
     if (ttl !== void 0 || this._ttl !== void 0) {
-      const finalTtl = shorthandToTime(ttl ?? this._ttl);
-      if (finalTtl !== void 0) {
-        expires = finalTtl;
+      if (typeof ttl === "object") {
+        if (ttl.expire) {
+          expires = typeof ttl.expire === "number" ? ttl.expire : ttl.expire.getTime();
+        }
+        if (ttl.ttl) {
+          const finalTtl = shorthandToTime(ttl.ttl);
+          if (finalTtl !== void 0) {
+            expires = finalTtl;
+          }
+        }
+      } else {
+        const finalTtl = shorthandToTime(ttl ?? this._ttl);
+        if (finalTtl !== void 0) {
+          expires = finalTtl;
+        }
       }
     }
     if (this._lruSize > 0) {
@@ -697,9 +730,12 @@ var CacheableMemory = class {
    */
   startIntervalCheck() {
     if (this._checkInterval > 0) {
+      if (this._interval) {
+        clearInterval(this._interval);
+      }
       this._interval = setInterval(() => {
         this.checkExpiration();
-      }, this._checkInterval);
+      }, this._checkInterval).unref();
     }
   }
   /**
@@ -822,6 +858,7 @@ var KeyvCacheableMemory = class {
     return this.getStore(this._namespace).has(key);
   }
   on(event, listener) {
+    this.getStore(this._namespace).on(event, listener);
     return this;
   }
   getStore(namespace) {
@@ -834,6 +871,18 @@ var KeyvCacheableMemory = class {
     return this._nCache.get(namespace);
   }
 };
+function createKeyv(options) {
+  const store = new KeyvCacheableMemory(options);
+  const namespace = options?.namespace;
+  let ttl;
+  if (options?.ttl && Number.isInteger(options.ttl)) {
+    ttl = options?.ttl;
+  }
+  const keyv = new Keyv({ store, namespace, ttl });
+  keyv.serialize = void 0;
+  keyv.deserialize = void 0;
+  return keyv;
+}
 
 // src/stats.ts
 var CacheableStats = class {
@@ -1055,7 +1104,7 @@ var CacheableStats = class {
 // src/index.ts
 import {
   KeyvHooks,
-  Keyv as Keyv2
+  Keyv as Keyv3
 } from "keyv";
 var CacheableHooks = /* @__PURE__ */ ((CacheableHooks2) => {
   CacheableHooks2["BEFORE_SET"] = "BEFORE_SET";
@@ -1072,8 +1121,8 @@ var CacheableEvents = /* @__PURE__ */ ((CacheableEvents2) => {
   CacheableEvents2["ERROR"] = "error";
   return CacheableEvents2;
 })(CacheableEvents || {});
-var Cacheable = class extends Hookified {
-  _primary = new Keyv({ store: new KeyvCacheableMemory() });
+var Cacheable = class extends Hookified2 {
+  _primary = createKeyv();
   _secondary;
   _nonBlocking = false;
   _ttl;
@@ -1232,7 +1281,10 @@ var Cacheable = class extends Hookified {
    * @returns {void}
    */
   setPrimary(primary) {
-    this._primary = primary instanceof Keyv ? primary : new Keyv(primary);
+    this._primary = primary instanceof Keyv2 ? primary : new Keyv2(primary);
+    this._primary.on("error", (error) => {
+      this.emit("error" /* ERROR */, error);
+    });
   }
   /**
    * Sets the secondary store for the cacheable instance. If it is set to undefined then the secondary store is disabled.
@@ -1240,7 +1292,10 @@ var Cacheable = class extends Hookified {
    * @returns {void}
    */
   setSecondary(secondary) {
-    this._secondary = secondary instanceof Keyv ? secondary : new Keyv(secondary);
+    this._secondary = secondary instanceof Keyv2 ? secondary : new Keyv2(secondary);
+    this._secondary.on("error", (error) => {
+      this.emit("error" /* ERROR */, error);
+    });
   }
   getNameSpace() {
     if (typeof this._namespace === "function") {
@@ -1597,9 +1652,10 @@ export {
   CacheableHooks,
   CacheableMemory,
   CacheableStats,
-  Keyv2 as Keyv,
+  Keyv3 as Keyv,
   KeyvCacheableMemory,
   KeyvHooks,
+  createKeyv,
   shorthandToMilliseconds,
   shorthandToTime,
   wrap,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cacheable",
-  "version": "1.8.4",
-  "description": "Simple Caching Engine using Keyv",
+  "version": "1.8.6",
+  "description": "High Performance Layer 1 / Layer 2 Caching with Keyv Storage",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -21,18 +21,18 @@
   "license": "MIT",
   "private": false,
   "devDependencies": {
-    "@keyv/redis": "^3.0.1",
-    "@types/node": "^22.9.0",
-    "@vitest/coverage-v8": "^2.1.4",
+    "@keyv/redis": "^4.0.2",
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.8",
     "lru-cache": "^11.0.2",
     "rimraf": "^6.0.1",
     "tsup": "^8.3.5",
-    "typescript": "^5.6.3",
-    "vitest": "^2.1.4",
-    "xo": "^0.59.3"
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "xo": "^0.60.0"
   },
   "dependencies": {
-    "hookified": "^1.5.0",
+    "hookified": "^1.5.1",
     "keyv": "^5.2.1"
   },
   "keywords": [
@@ -67,6 +67,7 @@
   ],
   "scripts": {
     "build": "rimraf ./dist && tsup src/index.ts --format cjs,esm --dts --clean",
+    "prepublish": "pnpm build",
     "test": "xo --fix && vitest run --coverage",
     "test:ci": "xo && vitest run",
     "clean": "rimraf ./dist ./coverage ./node_modules"