keyv 5.4.0 → 5.5.1

package/README.md

@@ -49,6 +49,8 @@ There are a few existing modules similar to Keyv, however Keyv is different beca
 	- [.setMany(entries)](#setmanyentries)
 	- [.get(key, [options])](#getkey-options)
 	- [.getMany(keys, [options])](#getmanykeys-options)
+  - [.getRaw(key)](#getrawkey)
+  - [.getManyRaw(keys)](#getmanyrawkeys)
 	- [.delete(key)](#deletekey)
 	- [.deleteMany(keys)](#deletemanykeys)
 	- [.clear()](#clear)
@@ -469,7 +471,7 @@ Returns a promise which resolves to the retrieved value.
 
 Returns a promise which resolves to an array of retrieved values.
 
-### options.raw
+### options.raw - (Will be deprecated in v6)
 
 Type: `Boolean`<br />
 Default: `false`
@@ -478,6 +480,16 @@ If set to true the raw DB object Keyv stores internally will be returned instead
 
 This contains the TTL timestamp.
 
+NOTE: This option will be deprecated in v6 and replaced with `.getRaw()` and `.getManyRaw()` methods.
+
+## .getRaw(key)
+
+Returns a promise which resolves to the raw stored data for the key or `undefined` if the key does not exist or is expired.
+
+## .getManyRaw(keys)
+
+Returns a promise which resolves to an array of raw stored data for the keys or `undefined` if the key does not exist or is expired.
+
 ## .delete(key)
 
 Deletes an entry.

package/dist/index.cjs

@@ -49,7 +49,9 @@ var EventManager = class {
     const listeners = this._eventListeners.get(event);
     if (listeners) {
       if (listeners.length >= this._maxListeners) {
-        console.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event} listeners added. Use setMaxListeners() to increase limit.`);
+        console.warn(
+          `MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event} listeners added. Use setMaxListeners() to increase limit.`
+        );
       }
       listeners.push(listener);
     }
@@ -77,6 +79,7 @@ var EventManager = class {
     this.on(event, onceListener);
   }
   // Emit an event
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   emit(event, ...arguments_) {
     const listeners = this._eventListeners.get(event);
     if (listeners && listeners.length > 0) {
@@ -131,6 +134,7 @@ var HooksManager = class extends event_manager_default {
     }
   }
   // Triggers all handlers for a specific event with provided data
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   trigger(event, data) {
     const eventHandlers = this._hookHandlers.get(event);
     if (eventHandlers) {
@@ -138,7 +142,12 @@ var HooksManager = class extends event_manager_default {
         try {
           handler(data);
         } catch (error) {
-          this.emit("error", new Error(`Error in hook handler for event "${event}": ${error.message}`));
+          this.emit(
+            "error",
+            new Error(
+              `Error in hook handler for event "${event}": ${error.message}`
+            )
+          );
         }
       }
     }
@@ -185,6 +194,15 @@ var StatsManager = class extends event_manager_default {
       this.deletes++;
     }
   }
+  hitsOrMisses(array) {
+    for (const item of array) {
+      if (item === void 0) {
+        this.miss();
+      } else {
+        this.hit();
+      }
+    }
+  }
   reset() {
     this.hits = 0;
     this.misses = 0;
@@ -203,6 +221,10 @@ var KeyvHooks = /* @__PURE__ */ ((KeyvHooks2) => {
   KeyvHooks2["POST_GET"] = "postGet";
   KeyvHooks2["PRE_GET_MANY"] = "preGetMany";
   KeyvHooks2["POST_GET_MANY"] = "postGetMany";
+  KeyvHooks2["PRE_GET_RAW"] = "preGetRaw";
+  KeyvHooks2["POST_GET_RAW"] = "postGetRaw";
+  KeyvHooks2["PRE_GET_MANY_RAW"] = "preGetManyRaw";
+  KeyvHooks2["POST_GET_MANY_RAW"] = "postGetManyRaw";
   KeyvHooks2["PRE_DELETE"] = "preDelete";
   KeyvHooks2["POST_DELETE"] = "postDelete";
   return KeyvHooks2;
@@ -232,6 +254,7 @@ var Keyv = class extends event_manager_default {
   /**
    * Store
    */
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   _store = /* @__PURE__ */ new Map();
   _serialize = import_serialize.defaultSerialize;
   _deserialize = import_serialize.defaultDeserialize;
@@ -280,9 +303,14 @@ var Keyv = class extends event_manager_default {
       }
       this._store.namespace = this._namespace;
       if (typeof this._store[Symbol.iterator] === "function" && this._store instanceof Map) {
-        this.iterator = this.generateIterator(this._store);
+        this.iterator = this.generateIterator(
+          this._store
+        );
       } else if ("iterator" in this._store && this._store.opts && this._checkIterableAdapter()) {
-        this.iterator = this.generateIterator(this._store.iterator.bind(this._store));
+        this.iterator = this.generateIterator(
+          // biome-ignore lint/style/noNonNullAssertion: need to fix
+          this._store.iterator.bind(this._store)
+        );
       }
     }
     if (this.opts.stats) {
@@ -301,6 +329,7 @@ var Keyv = class extends event_manager_default {
   /**
    * Get the current store
    */
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   get store() {
     return this._store;
   }
@@ -308,6 +337,7 @@ var Keyv = class extends event_manager_default {
    * Set the current store. This will also set the namespace, event error handler, and generate the iterator. If the store is not valid it will throw an error.
    * @param {KeyvStoreAdapter | Map<any, any> | any} store the store to set
    */
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   set store(store) {
     if (this._isValidStorageAdapter(store)) {
       this._store = store;
@@ -319,9 +349,11 @@ var Keyv = class extends event_manager_default {
         this._store.namespace = this._namespace;
       }
       if (typeof store[Symbol.iterator] === "function" && store instanceof Map) {
-        this.iterator = this.generateIterator(store);
+        this.iterator = this.generateIterator(
+          store
+        );
       } else if ("iterator" in store && store.opts && this._checkIterableAdapter()) {
-        this.iterator = this.generateIterator(store.iterator.bind(store));
+        this.iterator = this.generateIterator(store.iterator?.bind(store));
       }
     } else {
       throw new Error("Invalid storage adapter");
@@ -453,7 +485,9 @@ var Keyv = class extends event_manager_default {
     return function_.bind(this);
   }
   _checkIterableAdapter() {
-    return iterableAdapters.includes(this._store.opts.dialect) || iterableAdapters.some((element) => this._store.opts.url.includes(element));
+    return iterableAdapters.includes(this._store.opts.dialect) || iterableAdapters.some(
+      (element) => this._store.opts.url.includes(element)
+    );
   }
   _getKeyPrefix(key) {
     if (!this._useKeyPrefix) {
@@ -479,6 +513,7 @@ var Keyv = class extends event_manager_default {
     }
     return key.split(":").splice(1).join(":");
   }
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   _isValidStorageAdapter(store) {
     return store instanceof Map || typeof store.get === "function" && typeof store.set === "function" && typeof store.delete === "function" && typeof store.clear === "function";
   }
@@ -513,7 +548,10 @@ var Keyv = class extends event_manager_default {
       this.stats.miss();
       return void 0;
     }
-    this.hooks.trigger("postGet" /* POST_GET */, { key: keyPrefixed, value: deserializedData });
+    this.hooks.trigger("postGet" /* POST_GET */, {
+      key: keyPrefixed,
+      value: deserializedData
+    });
     this.stats.hit();
     return options?.raw ? deserializedData : deserializedData.value;
   }
@@ -536,7 +574,10 @@ var Keyv = class extends event_manager_default {
         return options?.raw ? deserializedRow : deserializedRow.value;
       });
       const deserializedRows = await Promise.allSettled(promises);
-      const result2 = deserializedRows.map((row) => row.value);
+      const result2 = deserializedRows.map(
+        // biome-ignore lint/suspicious/noExplicitAny: type format
+        (row) => row.value
+      );
       this.hooks.trigger("postGetMany" /* POST_GET_MANY */, result2);
       if (result2.length > 0) {
         this.stats.hit();
@@ -572,6 +613,95 @@ var Keyv = class extends event_manager_default {
     }
     return result;
   }
+  /**
+   * Get the raw value of a key. This is the replacement for setting raw to true in the get() method.
+   * @param {string} key the key to get
+   * @returns {Promise<StoredDataRaw<Value> | undefined>} will return a StoredDataRaw<Value> or undefined if the key does not exist or is expired.
+   */
+  async getRaw(key) {
+    const { store } = this.opts;
+    const keyPrefixed = this._getKeyPrefix(key);
+    this.hooks.trigger("preGetRaw" /* PRE_GET_RAW */, { key: keyPrefixed });
+    const rawData = await store.get(keyPrefixed);
+    if (rawData === void 0 || rawData === null) {
+      this.stats.miss();
+      return void 0;
+    }
+    const deserializedData = typeof rawData === "string" || this.opts.compression ? await this.deserializeData(rawData) : rawData;
+    if (deserializedData !== void 0 && deserializedData.expires !== void 0 && deserializedData.expires !== null && // biome-ignore lint/style/noNonNullAssertion: need to fix
+    deserializedData.expires < Date.now()) {
+      this.stats.miss();
+      await this.delete(key);
+      return void 0;
+    }
+    this.stats.hit();
+    this.hooks.trigger("postGetRaw" /* POST_GET_RAW */, {
+      key: keyPrefixed,
+      value: deserializedData
+    });
+    return deserializedData;
+  }
+  /**
+   * Get the raw values of many keys. This is the replacement for setting raw to true in the getMany() method.
+   * @param {string[]} keys the keys to get
+   * @returns {Promise<Array<StoredDataRaw<Value>>>} will return an array of StoredDataRaw<Value> or undefined if the key does not exist or is expired.
+   */
+  async getManyRaw(keys) {
+    const { store } = this.opts;
+    const keyPrefixed = this._getKeyPrefixArray(keys);
+    if (keys.length === 0) {
+      const result2 = Array.from({ length: keys.length }).fill(
+        void 0
+      );
+      this.stats.misses += keys.length;
+      this.hooks.trigger("postGetManyRaw" /* POST_GET_MANY_RAW */, {
+        keys: keyPrefixed,
+        values: result2
+      });
+      return result2;
+    }
+    let result = [];
+    if (store.getMany === void 0) {
+      const promises = keyPrefixed.map(async (key) => {
+        const rawData = await store.get(key);
+        if (rawData !== void 0 && rawData !== null) {
+          return this.deserializeData(rawData);
+        }
+        return void 0;
+      });
+      const deserializedRows = await Promise.allSettled(promises);
+      result = deserializedRows.map(
+        // biome-ignore lint/suspicious/noExplicitAny: type format
+        (row) => row.value
+      );
+    } else {
+      const rawData = await store.getMany(keyPrefixed);
+      for (const row of rawData) {
+        if (row !== void 0 && row !== null) {
+          result.push(await this.deserializeData(row));
+        } else {
+          result.push(void 0);
+        }
+      }
+    }
+    const expiredKeys = [];
+    const isDataExpired = (data) => typeof data.expires === "number" && Date.now() > data.expires;
+    for (const [index, row] of result.entries()) {
+      if (row !== void 0 && isDataExpired(row)) {
+        expiredKeys.push(keyPrefixed[index]);
+        result[index] = void 0;
+      }
+    }
+    if (expiredKeys.length > 0) {
+      await this.deleteMany(expiredKeys);
+    }
+    this.stats.hitsOrMisses(result);
+    this.hooks.trigger("postGetManyRaw" /* POST_GET_MANY_RAW */, {
+      keys: keyPrefixed,
+      values: result
+    });
+    return result;
+  }
   /**
    * Set an item to the store
    * @param {string | Array<KeyvEntry>} key the key to use. If you pass in an array of KeyvEntry it will set many items
@@ -608,7 +738,11 @@ var Keyv = class extends event_manager_default {
         throw error;
       }
     }
-    this.hooks.trigger("postSet" /* POST_SET */, { key: keyPrefixed, value: serializedValue, ttl });
+    this.hooks.trigger("postSet" /* POST_SET */, {
+      key: keyPrefixed,
+      value: serializedValue,
+      ttl
+    });
     this.stats.set();
     return result;
   }
@@ -617,6 +751,7 @@ var Keyv = class extends event_manager_default {
    * @param {Array<KeyvEntry>} entries the entries to set
    * @returns {boolean[]} will return an array of booleans if it sets then it will return a true. On failure will return false.
    */
+  // biome-ignore lint/correctness/noUnusedVariables: type format
   async setMany(entries) {
     let results = [];
     try {
@@ -628,20 +763,22 @@ var Keyv = class extends event_manager_default {
         const promiseResults = await Promise.all(promises);
         results = promiseResults;
       } else {
-        const serializedEntries = await Promise.all(entries.map(async ({ key, value, ttl }) => {
-          ttl ??= this._ttl;
-          if (ttl === 0) {
-            ttl = void 0;
-          }
-          const expires = typeof ttl === "number" ? Date.now() + ttl : void 0;
-          if (typeof value === "symbol") {
-            this.emit("error", "symbol cannot be serialized");
-            throw new Error("symbol cannot be serialized");
-          }
-          const formattedValue = { value, expires };
-          const serializedValue = await this.serializeData(formattedValue);
-          return { key, value: serializedValue, ttl };
-        }));
+        const serializedEntries = await Promise.all(
+          entries.map(async ({ key, value, ttl }) => {
+            ttl ??= this._ttl;
+            if (ttl === 0) {
+              ttl = void 0;
+            }
+            const expires = typeof ttl === "number" ? Date.now() + ttl : void 0;
+            if (typeof value === "symbol") {
+              this.emit("error", "symbol cannot be serialized");
+              throw new Error("symbol cannot be serialized");
+            }
+            const formattedValue = { value, expires };
+            const serializedValue = await this.serializeData(formattedValue);
+            return { key, value: serializedValue, ttl };
+          })
+        );
         results = await this._store.setMany(serializedEntries);
       }
     } catch (error) {
@@ -678,7 +815,10 @@ var Keyv = class extends event_manager_default {
         throw error;
       }
     }
-    this.hooks.trigger("postDelete" /* POST_DELETE */, { key: keyPrefixed, value: result });
+    this.hooks.trigger("postDelete" /* POST_DELETE */, {
+      key: keyPrefixed,
+      value: result
+    });
     this.stats.delete();
     return result;
   }
@@ -698,7 +838,10 @@ var Keyv = class extends event_manager_default {
       const promises = keyPrefixed.map(async (key) => store.delete(key));
       const results = await Promise.all(promises);
       const returnResult = results.every(Boolean);
-      this.hooks.trigger("postDelete" /* POST_DELETE */, { key: keyPrefixed, value: returnResult });
+      this.hooks.trigger("postDelete" /* POST_DELETE */, {
+        key: keyPrefixed,
+        value: returnResult
+      });
       return returnResult;
     } catch (error) {
       this.emit("error", error);
@@ -782,6 +925,7 @@ var Keyv = class extends event_manager_default {
       return store.disconnect();
     }
   }
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   emit(event, ...arguments_) {
     if (event === "error" && !this.opts.emitErrors) {
       return;
@@ -793,7 +937,10 @@ var Keyv = class extends event_manager_default {
       return data;
     }
     if (this._compression?.compress) {
-      return this._serialize({ value: await this._compression.compress(data.value), expires: data.expires });
+      return this._serialize({
+        value: await this._compression.compress(data.value),
+        expires: data.expires
+      });
     }
     return this._serialize(data);
   }
@@ -803,7 +950,10 @@ var Keyv = class extends event_manager_default {
     }
     if (this._compression?.decompress && typeof data === "string") {
       const result = await this._deserialize(data);
-      return { value: await this._compression.decompress(result?.value), expires: result?.expires };
+      return {
+        value: await this._compression.decompress(result?.value),
+        expires: result?.expires
+      };
     }
     if (typeof data === "string") {
       return this._deserialize(data);

package/dist/index.d.cts

@@ -37,6 +37,7 @@ declare class StatsManager extends EventManager {
     miss(): void;
     set(): void;
     delete(): void;
+    hitsOrMisses<T>(array: Array<T | undefined>): void;
     reset(): void;
 }
 
@@ -59,6 +60,10 @@ declare enum KeyvHooks {
     POST_GET = "postGet",
     PRE_GET_MANY = "preGetMany",
     POST_GET_MANY = "postGetMany",
+    PRE_GET_RAW = "preGetRaw",
+    POST_GET_RAW = "postGetRaw",
+    PRE_GET_MANY_RAW = "preGetManyRaw",
+    POST_GET_MANY_RAW = "postGetManyRaw",
     PRE_DELETE = "preDelete",
     POST_DELETE = "postDelete"
 }
@@ -105,12 +110,12 @@ type KeyvOptions = {
     /**
      * Emit errors
      * @default true
-    */
+     */
     emitErrors?: boolean;
     /**
      * Namespace for the current instance.
      * @default 'keyv'
-    */
+     */
     namespace?: string;
     /**
      * A custom serialization function.
@@ -120,7 +125,7 @@ type KeyvOptions = {
     /**
      * A custom deserialization function.
      * @default defaultDeserialize using JSON.parse
-    */
+     */
     deserialize?: Deserialize;
     /**
      * The storage adapter instance to be used by Keyv.
@@ -153,8 +158,8 @@ type KeyvOptions = {
      */
     throwOnErrors?: boolean;
 };
-type KeyvOptions_ = Omit<KeyvOptions, 'store'> & {
-    store: KeyvStoreAdapter | Map<any, any> & KeyvStoreAdapter;
+type KeyvOptions_ = Omit<KeyvOptions, "store"> & {
+    store: KeyvStoreAdapter | (Map<any, any> & KeyvStoreAdapter);
 };
 type IteratorFunction = (argument: any) => AsyncGenerator<any, void>;
 declare class Keyv<GenericValue = any> extends EventManager {
@@ -184,7 +189,7 @@ declare class Keyv<GenericValue = any> extends EventManager {
      * @param {KeyvStoreAdapter | KeyvOptions | Map<any, any>} store  to be provided or just the options
      * @param {Omit<KeyvOptions, 'store'>} [options] if you provide the store you can then provide the Keyv Options
      */
-    constructor(store?: KeyvStoreAdapter | KeyvOptions | Map<any, any>, options?: Omit<KeyvOptions, 'store'>);
+    constructor(store?: KeyvStoreAdapter | KeyvOptions | Map<any, any>, options?: Omit<KeyvOptions, "store">);
     /**
      * Keyv Constructor
      * @param {KeyvOptions} options to be provided
@@ -304,6 +309,18 @@ declare class Keyv<GenericValue = any> extends EventManager {
     getMany<Value = GenericValue>(keys: string[], options?: {
         raw: true;
     }): Promise<Array<StoredDataRaw<Value>>>;
+    /**
+     * Get the raw value of a key. This is the replacement for setting raw to true in the get() method.
+     * @param {string} key the key to get
+     * @returns {Promise<StoredDataRaw<Value> | undefined>} will return a StoredDataRaw<Value> or undefined if the key does not exist or is expired.
+     */
+    getRaw<Value = GenericValue>(key: string): Promise<StoredDataRaw<Value> | undefined>;
+    /**
+     * Get the raw values of many keys. This is the replacement for setting raw to true in the getMany() method.
+     * @param {string[]} keys the keys to get
+     * @returns {Promise<Array<StoredDataRaw<Value>>>} will return an array of StoredDataRaw<Value> or undefined if the key does not exist or is expired.
+     */
+    getManyRaw<Value = GenericValue>(keys: string[]): Promise<Array<StoredDataRaw<Value>>>;
     /**
      * Set an item to the store
      * @param {string | Array<KeyvEntry>} key the key to use. If you pass in an array of KeyvEntry it will set many items

package/dist/index.d.ts

@@ -37,6 +37,7 @@ declare class StatsManager extends EventManager {
     miss(): void;
     set(): void;
     delete(): void;
+    hitsOrMisses<T>(array: Array<T | undefined>): void;
     reset(): void;
 }
 
@@ -59,6 +60,10 @@ declare enum KeyvHooks {
     POST_GET = "postGet",
     PRE_GET_MANY = "preGetMany",
     POST_GET_MANY = "postGetMany",
+    PRE_GET_RAW = "preGetRaw",
+    POST_GET_RAW = "postGetRaw",
+    PRE_GET_MANY_RAW = "preGetManyRaw",
+    POST_GET_MANY_RAW = "postGetManyRaw",
     PRE_DELETE = "preDelete",
     POST_DELETE = "postDelete"
 }
@@ -105,12 +110,12 @@ type KeyvOptions = {
     /**
      * Emit errors
      * @default true
-    */
+     */
     emitErrors?: boolean;
     /**
      * Namespace for the current instance.
      * @default 'keyv'
-    */
+     */
     namespace?: string;
     /**
      * A custom serialization function.
@@ -120,7 +125,7 @@ type KeyvOptions = {
     /**
      * A custom deserialization function.
      * @default defaultDeserialize using JSON.parse
-    */
+     */
     deserialize?: Deserialize;
     /**
      * The storage adapter instance to be used by Keyv.
@@ -153,8 +158,8 @@ type KeyvOptions = {
      */
     throwOnErrors?: boolean;
 };
-type KeyvOptions_ = Omit<KeyvOptions, 'store'> & {
-    store: KeyvStoreAdapter | Map<any, any> & KeyvStoreAdapter;
+type KeyvOptions_ = Omit<KeyvOptions, "store"> & {
+    store: KeyvStoreAdapter | (Map<any, any> & KeyvStoreAdapter);
 };
 type IteratorFunction = (argument: any) => AsyncGenerator<any, void>;
 declare class Keyv<GenericValue = any> extends EventManager {
@@ -184,7 +189,7 @@ declare class Keyv<GenericValue = any> extends EventManager {
      * @param {KeyvStoreAdapter | KeyvOptions | Map<any, any>} store  to be provided or just the options
      * @param {Omit<KeyvOptions, 'store'>} [options] if you provide the store you can then provide the Keyv Options
      */
-    constructor(store?: KeyvStoreAdapter | KeyvOptions | Map<any, any>, options?: Omit<KeyvOptions, 'store'>);
+    constructor(store?: KeyvStoreAdapter | KeyvOptions | Map<any, any>, options?: Omit<KeyvOptions, "store">);
     /**
      * Keyv Constructor
      * @param {KeyvOptions} options to be provided
@@ -304,6 +309,18 @@ declare class Keyv<GenericValue = any> extends EventManager {
     getMany<Value = GenericValue>(keys: string[], options?: {
         raw: true;
     }): Promise<Array<StoredDataRaw<Value>>>;
+    /**
+     * Get the raw value of a key. This is the replacement for setting raw to true in the get() method.
+     * @param {string} key the key to get
+     * @returns {Promise<StoredDataRaw<Value> | undefined>} will return a StoredDataRaw<Value> or undefined if the key does not exist or is expired.
+     */
+    getRaw<Value = GenericValue>(key: string): Promise<StoredDataRaw<Value> | undefined>;
+    /**
+     * Get the raw values of many keys. This is the replacement for setting raw to true in the getMany() method.
+     * @param {string[]} keys the keys to get
+     * @returns {Promise<Array<StoredDataRaw<Value>>>} will return an array of StoredDataRaw<Value> or undefined if the key does not exist or is expired.
+     */
+    getManyRaw<Value = GenericValue>(keys: string[]): Promise<Array<StoredDataRaw<Value>>>;
     /**
      * Set an item to the store
      * @param {string | Array<KeyvEntry>} key the key to use. If you pass in an array of KeyvEntry it will set many items

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-import { defaultSerialize, defaultDeserialize } from "@keyv/serialize";
+import { defaultDeserialize, defaultSerialize } from "@keyv/serialize";
 
 // src/event-manager.ts
 var EventManager = class {
@@ -23,7 +23,9 @@ var EventManager = class {
     const listeners = this._eventListeners.get(event);
     if (listeners) {
       if (listeners.length >= this._maxListeners) {
-        console.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event} listeners added. Use setMaxListeners() to increase limit.`);
+        console.warn(
+          `MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event} listeners added. Use setMaxListeners() to increase limit.`
+        );
       }
       listeners.push(listener);
     }
@@ -51,6 +53,7 @@ var EventManager = class {
     this.on(event, onceListener);
   }
   // Emit an event
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   emit(event, ...arguments_) {
     const listeners = this._eventListeners.get(event);
     if (listeners && listeners.length > 0) {
@@ -105,6 +108,7 @@ var HooksManager = class extends event_manager_default {
     }
   }
   // Triggers all handlers for a specific event with provided data
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   trigger(event, data) {
     const eventHandlers = this._hookHandlers.get(event);
     if (eventHandlers) {
@@ -112,7 +116,12 @@ var HooksManager = class extends event_manager_default {
         try {
           handler(data);
         } catch (error) {
-          this.emit("error", new Error(`Error in hook handler for event "${event}": ${error.message}`));
+          this.emit(
+            "error",
+            new Error(
+              `Error in hook handler for event "${event}": ${error.message}`
+            )
+          );
         }
       }
     }
@@ -159,6 +168,15 @@ var StatsManager = class extends event_manager_default {
       this.deletes++;
     }
   }
+  hitsOrMisses(array) {
+    for (const item of array) {
+      if (item === void 0) {
+        this.miss();
+      } else {
+        this.hit();
+      }
+    }
+  }
   reset() {
     this.hits = 0;
     this.misses = 0;
@@ -177,6 +195,10 @@ var KeyvHooks = /* @__PURE__ */ ((KeyvHooks2) => {
   KeyvHooks2["POST_GET"] = "postGet";
   KeyvHooks2["PRE_GET_MANY"] = "preGetMany";
   KeyvHooks2["POST_GET_MANY"] = "postGetMany";
+  KeyvHooks2["PRE_GET_RAW"] = "preGetRaw";
+  KeyvHooks2["POST_GET_RAW"] = "postGetRaw";
+  KeyvHooks2["PRE_GET_MANY_RAW"] = "preGetManyRaw";
+  KeyvHooks2["POST_GET_MANY_RAW"] = "postGetManyRaw";
   KeyvHooks2["PRE_DELETE"] = "preDelete";
   KeyvHooks2["POST_DELETE"] = "postDelete";
   return KeyvHooks2;
@@ -206,6 +228,7 @@ var Keyv = class extends event_manager_default {
   /**
    * Store
    */
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   _store = /* @__PURE__ */ new Map();
   _serialize = defaultSerialize;
   _deserialize = defaultDeserialize;
@@ -254,9 +277,14 @@ var Keyv = class extends event_manager_default {
       }
       this._store.namespace = this._namespace;
       if (typeof this._store[Symbol.iterator] === "function" && this._store instanceof Map) {
-        this.iterator = this.generateIterator(this._store);
+        this.iterator = this.generateIterator(
+          this._store
+        );
       } else if ("iterator" in this._store && this._store.opts && this._checkIterableAdapter()) {
-        this.iterator = this.generateIterator(this._store.iterator.bind(this._store));
+        this.iterator = this.generateIterator(
+          // biome-ignore lint/style/noNonNullAssertion: need to fix
+          this._store.iterator.bind(this._store)
+        );
       }
     }
     if (this.opts.stats) {
@@ -275,6 +303,7 @@ var Keyv = class extends event_manager_default {
   /**
    * Get the current store
    */
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   get store() {
     return this._store;
   }
@@ -282,6 +311,7 @@ var Keyv = class extends event_manager_default {
    * Set the current store. This will also set the namespace, event error handler, and generate the iterator. If the store is not valid it will throw an error.
    * @param {KeyvStoreAdapter | Map<any, any> | any} store the store to set
    */
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   set store(store) {
     if (this._isValidStorageAdapter(store)) {
       this._store = store;
@@ -293,9 +323,11 @@ var Keyv = class extends event_manager_default {
         this._store.namespace = this._namespace;
       }
       if (typeof store[Symbol.iterator] === "function" && store instanceof Map) {
-        this.iterator = this.generateIterator(store);
+        this.iterator = this.generateIterator(
+          store
+        );
       } else if ("iterator" in store && store.opts && this._checkIterableAdapter()) {
-        this.iterator = this.generateIterator(store.iterator.bind(store));
+        this.iterator = this.generateIterator(store.iterator?.bind(store));
       }
     } else {
       throw new Error("Invalid storage adapter");
@@ -427,7 +459,9 @@ var Keyv = class extends event_manager_default {
     return function_.bind(this);
   }
   _checkIterableAdapter() {
-    return iterableAdapters.includes(this._store.opts.dialect) || iterableAdapters.some((element) => this._store.opts.url.includes(element));
+    return iterableAdapters.includes(this._store.opts.dialect) || iterableAdapters.some(
+      (element) => this._store.opts.url.includes(element)
+    );
   }
   _getKeyPrefix(key) {
     if (!this._useKeyPrefix) {
@@ -453,6 +487,7 @@ var Keyv = class extends event_manager_default {
     }
     return key.split(":").splice(1).join(":");
   }
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   _isValidStorageAdapter(store) {
     return store instanceof Map || typeof store.get === "function" && typeof store.set === "function" && typeof store.delete === "function" && typeof store.clear === "function";
   }
@@ -487,7 +522,10 @@ var Keyv = class extends event_manager_default {
       this.stats.miss();
       return void 0;
     }
-    this.hooks.trigger("postGet" /* POST_GET */, { key: keyPrefixed, value: deserializedData });
+    this.hooks.trigger("postGet" /* POST_GET */, {
+      key: keyPrefixed,
+      value: deserializedData
+    });
     this.stats.hit();
     return options?.raw ? deserializedData : deserializedData.value;
   }
@@ -510,7 +548,10 @@ var Keyv = class extends event_manager_default {
         return options?.raw ? deserializedRow : deserializedRow.value;
       });
       const deserializedRows = await Promise.allSettled(promises);
-      const result2 = deserializedRows.map((row) => row.value);
+      const result2 = deserializedRows.map(
+        // biome-ignore lint/suspicious/noExplicitAny: type format
+        (row) => row.value
+      );
       this.hooks.trigger("postGetMany" /* POST_GET_MANY */, result2);
       if (result2.length > 0) {
         this.stats.hit();
@@ -546,6 +587,95 @@ var Keyv = class extends event_manager_default {
     }
     return result;
   }
+  /**
+   * Get the raw value of a key. This is the replacement for setting raw to true in the get() method.
+   * @param {string} key the key to get
+   * @returns {Promise<StoredDataRaw<Value> | undefined>} will return a StoredDataRaw<Value> or undefined if the key does not exist or is expired.
+   */
+  async getRaw(key) {
+    const { store } = this.opts;
+    const keyPrefixed = this._getKeyPrefix(key);
+    this.hooks.trigger("preGetRaw" /* PRE_GET_RAW */, { key: keyPrefixed });
+    const rawData = await store.get(keyPrefixed);
+    if (rawData === void 0 || rawData === null) {
+      this.stats.miss();
+      return void 0;
+    }
+    const deserializedData = typeof rawData === "string" || this.opts.compression ? await this.deserializeData(rawData) : rawData;
+    if (deserializedData !== void 0 && deserializedData.expires !== void 0 && deserializedData.expires !== null && // biome-ignore lint/style/noNonNullAssertion: need to fix
+    deserializedData.expires < Date.now()) {
+      this.stats.miss();
+      await this.delete(key);
+      return void 0;
+    }
+    this.stats.hit();
+    this.hooks.trigger("postGetRaw" /* POST_GET_RAW */, {
+      key: keyPrefixed,
+      value: deserializedData
+    });
+    return deserializedData;
+  }
+  /**
+   * Get the raw values of many keys. This is the replacement for setting raw to true in the getMany() method.
+   * @param {string[]} keys the keys to get
+   * @returns {Promise<Array<StoredDataRaw<Value>>>} will return an array of StoredDataRaw<Value> or undefined if the key does not exist or is expired.
+   */
+  async getManyRaw(keys) {
+    const { store } = this.opts;
+    const keyPrefixed = this._getKeyPrefixArray(keys);
+    if (keys.length === 0) {
+      const result2 = Array.from({ length: keys.length }).fill(
+        void 0
+      );
+      this.stats.misses += keys.length;
+      this.hooks.trigger("postGetManyRaw" /* POST_GET_MANY_RAW */, {
+        keys: keyPrefixed,
+        values: result2
+      });
+      return result2;
+    }
+    let result = [];
+    if (store.getMany === void 0) {
+      const promises = keyPrefixed.map(async (key) => {
+        const rawData = await store.get(key);
+        if (rawData !== void 0 && rawData !== null) {
+          return this.deserializeData(rawData);
+        }
+        return void 0;
+      });
+      const deserializedRows = await Promise.allSettled(promises);
+      result = deserializedRows.map(
+        // biome-ignore lint/suspicious/noExplicitAny: type format
+        (row) => row.value
+      );
+    } else {
+      const rawData = await store.getMany(keyPrefixed);
+      for (const row of rawData) {
+        if (row !== void 0 && row !== null) {
+          result.push(await this.deserializeData(row));
+        } else {
+          result.push(void 0);
+        }
+      }
+    }
+    const expiredKeys = [];
+    const isDataExpired = (data) => typeof data.expires === "number" && Date.now() > data.expires;
+    for (const [index, row] of result.entries()) {
+      if (row !== void 0 && isDataExpired(row)) {
+        expiredKeys.push(keyPrefixed[index]);
+        result[index] = void 0;
+      }
+    }
+    if (expiredKeys.length > 0) {
+      await this.deleteMany(expiredKeys);
+    }
+    this.stats.hitsOrMisses(result);
+    this.hooks.trigger("postGetManyRaw" /* POST_GET_MANY_RAW */, {
+      keys: keyPrefixed,
+      values: result
+    });
+    return result;
+  }
   /**
    * Set an item to the store
    * @param {string | Array<KeyvEntry>} key the key to use. If you pass in an array of KeyvEntry it will set many items
@@ -582,7 +712,11 @@ var Keyv = class extends event_manager_default {
         throw error;
       }
     }
-    this.hooks.trigger("postSet" /* POST_SET */, { key: keyPrefixed, value: serializedValue, ttl });
+    this.hooks.trigger("postSet" /* POST_SET */, {
+      key: keyPrefixed,
+      value: serializedValue,
+      ttl
+    });
     this.stats.set();
     return result;
   }
@@ -591,6 +725,7 @@ var Keyv = class extends event_manager_default {
    * @param {Array<KeyvEntry>} entries the entries to set
    * @returns {boolean[]} will return an array of booleans if it sets then it will return a true. On failure will return false.
    */
+  // biome-ignore lint/correctness/noUnusedVariables: type format
   async setMany(entries) {
     let results = [];
     try {
@@ -602,20 +737,22 @@ var Keyv = class extends event_manager_default {
         const promiseResults = await Promise.all(promises);
         results = promiseResults;
       } else {
-        const serializedEntries = await Promise.all(entries.map(async ({ key, value, ttl }) => {
-          ttl ??= this._ttl;
-          if (ttl === 0) {
-            ttl = void 0;
-          }
-          const expires = typeof ttl === "number" ? Date.now() + ttl : void 0;
-          if (typeof value === "symbol") {
-            this.emit("error", "symbol cannot be serialized");
-            throw new Error("symbol cannot be serialized");
-          }
-          const formattedValue = { value, expires };
-          const serializedValue = await this.serializeData(formattedValue);
-          return { key, value: serializedValue, ttl };
-        }));
+        const serializedEntries = await Promise.all(
+          entries.map(async ({ key, value, ttl }) => {
+            ttl ??= this._ttl;
+            if (ttl === 0) {
+              ttl = void 0;
+            }
+            const expires = typeof ttl === "number" ? Date.now() + ttl : void 0;
+            if (typeof value === "symbol") {
+              this.emit("error", "symbol cannot be serialized");
+              throw new Error("symbol cannot be serialized");
+            }
+            const formattedValue = { value, expires };
+            const serializedValue = await this.serializeData(formattedValue);
+            return { key, value: serializedValue, ttl };
+          })
+        );
         results = await this._store.setMany(serializedEntries);
       }
     } catch (error) {
@@ -652,7 +789,10 @@ var Keyv = class extends event_manager_default {
         throw error;
       }
     }
-    this.hooks.trigger("postDelete" /* POST_DELETE */, { key: keyPrefixed, value: result });
+    this.hooks.trigger("postDelete" /* POST_DELETE */, {
+      key: keyPrefixed,
+      value: result
+    });
     this.stats.delete();
     return result;
   }
@@ -672,7 +812,10 @@ var Keyv = class extends event_manager_default {
       const promises = keyPrefixed.map(async (key) => store.delete(key));
       const results = await Promise.all(promises);
       const returnResult = results.every(Boolean);
-      this.hooks.trigger("postDelete" /* POST_DELETE */, { key: keyPrefixed, value: returnResult });
+      this.hooks.trigger("postDelete" /* POST_DELETE */, {
+        key: keyPrefixed,
+        value: returnResult
+      });
       return returnResult;
     } catch (error) {
       this.emit("error", error);
@@ -756,6 +899,7 @@ var Keyv = class extends event_manager_default {
       return store.disconnect();
     }
   }
+  // biome-ignore lint/suspicious/noExplicitAny: type format
   emit(event, ...arguments_) {
     if (event === "error" && !this.opts.emitErrors) {
       return;
@@ -767,7 +911,10 @@ var Keyv = class extends event_manager_default {
       return data;
     }
     if (this._compression?.compress) {
-      return this._serialize({ value: await this._compression.compress(data.value), expires: data.expires });
+      return this._serialize({
+        value: await this._compression.compress(data.value),
+        expires: data.expires
+      });
     }
     return this._serialize(data);
   }
@@ -777,7 +924,10 @@ var Keyv = class extends event_manager_default {
     }
     if (this._compression?.decompress && typeof data === "string") {
       const result = await this._deserialize(data);
-      return { value: await this._compression.decompress(result?.value), expires: result?.expires };
+      return {
+        value: await this._compression.decompress(result?.value),
+        expires: result?.expires
+      };
     }
     if (typeof data === "string") {
       return this._deserialize(data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keyv",
-  "version": "5.4.0",
+  "version": "5.5.1",
   "description": "Simple key-value storage with support for multiple backends",
   "type": "module",
   "main": "dist/index.cjs",
@@ -12,16 +12,6 @@
       "import": "./dist/index.js"
     }
   },
-  "xo": {
-    "rules": {
-      "@typescript-eslint/ban-ts-comment": "off",
-      "@typescript-eslint/no-unsafe-call": "off",
-      "@typescript-eslint/no-unsafe-return": "off",
-      "@typescript-eslint/no-unsafe-assignment": "off",
-      "@typescript-eslint/no-unsafe-argument": "off",
-      "@typescript-eslint/no-confusing-void-expression": "off"
-    }
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jaredwray/keyv.git"
@@ -54,23 +44,23 @@
   },
   "homepage": "https://github.com/jaredwray/keyv",
   "dependencies": {
-    "@keyv/serialize": "^1.1.0"
+    "@keyv/serialize": "^1.1.1"
   },
   "devDependencies": {
-    "@faker-js/faker": "^9.9.0",
+    "@biomejs/biome": "^2.2.3",
+    "@faker-js/faker": "^10.0.0",
     "@vitest/coverage-v8": "^3.2.4",
     "rimraf": "^6.0.1",
     "timekeeper": "^2.3.1",
-    "tsd": "^0.32.0",
+    "tsd": "^0.33.0",
     "vitest": "^3.2.4",
-    "xo": "^1.1.1",
-    "@keyv/memcache": "^2.0.2",
-    "@keyv/compress-gzip": "^2.0.3",
+    "@keyv/mongo": "^3.0.3",
     "@keyv/compress-lz4": "^1.0.1",
+    "@keyv/memcache": "^2.0.2",
+    "@keyv/sqlite": "^4.0.5",
+    "@keyv/test-suite": "^2.1.1",
     "@keyv/compress-brotli": "^2.0.5",
-    "@keyv/mongo": "^3.0.3",
-    "@keyv/test-suite": "^2.0.9",
-    "@keyv/sqlite": "^4.0.5"
+    "@keyv/compress-gzip": "^2.0.3"
   },
   "tsd": {
     "directory": "test"
@@ -81,8 +71,8 @@
   ],
   "scripts": {
     "build": "rimraf ./dist && tsup src/index.ts --format cjs,esm --dts --clean",
-    "test": "xo --fix && vitest run --coverage",
-    "test:ci": "xo && vitest --run --sequence.setupFiles=list --coverage",
+    "test": "biome check --write && vitest run --coverage",
+    "test:ci": "biome check && vitest --run --sequence.setupFiles=list --coverage",
     "clean": "rimraf ./node_modules ./coverage ./test/testdb.sqlite ./dist"
   }
 }