@mastra/redis 1.4.3 → 1.4.4-alpha.0

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export * from './storage/index.js';
-export { RedisServerCache, type RedisClient, type RedisServerCacheOptions, upstashPreset, nodeRedisPreset, } from './cache.js';
+export { RedisServerCache, type RedisClient, type RedisServerCacheOptions, upstashPreset, nodeRedisPreset, LIST_PUSH_INDEXED_SCRIPT, } from './cache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,aAAa,EACb,eAAe,GAChB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,aAAa,EACb,eAAe,EACf,wBAAwB,GACzB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1596,6 +1596,38 @@ const defaultPushToList = (client, key, value) => {
 const defaultGetListRange = (client, key, start, stop) => {
 	return client.lrange(key, start, stop);
 };
+const defaultEvalScript = (client, script, keys, args) => {
+	return client.eval(script, keys.length, ...keys, ...args);
+};
+/**
+* Atomic "allocate index + append + refresh TTLs" used by `listPushIndexed`.
+*
+* KEYS[1] = list key, KEYS[2] = counter key
+* ARGV[1] = JSON-serialized object WITHOUT an `index` property
+* ARGV[2] = TTL in seconds (0 = no expiry)
+*
+* The index is spliced into the JSON text as the first property rather than
+* decoded/re-encoded with cjson, which would silently alter large integers
+* and sparse arrays. `JSON.stringify` of an object always starts with `{`,
+* so `{...}` → `{"index":N,...}` and `{}` → `{"index":N}`.
+*/
+const LIST_PUSH_INDEXED_SCRIPT = `
+local i = redis.call('INCR', KEYS[2]) - 1
+local body = ARGV[1]
+local doc
+if #body <= 2 then
+  doc = '{"index":' .. i .. '}'
+else
+  doc = '{"index":' .. i .. ',' .. string.sub(body, 2)
+end
+redis.call('RPUSH', KEYS[1], doc)
+local ttl = tonumber(ARGV[2])
+if ttl > 0 then
+  redis.call('EXPIRE', KEYS[1], ttl)
+  redis.call('EXPIRE', KEYS[2], ttl)
+end
+return i
+`.trim();
 var RedisServerCache = class extends MastraServerCache {
 	client;
 	keyPrefix;
@@ -1605,6 +1637,9 @@ var RedisServerCache = class extends MastraServerCache {
 	getListLength;
 	pushToList;
 	getListRange;
+	evalScript;
+	/** Set once scripting is known to be unusable (no `eval`, or Cluster CROSSSLOT). */
+	scriptingDisabled;
 	constructor(config, options = {}) {
 		super({ name: "RedisServerCache" });
 		this.client = config.client;
@@ -1615,6 +1650,8 @@ var RedisServerCache = class extends MastraServerCache {
 		this.getListLength = options.getListLength ?? defaultGetListLength;
 		this.pushToList = options.pushToList ?? defaultPushToList;
 		this.getListRange = options.getListRange ?? defaultGetListRange;
+		this.evalScript = options.evalScript ?? defaultEvalScript;
+		this.scriptingDisabled = typeof this.client.eval !== "function";
 	}
 	getKey(key) {
 		return `${this.keyPrefix}${key}`;
@@ -1676,13 +1713,34 @@ var RedisServerCache = class extends MastraServerCache {
 		if (this.ttlSeconds > 0) await this.client.expire(fullKey, this.ttlSeconds);
 		return value;
 	}
+	/**
+	* Single round-trip index allocation + list append + TTL refresh via Lua.
+	* This is the durable stream per-chunk hot path (issue #22477): the composed
+	* default costs four awaited commands (INCR, EXPIRE, RPUSH, EXPIRE).
+	*/
+	async listPushIndexed(listKey, counterKey, value) {
+		if (this.scriptingDisabled) return super.listPushIndexed(listKey, counterKey, value);
+		const { index: _ignored, ...body } = value;
+		try {
+			const result = await this.evalScript(this.client, LIST_PUSH_INDEXED_SCRIPT, [this.getKey(listKey), this.getKey(counterKey)], [this.serialize(body), String(this.ttlSeconds)]);
+			return Number(result);
+		} catch (error) {
+			if (error instanceof Error && error.message.includes("CROSSSLOT")) {
+				this.scriptingDisabled = true;
+				this.logger.warn("[RedisServerCache] listPushIndexed script rejected with CROSSSLOT; falling back to increment + listPush");
+				return super.listPushIndexed(listKey, counterKey, value);
+			}
+			throw error;
+		}
+	}
 };
 const upstashPreset = {
 	setWithExpiry: (client, key, value, seconds) => client.set(key, value, { ex: seconds }),
 	scanKeys: (client, cursor, pattern, count) => client.scan(cursor, {
 		match: pattern,
 		count
-	})
+	}),
+	evalScript: (client, script, keys, args) => client.eval(script, keys, args)
 };
 const nodeRedisPreset = {
 	setWithExpiry: (client, key, value, seconds) => client.set(key, value, { EX: seconds }),
@@ -1692,9 +1750,13 @@ const nodeRedisPreset = {
 	}),
 	getListLength: (client, key) => client.lLen(key),
 	pushToList: (client, key, value) => client.rPush(key, value),
-	getListRange: (client, key, start, stop) => client.lRange(key, start, stop)
+	getListRange: (client, key, start, stop) => client.lRange(key, start, stop),
+	evalScript: (client, script, keys, args) => client.eval(script, {
+		keys,
+		arguments: args
+	})
 };
 //#endregion
-export { RedisServerCache, RedisStore, ScoresRedis, StoreMemoryRedis, WorkflowsRedis, nodeRedisPreset, upstashPreset };
+export { LIST_PUSH_INDEXED_SCRIPT, RedisServerCache, RedisStore, ScoresRedis, StoreMemoryRedis, WorkflowsRedis, nodeRedisPreset, upstashPreset };
 
 //# sourceMappingURL=index.js.map