@frontmcp/utils 1.8.5 → 1.8.6

package/esm/index.mjs

@@ -2982,25 +2982,29 @@ function getRedisClass() {
     const msg = error instanceof Error ? error.message : String(error);
     if (msg.includes("Dynamic require") || msg.includes("require is not defined")) {
       throw new Error(
-        `Failed to load ioredis: ${msg}. This typically happens with ESM bundlers (esbuild, Vite). Ensure your bundler externalizes ioredis or use CJS mode.`
+        `Failed to load ioredis: ${msg}. This typically happens with ESM bundlers (esbuild, Vite). Ensure your bundler externalizes ioredis or use CJS mode.`,
+        { cause: error }
       );
     }
-    throw new Error("ioredis is required for Redis storage adapter. Install it with: npm install ioredis");
+    throw new Error("ioredis is required for Redis storage adapter. Install it with: npm install ioredis", {
+      cause: error
+    });
   }
 }
 var RedisStorageAdapter;
 var init_redis = __esm({
   "libs/utils/src/storage/adapters/redis.ts"() {
     "use strict";
-    init_base();
     init_errors();
     init_utils();
+    init_base();
     RedisStorageAdapter = class extends BaseStorageAdapter {
       backendName = "redis";
       client;
       subscriber;
       options;
       ownsClient;
+      connecting;
       keyPrefix;
       subscriptionHandlers = /* @__PURE__ */ new Map();
       constructor(options = {}) {
@@ -3030,21 +3034,42 @@ var init_redis = __esm({
       // ============================================
       async connect() {
         if (this.connected) return;
+        this.connecting ??= this.openConnection().finally(() => {
+          this.connecting = void 0;
+        });
+        return this.connecting;
+      }
+      async openConnection() {
+        let socketError;
+        const recordSocketError = (error) => {
+          socketError = error;
+        };
+        let client;
         try {
           if (this.options.client) {
-            this.client = this.options.client;
+            client = this.options.client;
           } else {
             const RedisClass = getRedisClass();
             if (this.options.url) {
-              this.client = new RedisClass(this.options.url, this.buildRedisOptions());
+              client = new RedisClass(this.options.url, this.buildRedisOptions());
             } else {
-              this.client = new RedisClass(this.buildRedisOptions());
+              client = new RedisClass(this.buildRedisOptions());
             }
+            client.on("error", recordSocketError);
           }
-          await this.client.ping();
+          await client.ping();
+          this.client = client;
           this.connected = true;
+          if (this.ownsClient) client.removeListener("error", recordSocketError);
         } catch (e) {
-          throw new StorageConnectionError("Failed to connect to Redis", e instanceof Error ? e : void 0, "redis");
+          if (this.ownsClient && client) {
+            try {
+              client.disconnect();
+            } catch {
+            }
+          }
+          const cause = socketError ?? (e instanceof Error ? e : void 0);
+          throw new StorageConnectionError("Failed to connect to Redis", cause, "redis");
         }
       }
       async disconnect() {

package/index.js

@@ -2985,25 +2985,29 @@ function getRedisClass() {
     const msg = error instanceof Error ? error.message : String(error);
     if (msg.includes("Dynamic require") || msg.includes("require is not defined")) {
       throw new Error(
-        `Failed to load ioredis: ${msg}. This typically happens with ESM bundlers (esbuild, Vite). Ensure your bundler externalizes ioredis or use CJS mode.`
+        `Failed to load ioredis: ${msg}. This typically happens with ESM bundlers (esbuild, Vite). Ensure your bundler externalizes ioredis or use CJS mode.`,
+        { cause: error }
       );
     }
-    throw new Error("ioredis is required for Redis storage adapter. Install it with: npm install ioredis");
+    throw new Error("ioredis is required for Redis storage adapter. Install it with: npm install ioredis", {
+      cause: error
+    });
   }
 }
 var RedisStorageAdapter;
 var init_redis = __esm({
   "libs/utils/src/storage/adapters/redis.ts"() {
     "use strict";
-    init_base();
     init_errors();
     init_utils();
+    init_base();
     RedisStorageAdapter = class extends BaseStorageAdapter {
       backendName = "redis";
       client;
       subscriber;
       options;
       ownsClient;
+      connecting;
       keyPrefix;
       subscriptionHandlers = /* @__PURE__ */ new Map();
       constructor(options = {}) {
@@ -3033,21 +3037,42 @@ var init_redis = __esm({
       // ============================================
       async connect() {
         if (this.connected) return;
+        this.connecting ??= this.openConnection().finally(() => {
+          this.connecting = void 0;
+        });
+        return this.connecting;
+      }
+      async openConnection() {
+        let socketError;
+        const recordSocketError = (error) => {
+          socketError = error;
+        };
+        let client;
         try {
           if (this.options.client) {
-            this.client = this.options.client;
+            client = this.options.client;
           } else {
             const RedisClass = getRedisClass();
             if (this.options.url) {
-              this.client = new RedisClass(this.options.url, this.buildRedisOptions());
+              client = new RedisClass(this.options.url, this.buildRedisOptions());
             } else {
-              this.client = new RedisClass(this.buildRedisOptions());
+              client = new RedisClass(this.buildRedisOptions());
             }
+            client.on("error", recordSocketError);
           }
-          await this.client.ping();
+          await client.ping();
+          this.client = client;
           this.connected = true;
+          if (this.ownsClient) client.removeListener("error", recordSocketError);
         } catch (e) {
-          throw new StorageConnectionError("Failed to connect to Redis", e instanceof Error ? e : void 0, "redis");
+          if (this.ownsClient && client) {
+            try {
+              client.disconnect();
+            } catch {
+            }
+          }
+          const cause = socketError ?? (e instanceof Error ? e : void 0);
+          throw new StorageConnectionError("Failed to connect to Redis", cause, "redis");
         }
       }
       async disconnect() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/utils",
-  "version": "1.8.5",
+  "version": "1.8.6",
   "description": "Shared utility functions for FrontMCP - string manipulation, URI handling, path utilities, and more",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -32,7 +32,7 @@
     "@noble/hashes": "^2.0.1"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.8.5",
+    "@frontmcp/lazy-zod": "1.8.6",
     "@vercel/kv": "^2.0.0 || ^3.0.0",
     "ioredis": "^5.0.0"
   },

package/storage/adapters/redis.d.ts

@@ -4,8 +4,8 @@
  * Redis-based storage implementation for production use.
  * Uses ioredis with dynamic import for browser compatibility.
  */
+import type { MessageHandler, RedisAdapterOptions, SetOptions, Unsubscribe } from '../types';
 import { BaseStorageAdapter } from './base';
-import type { RedisAdapterOptions, SetOptions, MessageHandler, Unsubscribe } from '../types';
 type Redis = import('ioredis').Redis;
 /**
  * Redis storage adapter.
@@ -34,10 +34,12 @@ export declare class RedisStorageAdapter extends BaseStorageAdapter {
     private subscriber?;
     private readonly options;
     private readonly ownsClient;
+    private connecting?;
     private readonly keyPrefix;
     private readonly subscriptionHandlers;
     constructor(options?: RedisAdapterOptions);
     connect(): Promise<void>;
+    private openConnection;
     disconnect(): Promise<void>;
     ping(): Promise<boolean>;
     /**