@keyv/redis 4.2.0 → 4.3.0

package/README.md

@@ -32,6 +32,7 @@ Redis storage adapter for [Keyv](https://github.com/jaredwray/keyv).
 * [Using Cacheable with Redis](#using-cacheable-with-redis)
 * [Clustering and TLS Support](#clustering-and-tls-support)
 * [API](#api)
+* [Using Custom Redis Client Events](#using-custom-redis-client-events)
 * [Migrating from v3 to v4](#migrating-from-v3-to-v4)
 * [About Redis Sets and its Support in v4](#about-redis-sets-and-its-support-in-v4)
 * [License](#license)
@@ -254,9 +255,34 @@ const keyv = new Keyv({ store: new KeyvRedis(tlsOptions) });
 * **delete** - Delete a key.
 * **deleteMany** - Delete multiple keys.
 * **clear** - Clear all keys in the namespace. If the namespace is not set it will clear all keys that are not prefixed with a namespace unless `noNamespaceAffectsAll` is set to `true`.
-* **disconnect** - Disconnect from the Redis server.
+* **disconnect** - Disconnect from the Redis server using `Quit` command. If you set `force` to `true` it will force the disconnect.
 * **iterator** - Create a new iterator for the keys. If the namespace is not set it will iterate over all keys that are not prefixed with a namespace unless `noNamespaceAffectsAll` is set to `true`.
 
+# Using Custom Redis Client Events
+
+Keyv by default supports the `error` event across all storage adapters. If you want to listen to other events you can do so by accessing the `client` property of the `KeyvRedis` instance. Here is an example of how to do that:
+
+```js
+import {createKeyv} from '@keyv/redis';
+
+const keyv = createKeyv('redis://user:pass@localhost:6379');
+const redisClient = keyv.store.client;
+
+redisClient.on('connect', () => {
+  console.log('Redis client connected');
+});
+
+redisClient.on('reconnecting', () => {
+  console.log('Redis client reconnecting');
+});
+
+redisClient.on('end', () => {
+  console.log('Redis client disconnected');
+});
+```
+
+Here are some of the events you can listen to: https://www.npmjs.com/package/redis#events
+
 # Migrating from v3 to v4
 
 Overall the API is the same as v3 with additional options and performance improvements. Here are the main changes:

package/dist/index.cjs

@@ -28,15 +28,15 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   Keyv: () => import_keyv2.Keyv,
   createClient: () => import_redis2.createClient,
   createCluster: () => import_redis2.createCluster,
   createKeyv: () => createKeyv,
   default: () => KeyvRedis
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 var import_node_events = __toESM(require("events"), 1);
 var import_redis = require("redis");
 var import_keyv = require("keyv");
@@ -199,7 +199,7 @@ var KeyvRedis = class extends import_node_events.default {
   }
   /**
    * Will set many key value pairs in the store. TTL is in milliseconds. This will be done as a single transaction.
-   * @param {Array<KeyvRedisEntry<string>>} entries - the key value pairs to set with optional ttl
+   * @param {KeyvEntry[]} entries - the key value pairs to set with optional ttl
    */
   async setMany(entries) {
     const client = await this.getClient();
@@ -213,6 +213,7 @@ var KeyvRedis = class extends import_node_events.default {
       }
     }
     await multi.exec();
+    return entries.map(() => true);
   }
   /**
    * Check if a key exists in the store.
@@ -307,10 +308,12 @@ var KeyvRedis = class extends import_node_events.default {
   /**
    * Disconnect from the Redis server.
    * @returns {Promise<void>}
+   * @param {boolean} [force] - it will send a quit command if false, otherwise it will send a disconnect command to forcefully disconnect.
+   * @see {@link https://github.com/redis/node-redis/tree/master/packages/redis#disconnecting}
    */
-  async disconnect() {
+  async disconnect(force) {
     if (this._client.isOpen) {
-      await this._client.disconnect();
+      await (force ? this._client.disconnect() : this._client.quit());
     }
   }
   /**
@@ -515,6 +518,7 @@ var KeyvRedis = class extends import_node_events.default {
   }
 };
 function createKeyv(connect, options) {
+  connect ??= "redis://localhost:6379";
   const adapter = new KeyvRedis(connect, options);
   const keyv = new import_keyv.Keyv({ store: adapter, namespace: options?.namespace, useKeyPrefix: false });
   return keyv;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import EventEmitter from 'node:events';
 import { RedisClientType, RedisClusterType, RedisModules, RedisFunctions, RedisScripts, RedisClientOptions, RedisClusterOptions } from 'redis';
 export { RedisClientOptions, RedisClientType, RedisClusterOptions, RedisClusterType, createClient, createCluster } from 'redis';
-import { KeyvStoreAdapter, Keyv } from 'keyv';
+import { KeyvStoreAdapter, KeyvEntry, Keyv } from 'keyv';
 export { Keyv } from 'keyv';
 
 type KeyvRedisOptions = {
@@ -142,9 +142,9 @@ declare class KeyvRedis<T> extends EventEmitter implements KeyvStoreAdapter {
     set(key: string, value: string, ttl?: number): Promise<void>;
     /**
      * Will set many key value pairs in the store. TTL is in milliseconds. This will be done as a single transaction.
-     * @param {Array<KeyvRedisEntry<string>>} entries - the key value pairs to set with optional ttl
+     * @param {KeyvEntry[]} entries - the key value pairs to set with optional ttl
      */
-    setMany(entries: Array<KeyvRedisEntry<string>>): Promise<void>;
+    setMany(entries: KeyvEntry[]): Promise<boolean[]>;
     /**
      * Check if a key exists in the store.
      * @param {string} key - the key to check
@@ -184,8 +184,10 @@ declare class KeyvRedis<T> extends EventEmitter implements KeyvStoreAdapter {
     /**
      * Disconnect from the Redis server.
      * @returns {Promise<void>}
+     * @param {boolean} [force] - it will send a quit command if false, otherwise it will send a disconnect command to forcefully disconnect.
+     * @see {@link https://github.com/redis/node-redis/tree/master/packages/redis#disconnecting}
      */
-    disconnect(): Promise<void>;
+    disconnect(force?: boolean): Promise<void>;
     /**
      * Helper function to create a key with a namespace.
      * @param {string} key - the key to prefix
@@ -252,8 +254,8 @@ declare class KeyvRedis<T> extends EventEmitter implements KeyvStoreAdapter {
 }
 /**
  * Will create a Keyv instance with the Redis adapter. This will also set the namespace and useKeyPrefix to false.
- * @param connect
- * @param options
+ * @param connect - How to connect to the Redis server. If string pass in the url, if object pass in the options, if RedisClient pass in the client. If nothing is passed in, it will default to 'redis://localhost:6379'.
+ * @param {KeyvRedisOptions} options - Options for the adapter such as namespace, keyPrefixSeparator, and clearBatchSize.
  * @returns {Keyv} - Keyv instance with the Redis adapter
  */
 declare function createKeyv(connect?: string | RedisClientOptions | RedisClientType, options?: KeyvRedisOptions): Keyv;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import EventEmitter from 'node:events';
 import { RedisClientType, RedisClusterType, RedisModules, RedisFunctions, RedisScripts, RedisClientOptions, RedisClusterOptions } from 'redis';
 export { RedisClientOptions, RedisClientType, RedisClusterOptions, RedisClusterType, createClient, createCluster } from 'redis';
-import { KeyvStoreAdapter, Keyv } from 'keyv';
+import { KeyvStoreAdapter, KeyvEntry, Keyv } from 'keyv';
 export { Keyv } from 'keyv';
 
 type KeyvRedisOptions = {
@@ -142,9 +142,9 @@ declare class KeyvRedis<T> extends EventEmitter implements KeyvStoreAdapter {
     set(key: string, value: string, ttl?: number): Promise<void>;
     /**
      * Will set many key value pairs in the store. TTL is in milliseconds. This will be done as a single transaction.
-     * @param {Array<KeyvRedisEntry<string>>} entries - the key value pairs to set with optional ttl
+     * @param {KeyvEntry[]} entries - the key value pairs to set with optional ttl
      */
-    setMany(entries: Array<KeyvRedisEntry<string>>): Promise<void>;
+    setMany(entries: KeyvEntry[]): Promise<boolean[]>;
     /**
      * Check if a key exists in the store.
      * @param {string} key - the key to check
@@ -184,8 +184,10 @@ declare class KeyvRedis<T> extends EventEmitter implements KeyvStoreAdapter {
     /**
      * Disconnect from the Redis server.
      * @returns {Promise<void>}
+     * @param {boolean} [force] - it will send a quit command if false, otherwise it will send a disconnect command to forcefully disconnect.
+     * @see {@link https://github.com/redis/node-redis/tree/master/packages/redis#disconnecting}
      */
-    disconnect(): Promise<void>;
+    disconnect(force?: boolean): Promise<void>;
     /**
      * Helper function to create a key with a namespace.
      * @param {string} key - the key to prefix
@@ -252,8 +254,8 @@ declare class KeyvRedis<T> extends EventEmitter implements KeyvStoreAdapter {
 }
 /**
  * Will create a Keyv instance with the Redis adapter. This will also set the namespace and useKeyPrefix to false.
- * @param connect
- * @param options
+ * @param connect - How to connect to the Redis server. If string pass in the url, if object pass in the options, if RedisClient pass in the client. If nothing is passed in, it will default to 'redis://localhost:6379'.
+ * @param {KeyvRedisOptions} options - Options for the adapter such as namespace, keyPrefixSeparator, and clearBatchSize.
  * @returns {Keyv} - Keyv instance with the Redis adapter
  */
 declare function createKeyv(connect?: string | RedisClientOptions | RedisClientType, options?: KeyvRedisOptions): Keyv;

package/dist/index.js

@@ -169,7 +169,7 @@ var KeyvRedis = class extends EventEmitter {
   }
   /**
    * Will set many key value pairs in the store. TTL is in milliseconds. This will be done as a single transaction.
-   * @param {Array<KeyvRedisEntry<string>>} entries - the key value pairs to set with optional ttl
+   * @param {KeyvEntry[]} entries - the key value pairs to set with optional ttl
    */
   async setMany(entries) {
     const client = await this.getClient();
@@ -183,6 +183,7 @@ var KeyvRedis = class extends EventEmitter {
       }
     }
     await multi.exec();
+    return entries.map(() => true);
   }
   /**
    * Check if a key exists in the store.
@@ -277,10 +278,12 @@ var KeyvRedis = class extends EventEmitter {
   /**
    * Disconnect from the Redis server.
    * @returns {Promise<void>}
+   * @param {boolean} [force] - it will send a quit command if false, otherwise it will send a disconnect command to forcefully disconnect.
+   * @see {@link https://github.com/redis/node-redis/tree/master/packages/redis#disconnecting}
    */
-  async disconnect() {
+  async disconnect(force) {
     if (this._client.isOpen) {
-      await this._client.disconnect();
+      await (force ? this._client.disconnect() : this._client.quit());
     }
   }
   /**
@@ -485,6 +488,7 @@ var KeyvRedis = class extends EventEmitter {
   }
 };
 function createKeyv(connect, options) {
+  connect ??= "redis://localhost:6379";
   const adapter = new KeyvRedis(connect, options);
   const keyv = new Keyv({ store: adapter, namespace: options?.namespace, useKeyPrefix: false });
   return keyv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keyv/redis",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Redis storage adapter for Keyv",
   "type": "module",
   "main": "dist/index.cjs",
@@ -36,16 +36,16 @@
   "dependencies": {
     "cluster-key-slot": "^1.1.2",
     "redis": "^4.7.0",
-    "keyv": "^5.2.2"
+    "keyv": "^5.3.0"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^2.1.8",
+    "@vitest/coverage-v8": "^3.0.7",
     "rimraf": "^6.0.1",
     "timekeeper": "^2.3.1",
     "tsd": "^0.31.2",
-    "vitest": "^2.1.8",
+    "vitest": "^3.0.7",
     "xo": "^0.60.0",
-    "@keyv/test-suite": "^2.0.3"
+    "@keyv/test-suite": "^2.0.5"
   },
   "tsd": {
     "directory": "test"