@getstrata/core 2.2.23 → 2.2.24

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @getstrata/core changelog
 
+## 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/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/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);
     }

package/package.json

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