@chat-adapter/state-redis 4.20.2 → 4.22.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Logger, StateAdapter, Lock } from 'chat';
+import { Logger, StateAdapter, Lock, QueueEntry } from 'chat';
 import { RedisClientType } from 'redis';
 
 interface RedisStateAdapterOptions {
@@ -41,6 +41,9 @@ declare class RedisStateAdapter implements StateAdapter {
         maxLength?: number;
         ttlMs?: number;
     }): Promise<void>;
+    enqueue(threadId: string, entry: QueueEntry, maxSize: number): Promise<number>;
+    dequeue(threadId: string): Promise<QueueEntry | null>;
+    queueDepth(threadId: string): Promise<number>;
     getList<T = unknown>(key: string): Promise<T[]>;
     private ensureConnected;
     /**

package/dist/index.js

@@ -164,6 +164,39 @@ var RedisStateAdapter = class {
       arguments: [serialized, maxLength.toString(), ttlMs.toString()]
     });
   }
+  async enqueue(threadId, entry, maxSize) {
+    this.ensureConnected();
+    const queueKey = this.key("queue", threadId);
+    const serialized = JSON.stringify(entry);
+    const script = `
+      redis.call("rpush", KEYS[1], ARGV[1])
+      if tonumber(ARGV[2]) > 0 then
+        redis.call("ltrim", KEYS[1], -tonumber(ARGV[2]), -1)
+      end
+      redis.call("pexpire", KEYS[1], ARGV[3])
+      return redis.call("llen", KEYS[1])
+    `;
+    const ttlMs = Math.max(entry.expiresAt - Date.now(), 6e4).toString();
+    const result = await this.client.eval(script, {
+      keys: [queueKey],
+      arguments: [serialized, maxSize.toString(), ttlMs]
+    });
+    return result;
+  }
+  async dequeue(threadId) {
+    this.ensureConnected();
+    const queueKey = this.key("queue", threadId);
+    const value = await this.client.lPop(queueKey);
+    if (value === null) {
+      return null;
+    }
+    return JSON.parse(value);
+  }
+  async queueDepth(threadId) {
+    this.ensureConnected();
+    const queueKey = this.key("queue", threadId);
+    return await this.client.lLen(queueKey);
+  }
   async getList(key) {
     this.ensureConnected();
     const listKey = `${this.keyPrefix}:list:${key}`;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Lock, Logger, StateAdapter } from \"chat\";\nimport { ConsoleLogger } from \"chat\";\nimport { createClient, type RedisClientType } from \"redis\";\n\nexport interface RedisStateAdapterOptions {\n  /** Key prefix for all Redis keys (default: \"chat-sdk\") */\n  keyPrefix?: string;\n  /** Logger instance for error reporting */\n  logger: Logger;\n  /** Redis connection URL (e.g., redis://localhost:6379) */\n  url: string;\n}\n\n/**\n * Redis state adapter for production use.\n *\n * Provides persistent subscriptions and distributed locking\n * across multiple server instances.\n */\nexport class RedisStateAdapter implements StateAdapter {\n  private readonly client: RedisClientType;\n  private readonly keyPrefix: string;\n  private readonly logger: Logger;\n  private connected = false;\n  private connectPromise: Promise<void> | null = null;\n\n  constructor(options: RedisStateAdapterOptions) {\n    this.client = createClient({ url: options.url });\n    this.keyPrefix = options.keyPrefix || \"chat-sdk\";\n    this.logger = options.logger;\n\n    // Handle connection errors\n    this.client.on(\"error\", (err) => {\n      this.logger.error(\"Redis client error\", { error: err });\n    });\n  }\n\n  private key(type: \"sub\" | \"lock\" | \"cache\", id: string): string {\n    return `${this.keyPrefix}:${type}:${id}`;\n  }\n\n  private subscriptionsSetKey(): string {\n    return `${this.keyPrefix}:subscriptions`;\n  }\n\n  async connect(): Promise<void> {\n    if (this.connected) {\n      return;\n    }\n\n    // Reuse existing connection attempt to avoid race conditions\n    if (!this.connectPromise) {\n      this.connectPromise = this.client.connect().then(() => {\n        this.connected = true;\n      });\n    }\n\n    await this.connectPromise;\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.connected) {\n      await this.client.close();\n      this.connected = false;\n      this.connectPromise = null;\n    }\n  }\n\n  async subscribe(threadId: string): Promise<void> {\n    this.ensureConnected();\n    await this.client.sAdd(this.subscriptionsSetKey(), threadId);\n  }\n\n  async unsubscribe(threadId: string): Promise<void> {\n    this.ensureConnected();\n    await this.client.sRem(this.subscriptionsSetKey(), threadId);\n  }\n\n  async isSubscribed(threadId: string): Promise<boolean> {\n    this.ensureConnected();\n    const result = await this.client.sIsMember(\n      this.subscriptionsSetKey(),\n      threadId\n    );\n    return result === 1;\n  }\n\n  async acquireLock(threadId: string, ttlMs: number): Promise<Lock | null> {\n    this.ensureConnected();\n\n    const token = generateToken();\n    const lockKey = this.key(\"lock\", threadId);\n\n    // Use SET NX EX for atomic lock acquisition\n    const acquired = await this.client.set(lockKey, token, {\n      NX: true,\n      PX: ttlMs,\n    });\n\n    if (acquired) {\n      return {\n        threadId,\n        token,\n        expiresAt: Date.now() + ttlMs,\n      };\n    }\n\n    return null;\n  }\n\n  async forceReleaseLock(threadId: string): Promise<void> {\n    this.ensureConnected();\n    const lockKey = this.key(\"lock\", threadId);\n    await this.client.del(lockKey);\n  }\n\n  async releaseLock(lock: Lock): Promise<void> {\n    this.ensureConnected();\n\n    const lockKey = this.key(\"lock\", lock.threadId);\n\n    // Use Lua script for atomic check-and-delete\n    const script = `\n      if redis.call(\"get\", KEYS[1]) == ARGV[1] then\n        return redis.call(\"del\", KEYS[1])\n      else\n        return 0\n      end\n    `;\n\n    await this.client.eval(script, {\n      keys: [lockKey],\n      arguments: [lock.token],\n    });\n  }\n\n  async extendLock(lock: Lock, ttlMs: number): Promise<boolean> {\n    this.ensureConnected();\n\n    const lockKey = this.key(\"lock\", lock.threadId);\n\n    // Use Lua script for atomic check-and-extend\n    const script = `\n      if redis.call(\"get\", KEYS[1]) == ARGV[1] then\n        return redis.call(\"pexpire\", KEYS[1], ARGV[2])\n      else\n        return 0\n      end\n    `;\n\n    const result = await this.client.eval(script, {\n      keys: [lockKey],\n      arguments: [lock.token, ttlMs.toString()],\n    });\n\n    return result === 1;\n  }\n\n  async get<T = unknown>(key: string): Promise<T | null> {\n    this.ensureConnected();\n\n    const cacheKey = this.key(\"cache\", key);\n    const value = await this.client.get(cacheKey);\n\n    if (value === null) {\n      return null;\n    }\n\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      // If parsing fails, return as string\n      return value as unknown as T;\n    }\n  }\n\n  async set<T = unknown>(key: string, value: T, ttlMs?: number): Promise<void> {\n    this.ensureConnected();\n\n    const cacheKey = this.key(\"cache\", key);\n    const serialized = JSON.stringify(value);\n\n    if (ttlMs) {\n      await this.client.set(cacheKey, serialized, { PX: ttlMs });\n    } else {\n      await this.client.set(cacheKey, serialized);\n    }\n  }\n\n  async setIfNotExists(\n    key: string,\n    value: unknown,\n    ttlMs?: number\n  ): Promise<boolean> {\n    this.ensureConnected();\n\n    const cacheKey = this.key(\"cache\", key);\n    const serialized = JSON.stringify(value);\n\n    const result = ttlMs\n      ? await this.client.set(cacheKey, serialized, { NX: true, PX: ttlMs })\n      : await this.client.set(cacheKey, serialized, { NX: true });\n\n    return result !== null;\n  }\n\n  async delete(key: string): Promise<void> {\n    this.ensureConnected();\n\n    const cacheKey = this.key(\"cache\", key);\n    await this.client.del(cacheKey);\n  }\n\n  async appendToList(\n    key: string,\n    value: unknown,\n    options?: { maxLength?: number; ttlMs?: number }\n  ): Promise<void> {\n    this.ensureConnected();\n\n    const listKey = `${this.keyPrefix}:list:${key}`;\n    const serialized = JSON.stringify(value);\n    const maxLength = options?.maxLength ?? 0;\n    const ttlMs = options?.ttlMs ?? 0;\n\n    // Atomic RPUSH + LTRIM + PEXPIRE via Lua\n    const script = `\n      redis.call(\"rpush\", KEYS[1], ARGV[1])\n      if tonumber(ARGV[2]) > 0 then\n        redis.call(\"ltrim\", KEYS[1], -tonumber(ARGV[2]), -1)\n      end\n      if tonumber(ARGV[3]) > 0 then\n        redis.call(\"pexpire\", KEYS[1], tonumber(ARGV[3]))\n      end\n      return 1\n    `;\n\n    await this.client.eval(script, {\n      keys: [listKey],\n      arguments: [serialized, maxLength.toString(), ttlMs.toString()],\n    });\n  }\n\n  async getList<T = unknown>(key: string): Promise<T[]> {\n    this.ensureConnected();\n\n    const listKey = `${this.keyPrefix}:list:${key}`;\n    const values = await this.client.lRange(listKey, 0, -1);\n\n    return values.map((v) => JSON.parse(v) as T);\n  }\n\n  private ensureConnected(): void {\n    if (!this.connected) {\n      throw new Error(\n        \"RedisStateAdapter is not connected. Call connect() first.\"\n      );\n    }\n  }\n\n  /**\n   * Get the underlying Redis client for advanced usage.\n   */\n  getClient(): RedisClientType {\n    return this.client;\n  }\n}\n\nfunction generateToken(): string {\n  return `redis_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;\n}\n\nexport function createRedisState(\n  options?: Partial<RedisStateAdapterOptions>\n): RedisStateAdapter {\n  const url = options?.url ?? process.env.REDIS_URL;\n  if (!url) {\n    throw new Error(\n      \"Redis url is required. Set REDIS_URL or provide it in options.\"\n    );\n  }\n  const resolved: RedisStateAdapterOptions = {\n    url,\n    keyPrefix: options?.keyPrefix,\n    logger: options?.logger ?? new ConsoleLogger(\"info\").child(\"redis\"),\n  };\n  return new RedisStateAdapter(resolved);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Lock, Logger, QueueEntry, StateAdapter } from \"chat\";\nimport { ConsoleLogger } from \"chat\";\nimport { createClient, type RedisClientType } from \"redis\";\n\nexport interface RedisStateAdapterOptions {\n  /** Key prefix for all Redis keys (default: \"chat-sdk\") */\n  keyPrefix?: string;\n  /** Logger instance for error reporting */\n  logger: Logger;\n  /** Redis connection URL (e.g., redis://localhost:6379) */\n  url: string;\n}\n\n/**\n * Redis state adapter for production use.\n *\n * Provides persistent subscriptions and distributed locking\n * across multiple server instances.\n */\nexport class RedisStateAdapter implements StateAdapter {\n  private readonly client: RedisClientType;\n  private readonly keyPrefix: string;\n  private readonly logger: Logger;\n  private connected = false;\n  private connectPromise: Promise<void> | null = null;\n\n  constructor(options: RedisStateAdapterOptions) {\n    this.client = createClient({ url: options.url });\n    this.keyPrefix = options.keyPrefix || \"chat-sdk\";\n    this.logger = options.logger;\n\n    // Handle connection errors\n    this.client.on(\"error\", (err) => {\n      this.logger.error(\"Redis client error\", { error: err });\n    });\n  }\n\n  private key(type: \"sub\" | \"lock\" | \"cache\" | \"queue\", id: string): string {\n    return `${this.keyPrefix}:${type}:${id}`;\n  }\n\n  private subscriptionsSetKey(): string {\n    return `${this.keyPrefix}:subscriptions`;\n  }\n\n  async connect(): Promise<void> {\n    if (this.connected) {\n      return;\n    }\n\n    // Reuse existing connection attempt to avoid race conditions\n    if (!this.connectPromise) {\n      this.connectPromise = this.client.connect().then(() => {\n        this.connected = true;\n      });\n    }\n\n    await this.connectPromise;\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.connected) {\n      await this.client.close();\n      this.connected = false;\n      this.connectPromise = null;\n    }\n  }\n\n  async subscribe(threadId: string): Promise<void> {\n    this.ensureConnected();\n    await this.client.sAdd(this.subscriptionsSetKey(), threadId);\n  }\n\n  async unsubscribe(threadId: string): Promise<void> {\n    this.ensureConnected();\n    await this.client.sRem(this.subscriptionsSetKey(), threadId);\n  }\n\n  async isSubscribed(threadId: string): Promise<boolean> {\n    this.ensureConnected();\n    const result = await this.client.sIsMember(\n      this.subscriptionsSetKey(),\n      threadId\n    );\n    return result === 1;\n  }\n\n  async acquireLock(threadId: string, ttlMs: number): Promise<Lock | null> {\n    this.ensureConnected();\n\n    const token = generateToken();\n    const lockKey = this.key(\"lock\", threadId);\n\n    // Use SET NX EX for atomic lock acquisition\n    const acquired = await this.client.set(lockKey, token, {\n      NX: true,\n      PX: ttlMs,\n    });\n\n    if (acquired) {\n      return {\n        threadId,\n        token,\n        expiresAt: Date.now() + ttlMs,\n      };\n    }\n\n    return null;\n  }\n\n  async forceReleaseLock(threadId: string): Promise<void> {\n    this.ensureConnected();\n    const lockKey = this.key(\"lock\", threadId);\n    await this.client.del(lockKey);\n  }\n\n  async releaseLock(lock: Lock): Promise<void> {\n    this.ensureConnected();\n\n    const lockKey = this.key(\"lock\", lock.threadId);\n\n    // Use Lua script for atomic check-and-delete\n    const script = `\n      if redis.call(\"get\", KEYS[1]) == ARGV[1] then\n        return redis.call(\"del\", KEYS[1])\n      else\n        return 0\n      end\n    `;\n\n    await this.client.eval(script, {\n      keys: [lockKey],\n      arguments: [lock.token],\n    });\n  }\n\n  async extendLock(lock: Lock, ttlMs: number): Promise<boolean> {\n    this.ensureConnected();\n\n    const lockKey = this.key(\"lock\", lock.threadId);\n\n    // Use Lua script for atomic check-and-extend\n    const script = `\n      if redis.call(\"get\", KEYS[1]) == ARGV[1] then\n        return redis.call(\"pexpire\", KEYS[1], ARGV[2])\n      else\n        return 0\n      end\n    `;\n\n    const result = await this.client.eval(script, {\n      keys: [lockKey],\n      arguments: [lock.token, ttlMs.toString()],\n    });\n\n    return result === 1;\n  }\n\n  async get<T = unknown>(key: string): Promise<T | null> {\n    this.ensureConnected();\n\n    const cacheKey = this.key(\"cache\", key);\n    const value = await this.client.get(cacheKey);\n\n    if (value === null) {\n      return null;\n    }\n\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      // If parsing fails, return as string\n      return value as unknown as T;\n    }\n  }\n\n  async set<T = unknown>(key: string, value: T, ttlMs?: number): Promise<void> {\n    this.ensureConnected();\n\n    const cacheKey = this.key(\"cache\", key);\n    const serialized = JSON.stringify(value);\n\n    if (ttlMs) {\n      await this.client.set(cacheKey, serialized, { PX: ttlMs });\n    } else {\n      await this.client.set(cacheKey, serialized);\n    }\n  }\n\n  async setIfNotExists(\n    key: string,\n    value: unknown,\n    ttlMs?: number\n  ): Promise<boolean> {\n    this.ensureConnected();\n\n    const cacheKey = this.key(\"cache\", key);\n    const serialized = JSON.stringify(value);\n\n    const result = ttlMs\n      ? await this.client.set(cacheKey, serialized, { NX: true, PX: ttlMs })\n      : await this.client.set(cacheKey, serialized, { NX: true });\n\n    return result !== null;\n  }\n\n  async delete(key: string): Promise<void> {\n    this.ensureConnected();\n\n    const cacheKey = this.key(\"cache\", key);\n    await this.client.del(cacheKey);\n  }\n\n  async appendToList(\n    key: string,\n    value: unknown,\n    options?: { maxLength?: number; ttlMs?: number }\n  ): Promise<void> {\n    this.ensureConnected();\n\n    const listKey = `${this.keyPrefix}:list:${key}`;\n    const serialized = JSON.stringify(value);\n    const maxLength = options?.maxLength ?? 0;\n    const ttlMs = options?.ttlMs ?? 0;\n\n    // Atomic RPUSH + LTRIM + PEXPIRE via Lua\n    const script = `\n      redis.call(\"rpush\", KEYS[1], ARGV[1])\n      if tonumber(ARGV[2]) > 0 then\n        redis.call(\"ltrim\", KEYS[1], -tonumber(ARGV[2]), -1)\n      end\n      if tonumber(ARGV[3]) > 0 then\n        redis.call(\"pexpire\", KEYS[1], tonumber(ARGV[3]))\n      end\n      return 1\n    `;\n\n    await this.client.eval(script, {\n      keys: [listKey],\n      arguments: [serialized, maxLength.toString(), ttlMs.toString()],\n    });\n  }\n\n  async enqueue(\n    threadId: string,\n    entry: QueueEntry,\n    maxSize: number\n  ): Promise<number> {\n    this.ensureConnected();\n\n    const queueKey = this.key(\"queue\", threadId);\n    const serialized = JSON.stringify(entry);\n\n    // Atomic RPUSH + LTRIM + PEXPIRE via Lua\n    const script = `\n      redis.call(\"rpush\", KEYS[1], ARGV[1])\n      if tonumber(ARGV[2]) > 0 then\n        redis.call(\"ltrim\", KEYS[1], -tonumber(ARGV[2]), -1)\n      end\n      redis.call(\"pexpire\", KEYS[1], ARGV[3])\n      return redis.call(\"llen\", KEYS[1])\n    `;\n\n    const ttlMs = Math.max(entry.expiresAt - Date.now(), 60_000).toString();\n\n    const result = await this.client.eval(script, {\n      keys: [queueKey],\n      arguments: [serialized, maxSize.toString(), ttlMs],\n    });\n\n    return result as number;\n  }\n\n  async dequeue(threadId: string): Promise<QueueEntry | null> {\n    this.ensureConnected();\n\n    const queueKey = this.key(\"queue\", threadId);\n    const value = await this.client.lPop(queueKey);\n\n    if (value === null) {\n      return null;\n    }\n\n    return JSON.parse(value) as QueueEntry;\n  }\n\n  async queueDepth(threadId: string): Promise<number> {\n    this.ensureConnected();\n\n    const queueKey = this.key(\"queue\", threadId);\n    return await this.client.lLen(queueKey);\n  }\n\n  async getList<T = unknown>(key: string): Promise<T[]> {\n    this.ensureConnected();\n\n    const listKey = `${this.keyPrefix}:list:${key}`;\n    const values = await this.client.lRange(listKey, 0, -1);\n\n    return values.map((v) => JSON.parse(v) as T);\n  }\n\n  private ensureConnected(): void {\n    if (!this.connected) {\n      throw new Error(\n        \"RedisStateAdapter is not connected. Call connect() first.\"\n      );\n    }\n  }\n\n  /**\n   * Get the underlying Redis client for advanced usage.\n   */\n  getClient(): RedisClientType {\n    return this.client;\n  }\n}\n\nfunction generateToken(): string {\n  return `redis_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;\n}\n\nexport function createRedisState(\n  options?: Partial<RedisStateAdapterOptions>\n): RedisStateAdapter {\n  const url = options?.url ?? process.env.REDIS_URL;\n  if (!url) {\n    throw new Error(\n      \"Redis url is required. Set REDIS_URL or provide it in options.\"\n    );\n  }\n  const resolved: RedisStateAdapterOptions = {\n    url,\n    keyPrefix: options?.keyPrefix,\n    logger: options?.logger ?? new ConsoleLogger(\"info\").child(\"redis\"),\n  };\n  return new RedisStateAdapter(resolved);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chat-adapter/state-redis",
-  "version": "4.20.2",
+  "version": "4.22.0",
   "description": "Redis state adapter for chat (production)",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
   ],
   "dependencies": {
     "redis": "^5.11.0",
-    "chat": "4.20.2"
+    "chat": "4.22.0"
   },
   "repository": {
     "type": "git",