@mastra/redis 1.4.3 → 1.4.4

package/dist/cache.d.ts

@@ -9,16 +9,40 @@ export interface RedisClient {
     expire(key: string, seconds: number): Promise<number | boolean>;
     scan(cursor: string | number, ...args: unknown[]): Promise<[string | number, string[]]>;
     incr(key: string): Promise<number>;
+    /**
+     * Server-side Lua scripting. Optional: clients without it fall back to the
+     * two-round-trip `increment` + `listPush` path for `listPushIndexed`.
+     */
+    eval?(...args: unknown[]): Promise<unknown>;
 }
 export interface RedisServerCacheOptions {
     keyPrefix?: string;
     ttlSeconds?: number;
+    /**
+     * Run a Lua script with the given KEYS and ARGV. Defaults to the ioredis
+     * calling convention (`eval(script, numKeys, ...keys, ...args)`); use
+     * `nodeRedisPreset` / `upstashPreset` for those clients.
+     */
+    evalScript?: (client: RedisClient, script: string, keys: string[], args: string[]) => Promise<unknown>;
     setWithExpiry?: (client: RedisClient, key: string, value: unknown, seconds: number) => Promise<unknown>;
     scanKeys?: (client: RedisClient, cursor: string | number, pattern: string, count: number) => Promise<[string | number, string[]]>;
     getListLength?: (client: RedisClient, key: string) => Promise<number>;
     pushToList?: (client: RedisClient, key: string, value: unknown) => Promise<number>;
     getListRange?: (client: RedisClient, key: string, start: number, stop: number) => Promise<unknown[]>;
 }
+/**
+ * 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}`.
+ */
+export declare const LIST_PUSH_INDEXED_SCRIPT: string;
 export declare class RedisServerCache extends MastraServerCache {
     private client;
     private keyPrefix;
@@ -28,6 +52,9 @@ export declare class RedisServerCache extends MastraServerCache {
     private getListLength;
     private pushToList;
     private getListRange;
+    private evalScript;
+    /** Set once scripting is known to be unusable (no `eval`, or Cluster CROSSSLOT). */
+    private scriptingDisabled;
     constructor(config: {
         client: RedisClient;
     }, options?: RedisServerCacheOptions);
@@ -42,7 +69,13 @@ export declare class RedisServerCache extends MastraServerCache {
     delete(key: string): Promise<void>;
     clear(): Promise<void>;
     increment(key: string): Promise<number>;
+    /**
+     * 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).
+     */
+    listPushIndexed(listKey: string, counterKey: string, value: Record<string, unknown>): Promise<number>;
 }
-export declare const upstashPreset: Pick<RedisServerCacheOptions, 'setWithExpiry' | 'scanKeys'>;
-export declare const nodeRedisPreset: Pick<RedisServerCacheOptions, 'setWithExpiry' | 'scanKeys' | 'getListLength' | 'pushToList' | 'getListRange'>;
+export declare const upstashPreset: Pick<RedisServerCacheOptions, 'setWithExpiry' | 'scanKeys' | 'evalScript'>;
+export declare const nodeRedisPreset: Pick<RedisServerCacheOptions, 'setWithExpiry' | 'scanKeys' | 'getListLength' | 'pushToList' | 'getListRange' | 'evalScript'>;
 //# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-redis
 description: Documentation for @mastra/redis. Use when working with @mastra/redis APIs, configuration, or implementation.
 metadata:
   package: "@mastra/redis"
-  version: "1.4.3"
+  version: "1.4.4"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.4.3",
+  "version": "1.4.4",
   "package": "@mastra/redis",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -1620,6 +1620,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 _mastra_core_cache.MastraServerCache {
 	client;
 	keyPrefix;
@@ -1629,6 +1661,9 @@ var RedisServerCache = class extends _mastra_core_cache.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;
@@ -1639,6 +1674,8 @@ var RedisServerCache = class extends _mastra_core_cache.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}`;
@@ -1700,13 +1737,34 @@ var RedisServerCache = class extends _mastra_core_cache.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 }),
@@ -1716,9 +1774,14 @@ 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
+exports.LIST_PUSH_INDEXED_SCRIPT = LIST_PUSH_INDEXED_SCRIPT;
 exports.RedisServerCache = RedisServerCache;
 exports.RedisStore = RedisStore;
 exports.ScoresRedis = ScoresRedis;