@getstrata/core 2.2.23 → 2.2.25

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @getstrata/core changelog
 
+## 2.2.25
+
+Queue worker run loops recover native Redis connection closure with bounded backoff and a fresh connection. Uncertain Redis mutations are not replayed; retained reservations and retries use normal recovery. Explicit closure remains terminal and non-connection errors remain fatal. Native poll/ack closure regressions cover Streams and list transports.
+
+## 2.2.24
+
+Fix Redis cache recovery after transport failures and command deadlines: retire failed connections, abort active fills, and lazily reconnect for later operations without replaying uncertain commands; preserve permanent explicit closure and shared invalidation fencing.
+
 ## 2.2.23
 
 Fix native SMTP hangs with bounded whole-send deadlines, cancellation, buffered multiline replies, complete writes and verified implicit TLS. Preserve known final DATA acceptance through cleanup failures. Correct DATA transparency, CRLF, UTF-8 MIME/header encoding and long-line framing; reject incomplete AUTH and unsupported SMTPUTF8 envelopes explicitly. Generate documented SMTP timeout and TLS defaults. Real socket/TLS/protocol regressions cover outages, cancellation, accepted sends and framing; SMTP delivery before final acknowledgement remains uncertain.

package/dist/core/cache/redisCacheStore.d.ts

@@ -9,14 +9,16 @@ type RedisCacheOptions = {
     metadataLimit?: number;
 };
 declare class RedisCacheStore implements CacheStore {
+    private readonly redisUrl;
     private readonly ttlMs;
     private readonly maxEntries;
-    private readonly client;
+    private client;
     private readonly keys;
     private readonly options;
     private readonly fills;
     private closed;
     constructor(redisUrl: string, ttlMs: number, maxEntries: number, options?: RedisCacheOptions);
+    private createClient;
     close(): void;
     get<T>(key: string): Promise<T | undefined>;
     set<T>(key: string, value: T, ttlMs?: number): Promise<void>;

package/dist/core/queue/redisQueue.d.ts

@@ -27,13 +27,14 @@ declare class RedisQueue implements Queue {
     dispatch<TPayload extends object>(job: Job<TPayload>, payload: TPayload): Promise<void>;
 }
 declare class QueueWorker {
+    private readonly redisUrl;
     private readonly failedJobs;
     private readonly timeoutSeconds;
     private readonly queueKeys;
     private readonly owner;
     private running;
     private stopping;
-    private readonly client;
+    private client;
     constructor(redisUrl: string, failedJobs: FailedJobService, timeoutSeconds?: number, queueKeys?: readonly string[]);
     requestStop(): void;
     isRunning(): boolean;

package/dist/core/queue/redisStreams.d.ts

@@ -49,10 +49,11 @@ declare class RedisStreamsQueue implements Queue {
     cancel(jobId: string): Promise<boolean>;
 }
 declare class RedisStreamsWorker {
+    private readonly redisUrl;
     private readonly failedJobs;
     private readonly timeoutSeconds;
     private readonly queueKeys;
-    private readonly client;
+    private client;
     private readonly owner;
     private readonly cursors;
     private processing;

package/dist/entries/cache/createCacheStore.js

@@ -289,6 +289,7 @@ return redis.error_reply('Unknown cache operation')
 `;
 
 class RedisCacheStore {
+  redisUrl;
   ttlMs;
   maxEntries;
   client;
@@ -297,6 +298,7 @@ class RedisCacheStore {
   fills = new Set;
   closed = false;
   constructor(redisUrl, ttlMs, maxEntries, options = {}) {
+    this.redisUrl = redisUrl;
     this.ttlMs = ttlMs;
     this.maxEntries = maxEntries;
     if (!Number.isSafeInteger(ttlMs) || ttlMs < 0)
@@ -321,7 +323,10 @@ class RedisCacheStore {
     const namespace = namespacedRedisKey("cache:v3:");
     const slot = new Bun.CryptoHasher("sha256").update(namespace).digest("hex");
     this.keys = ["entries", "expiry", "order", "metadata", "metadata-expiry"].map((name) => `${namespace}{${slot}}:${name}`);
-    this.client = new RedisClient(redisUrl, {
+    this.client = this.createClient();
+  }
+  createClient() {
+    return new RedisClient(this.redisUrl, {
       connectionTimeout: this.options.commandTimeoutMs,
       maxRetries: 1
     });
@@ -330,7 +335,8 @@ class RedisCacheStore {
     this.closed = true;
     for (const fill of this.fills)
       fill.abort(new Error("Redis cache store is closed."));
-    this.client.close();
+    this.client?.close();
+    this.client = undefined;
   }
   async get(key) {
     const result = await this.execute("get", key);
@@ -409,6 +415,7 @@ class RedisCacheStore {
         Promise.resolve().then(() => loader(controller.signal)),
         aborted
       ]);
+      controller.signal.throwIfAborted();
       done = true;
       clearInterval(renew);
       await this.execute("publish", key, {
@@ -450,16 +457,28 @@ class RedisCacheStore {
     const ttlMs = extra.ttlMs ?? this.ttlMs;
     if (typeof ttlMs !== "number" || !Number.isSafeInteger(ttlMs) || ttlMs < 0)
       throw new RangeError("ttlMs must be a non-negative safe integer.");
+    if (!this.client)
+      this.client = this.createClient();
+    const client = this.client;
+    const retire = (reason) => {
+      if (this.client !== client)
+        return;
+      this.client = undefined;
+      for (const fill of this.fills)
+        fill.abort(reason);
+      client.close();
+    };
     let timer;
     const timeout = new Promise((_, reject) => {
       timer = setTimeout(() => {
-        reject(new Error("Redis cache command deadline exceeded; recreate the store."));
-        this.close();
+        const error = new Error("Redis cache command deadline exceeded.");
+        reject(error);
+        retire(error);
       }, this.options.commandTimeoutMs);
     });
     try {
       const raw = await Promise.race([
-        this.client.send("EVAL", [
+        client.send("EVAL", [
           CACHE_SCRIPT,
           String(this.keys.length),
           ...this.keys,
@@ -477,7 +496,13 @@ class RedisCacheStore {
         ]),
         timeout
       ]);
+      if (this.closed || this.client !== client)
+        throw new Error("Redis cache connection was retired.");
       return JSON.parse(String(raw));
+    } catch (error) {
+      if (error && typeof error === "object" && "code" in error && typeof error.code === "string" && error.code.startsWith("ERR_REDIS_CONNECTION"))
+        retire(error);
+      throw error;
     } finally {
       clearTimeout(timer);
     }

package/dist/entries/queue/createAppQueue.js

@@ -690,6 +690,7 @@ class RedisStreamsQueue {
 }
 
 class RedisStreamsWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -702,6 +703,7 @@ class RedisStreamsWorker {
   stopping = false;
   active;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = defaultQueueKeys()) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -891,8 +893,21 @@ class RedisStreamsWorker {
   async run() {
     this.running = true;
     try {
-      while (!this.stopping)
-        await this.processNext();
+      while (!this.stopping) {
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient(this.redisUrl);
+          this.initialized = false;
+          this.cursors.clear();
+        }
+      }
     } finally {
       this.running = false;
     }
@@ -1195,6 +1210,7 @@ class RedisQueue {
 }
 
 class QueueWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -1203,6 +1219,7 @@ class QueueWorker {
   stopping = false;
   client;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = QUEUE_KEYS) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -1283,13 +1300,24 @@ class QueueWorker {
     this.running = true;
     try {
       while (!this.stopping) {
-        await this.processNext();
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient2(this.redisUrl);
+        }
       }
     } finally {
       this.running = false;
     }
   }
   close() {
+    this.stopping = true;
     this.client.close();
   }
 }

package/dist/entries/queue/publicQueue.js

@@ -690,6 +690,7 @@ class RedisStreamsQueue {
 }
 
 class RedisStreamsWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -702,6 +703,7 @@ class RedisStreamsWorker {
   stopping = false;
   active;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = defaultQueueKeys()) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -891,8 +893,21 @@ class RedisStreamsWorker {
   async run() {
     this.running = true;
     try {
-      while (!this.stopping)
-        await this.processNext();
+      while (!this.stopping) {
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient(this.redisUrl);
+          this.initialized = false;
+          this.cursors.clear();
+        }
+      }
     } finally {
       this.running = false;
     }
@@ -1195,6 +1210,7 @@ class RedisQueue {
 }
 
 class QueueWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -1203,6 +1219,7 @@ class QueueWorker {
   stopping = false;
   client;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = QUEUE_KEYS) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -1283,13 +1300,24 @@ class QueueWorker {
     this.running = true;
     try {
       while (!this.stopping) {
-        await this.processNext();
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient2(this.redisUrl);
+        }
       }
     } finally {
       this.running = false;
     }
   }
   close() {
+    this.stopping = true;
     this.client.close();
   }
 }

package/dist/entries/queue/queueMetrics.js

@@ -1569,6 +1569,7 @@ class RedisStreamsQueue {
 }
 
 class RedisStreamsWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -1581,6 +1582,7 @@ class RedisStreamsWorker {
   stopping = false;
   active;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = defaultQueueKeys()) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -1770,8 +1772,21 @@ class RedisStreamsWorker {
   async run() {
     this.running = true;
     try {
-      while (!this.stopping)
-        await this.processNext();
+      while (!this.stopping) {
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient(this.redisUrl);
+          this.initialized = false;
+          this.cursors.clear();
+        }
+      }
     } finally {
       this.running = false;
     }
@@ -2074,6 +2089,7 @@ class RedisQueue {
 }
 
 class QueueWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -2082,6 +2098,7 @@ class QueueWorker {
   stopping = false;
   client;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = QUEUE_KEYS) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -2162,13 +2179,24 @@ class QueueWorker {
     this.running = true;
     try {
       while (!this.stopping) {
-        await this.processNext();
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient2(this.redisUrl);
+        }
       }
     } finally {
       this.running = false;
     }
   }
   close() {
+    this.stopping = true;
     this.client.close();
   }
 }

package/dist/entries/queue/redisQueue.js

@@ -622,6 +622,7 @@ class RedisStreamsQueue {
 }
 
 class RedisStreamsWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -634,6 +635,7 @@ class RedisStreamsWorker {
   stopping = false;
   active;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = defaultQueueKeys()) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -823,8 +825,21 @@ class RedisStreamsWorker {
   async run() {
     this.running = true;
     try {
-      while (!this.stopping)
-        await this.processNext();
+      while (!this.stopping) {
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient(this.redisUrl);
+          this.initialized = false;
+          this.cursors.clear();
+        }
+      }
     } finally {
       this.running = false;
     }
@@ -1127,6 +1142,7 @@ class RedisQueue {
 }
 
 class QueueWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -1135,6 +1151,7 @@ class QueueWorker {
   stopping = false;
   client;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = QUEUE_KEYS) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -1215,13 +1232,24 @@ class QueueWorker {
     this.running = true;
     try {
       while (!this.stopping) {
-        await this.processNext();
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient2(this.redisUrl);
+        }
       }
     } finally {
       this.running = false;
     }
   }
   close() {
+    this.stopping = true;
     this.client.close();
   }
 }

package/dist/index.js

@@ -3893,6 +3893,7 @@ return redis.error_reply('Unknown cache operation')
 `;
 
 class RedisCacheStore {
+  redisUrl;
   ttlMs;
   maxEntries;
   client;
@@ -3901,6 +3902,7 @@ class RedisCacheStore {
   fills = new Set;
   closed = false;
   constructor(redisUrl, ttlMs, maxEntries, options = {}) {
+    this.redisUrl = redisUrl;
     this.ttlMs = ttlMs;
     this.maxEntries = maxEntries;
     if (!Number.isSafeInteger(ttlMs) || ttlMs < 0)
@@ -3925,7 +3927,10 @@ class RedisCacheStore {
     const namespace = namespacedRedisKey("cache:v3:");
     const slot = new Bun.CryptoHasher("sha256").update(namespace).digest("hex");
     this.keys = ["entries", "expiry", "order", "metadata", "metadata-expiry"].map((name) => `${namespace}{${slot}}:${name}`);
-    this.client = new RedisClient(redisUrl, {
+    this.client = this.createClient();
+  }
+  createClient() {
+    return new RedisClient(this.redisUrl, {
       connectionTimeout: this.options.commandTimeoutMs,
       maxRetries: 1
     });
@@ -3934,7 +3939,8 @@ class RedisCacheStore {
     this.closed = true;
     for (const fill of this.fills)
       fill.abort(new Error("Redis cache store is closed."));
-    this.client.close();
+    this.client?.close();
+    this.client = undefined;
   }
   async get(key) {
     const result = await this.execute("get", key);
@@ -4013,6 +4019,7 @@ class RedisCacheStore {
         Promise.resolve().then(() => loader(controller.signal)),
         aborted
       ]);
+      controller.signal.throwIfAborted();
       done = true;
       clearInterval(renew);
       await this.execute("publish", key, {
@@ -4054,16 +4061,28 @@ class RedisCacheStore {
     const ttlMs = extra.ttlMs ?? this.ttlMs;
     if (typeof ttlMs !== "number" || !Number.isSafeInteger(ttlMs) || ttlMs < 0)
       throw new RangeError("ttlMs must be a non-negative safe integer.");
+    if (!this.client)
+      this.client = this.createClient();
+    const client = this.client;
+    const retire = (reason) => {
+      if (this.client !== client)
+        return;
+      this.client = undefined;
+      for (const fill of this.fills)
+        fill.abort(reason);
+      client.close();
+    };
     let timer;
     const timeout = new Promise((_, reject) => {
       timer = setTimeout(() => {
-        reject(new Error("Redis cache command deadline exceeded; recreate the store."));
-        this.close();
+        const error = new Error("Redis cache command deadline exceeded.");
+        reject(error);
+        retire(error);
       }, this.options.commandTimeoutMs);
     });
     try {
       const raw = await Promise.race([
-        this.client.send("EVAL", [
+        client.send("EVAL", [
           CACHE_SCRIPT,
           String(this.keys.length),
           ...this.keys,
@@ -4081,7 +4100,13 @@ class RedisCacheStore {
         ]),
         timeout
       ]);
+      if (this.closed || this.client !== client)
+        throw new Error("Redis cache connection was retired.");
       return JSON.parse(String(raw));
+    } catch (error) {
+      if (error && typeof error === "object" && "code" in error && typeof error.code === "string" && error.code.startsWith("ERR_REDIS_CONNECTION"))
+        retire(error);
+      throw error;
     } finally {
       clearTimeout(timer);
     }
@@ -14796,6 +14821,7 @@ class RedisStreamsQueue {
 }
 
 class RedisStreamsWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -14808,6 +14834,7 @@ class RedisStreamsWorker {
   stopping = false;
   active;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = defaultQueueKeys()) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -14997,8 +15024,21 @@ class RedisStreamsWorker {
   async run() {
     this.running = true;
     try {
-      while (!this.stopping)
-        await this.processNext();
+      while (!this.stopping) {
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient3(this.redisUrl);
+          this.initialized = false;
+          this.cursors.clear();
+        }
+      }
     } finally {
       this.running = false;
     }
@@ -15224,6 +15264,7 @@ class RedisQueue {
 }
 
 class QueueWorker {
+  redisUrl;
   failedJobs;
   timeoutSeconds;
   queueKeys;
@@ -15232,6 +15273,7 @@ class QueueWorker {
   stopping = false;
   client;
   constructor(redisUrl, failedJobs, timeoutSeconds = 5, queueKeys = QUEUE_KEYS) {
+    this.redisUrl = redisUrl;
     this.failedJobs = failedJobs;
     this.timeoutSeconds = timeoutSeconds;
     this.queueKeys = queueKeys;
@@ -15312,13 +15354,24 @@ class QueueWorker {
     this.running = true;
     try {
       while (!this.stopping) {
-        await this.processNext();
+        try {
+          await this.processNext();
+        } catch (error) {
+          if (!(error && typeof error === "object" && ("code" in error) && error.code === "ERR_REDIS_CONNECTION_CLOSED"))
+            throw error;
+          this.client.close();
+          await Bun.sleep(250);
+          if (this.stopping)
+            return;
+          this.client = new RedisClient4(this.redisUrl);
+        }
       }
     } finally {
       this.running = false;
     }
   }
   close() {
+    this.stopping = true;
     this.client.close();
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getstrata/core",
-  "version": "2.2.23",
+  "version": "2.2.25",
   "description": "Strata Bun framework public API",
   "type": "module",
   "license": "MIT",