@chat-adapter/state-ioredis 4.2.0 → 4.3.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { StateAdapter, Lock } from 'chat';
+import { Logger, StateAdapter, Lock } from 'chat';
 import Redis from 'ioredis';
 
 interface IoRedisStateAdapterOptions {
@@ -6,12 +6,16 @@ interface IoRedisStateAdapterOptions {
     url: string;
     /** Key prefix for all Redis keys (default: "chat-sdk") */
     keyPrefix?: string;
+    /** Logger instance for error reporting */
+    logger: Logger;
 }
 interface IoRedisStateClientOptions {
     /** Existing ioredis client instance */
     client: Redis;
     /** Key prefix for all Redis keys (default: "chat-sdk") */
     keyPrefix?: string;
+    /** Logger instance for error reporting */
+    logger: Logger;
 }
 /**
  * Redis state adapter using ioredis for production use.
@@ -32,6 +36,7 @@ interface IoRedisStateClientOptions {
 declare class IoRedisStateAdapter implements StateAdapter {
     private client;
     private keyPrefix;
+    private logger;
     private connected;
     private connectPromise;
     private ownsClient;

package/dist/index.js

@@ -3,6 +3,7 @@ import Redis from "ioredis";
 var IoRedisStateAdapter = class {
   client;
   keyPrefix;
+  logger;
   connected = false;
   connectPromise = null;
   ownsClient;
@@ -15,8 +16,9 @@ var IoRedisStateAdapter = class {
       this.ownsClient = true;
     }
     this.keyPrefix = options.keyPrefix || "chat-sdk";
+    this.logger = options.logger;
     this.client.on("error", (err) => {
-      console.error("[chat-sdk] ioredis client error:", err);
+      this.logger.error("ioredis client error", { error: err });
     });
   }
   key(type, id) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Lock, StateAdapter } from \"chat\";\nimport Redis from \"ioredis\";\n\nexport interface IoRedisStateAdapterOptions {\n  /** Redis connection URL (e.g., redis://localhost:6379) */\n  url: string;\n  /** Key prefix for all Redis keys (default: \"chat-sdk\") */\n  keyPrefix?: string;\n}\n\nexport interface IoRedisStateClientOptions {\n  /** Existing ioredis client instance */\n  client: Redis;\n  /** Key prefix for all Redis keys (default: \"chat-sdk\") */\n  keyPrefix?: string;\n}\n\n/**\n * Redis state adapter using ioredis for production use.\n *\n * Provides persistent subscriptions and distributed locking\n * across multiple server instances.\n *\n * @example\n * ```typescript\n * // With URL\n * const state = createIoRedisState({ url: process.env.REDIS_URL });\n *\n * // With existing client\n * const client = new Redis(process.env.REDIS_URL);\n * const state = createIoRedisState({ client });\n * ```\n */\nexport class IoRedisStateAdapter implements StateAdapter {\n  private client: Redis;\n  private keyPrefix: string;\n  private connected = false;\n  private connectPromise: Promise<void> | null = null;\n  private ownsClient: boolean;\n\n  constructor(options: IoRedisStateAdapterOptions | IoRedisStateClientOptions) {\n    if (\"client\" in options) {\n      this.client = options.client;\n      this.ownsClient = false;\n    } else {\n      this.client = new Redis(options.url);\n      this.ownsClient = true;\n    }\n    this.keyPrefix = options.keyPrefix || \"chat-sdk\";\n\n    // Handle connection errors\n    this.client.on(\"error\", (err) => {\n      console.error(\"[chat-sdk] ioredis client 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    // ioredis auto-connects, but we track state for consistency\n    if (this.connected) {\n      return;\n    }\n\n    // Reuse existing connection attempt to avoid race conditions\n    if (!this.connectPromise) {\n      this.connectPromise = new Promise<void>((resolve, reject) => {\n        if (this.client.status === \"ready\") {\n          this.connected = true;\n          resolve();\n          return;\n        }\n\n        this.client.once(\"ready\", () => {\n          this.connected = true;\n          resolve();\n        });\n\n        this.client.once(\"error\", (err) => {\n          reject(err);\n        });\n      });\n    }\n\n    await this.connectPromise;\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.connected && this.ownsClient) {\n      await this.client.quit();\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 *listSubscriptions(adapterName?: string): AsyncIterable<string> {\n    this.ensureConnected();\n\n    // Use SSCAN for large sets to avoid blocking\n    let cursor = \"0\";\n    do {\n      const [nextCursor, members] = await this.client.sscan(\n        this.subscriptionsSetKey(),\n        cursor,\n        \"COUNT\",\n        100,\n      );\n      cursor = nextCursor;\n\n      for (const threadId of members) {\n        if (adapterName) {\n          if (threadId.startsWith(`${adapterName}:`)) {\n            yield threadId;\n          }\n        } else {\n          yield threadId;\n        }\n      }\n    } while (cursor !== \"0\");\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 PX for atomic lock acquisition\n    const acquired = await this.client.set(lockKey, token, \"PX\", ttlMs, \"NX\");\n\n    if (acquired === \"OK\") {\n      return {\n        threadId,\n        token,\n        expiresAt: Date.now() + ttlMs,\n      };\n    }\n\n    return null;\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, 1, lockKey, lock.token);\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(\n      script,\n      1,\n      lockKey,\n      lock.token,\n      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 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  private ensureConnected(): void {\n    if (!this.connected) {\n      throw new Error(\n        \"IoRedisStateAdapter is not connected. Call connect() first.\",\n      );\n    }\n  }\n\n  /**\n   * Get the underlying ioredis client for advanced usage.\n   */\n  getClient(): Redis {\n    return this.client;\n  }\n}\n\nfunction generateToken(): string {\n  return `ioredis_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;\n}\n\n/**\n * Create an ioredis state adapter.\n *\n * @example\n * ```typescript\n * // With URL\n * const state = createIoRedisState({ url: process.env.REDIS_URL });\n *\n * // With existing client\n * import Redis from \"ioredis\";\n * const client = new Redis(process.env.REDIS_URL);\n * const state = createIoRedisState({ client });\n * ```\n */\nexport function createIoRedisState(\n  options: IoRedisStateAdapterOptions | IoRedisStateClientOptions,\n): IoRedisStateAdapter {\n  return new IoRedisStateAdapter(options);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Lock, Logger, StateAdapter } from \"chat\";\nimport Redis from \"ioredis\";\n\nexport interface IoRedisStateAdapterOptions {\n  /** Redis connection URL (e.g., redis://localhost:6379) */\n  url: string;\n  /** Key prefix for all Redis keys (default: \"chat-sdk\") */\n  keyPrefix?: string;\n  /** Logger instance for error reporting */\n  logger: Logger;\n}\n\nexport interface IoRedisStateClientOptions {\n  /** Existing ioredis client instance */\n  client: Redis;\n  /** Key prefix for all Redis keys (default: \"chat-sdk\") */\n  keyPrefix?: string;\n  /** Logger instance for error reporting */\n  logger: Logger;\n}\n\n/**\n * Redis state adapter using ioredis for production use.\n *\n * Provides persistent subscriptions and distributed locking\n * across multiple server instances.\n *\n * @example\n * ```typescript\n * // With URL\n * const state = createIoRedisState({ url: process.env.REDIS_URL });\n *\n * // With existing client\n * const client = new Redis(process.env.REDIS_URL);\n * const state = createIoRedisState({ client });\n * ```\n */\nexport class IoRedisStateAdapter implements StateAdapter {\n  private client: Redis;\n  private keyPrefix: string;\n  private logger: Logger;\n  private connected = false;\n  private connectPromise: Promise<void> | null = null;\n  private ownsClient: boolean;\n\n  constructor(options: IoRedisStateAdapterOptions | IoRedisStateClientOptions) {\n    if (\"client\" in options) {\n      this.client = options.client;\n      this.ownsClient = false;\n    } else {\n      this.client = new Redis(options.url);\n      this.ownsClient = true;\n    }\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(\"ioredis 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    // ioredis auto-connects, but we track state for consistency\n    if (this.connected) {\n      return;\n    }\n\n    // Reuse existing connection attempt to avoid race conditions\n    if (!this.connectPromise) {\n      this.connectPromise = new Promise<void>((resolve, reject) => {\n        if (this.client.status === \"ready\") {\n          this.connected = true;\n          resolve();\n          return;\n        }\n\n        this.client.once(\"ready\", () => {\n          this.connected = true;\n          resolve();\n        });\n\n        this.client.once(\"error\", (err) => {\n          reject(err);\n        });\n      });\n    }\n\n    await this.connectPromise;\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.connected && this.ownsClient) {\n      await this.client.quit();\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 *listSubscriptions(adapterName?: string): AsyncIterable<string> {\n    this.ensureConnected();\n\n    // Use SSCAN for large sets to avoid blocking\n    let cursor = \"0\";\n    do {\n      const [nextCursor, members] = await this.client.sscan(\n        this.subscriptionsSetKey(),\n        cursor,\n        \"COUNT\",\n        100,\n      );\n      cursor = nextCursor;\n\n      for (const threadId of members) {\n        if (adapterName) {\n          if (threadId.startsWith(`${adapterName}:`)) {\n            yield threadId;\n          }\n        } else {\n          yield threadId;\n        }\n      }\n    } while (cursor !== \"0\");\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 PX for atomic lock acquisition\n    const acquired = await this.client.set(lockKey, token, \"PX\", ttlMs, \"NX\");\n\n    if (acquired === \"OK\") {\n      return {\n        threadId,\n        token,\n        expiresAt: Date.now() + ttlMs,\n      };\n    }\n\n    return null;\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, 1, lockKey, lock.token);\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(\n      script,\n      1,\n      lockKey,\n      lock.token,\n      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 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  private ensureConnected(): void {\n    if (!this.connected) {\n      throw new Error(\n        \"IoRedisStateAdapter is not connected. Call connect() first.\",\n      );\n    }\n  }\n\n  /**\n   * Get the underlying ioredis client for advanced usage.\n   */\n  getClient(): Redis {\n    return this.client;\n  }\n}\n\nfunction generateToken(): string {\n  return `ioredis_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;\n}\n\n/**\n * Create an ioredis state adapter.\n *\n * @example\n * ```typescript\n * // With URL\n * const state = createIoRedisState({ url: process.env.REDIS_URL });\n *\n * // With existing client\n * import Redis from \"ioredis\";\n * const client = new Redis(process.env.REDIS_URL);\n * const state = createIoRedisState({ client });\n * ```\n */\nexport function createIoRedisState(\n  options: IoRedisStateAdapterOptions | IoRedisStateClientOptions,\n): IoRedisStateAdapter {\n  return new IoRedisStateAdapter(options);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chat-adapter/state-ioredis",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "ioredis state adapter for chat (production)",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
   ],
   "dependencies": {
     "ioredis": "^5.4.1",
-    "chat": "4.2.0"
+    "chat": "4.3.0"
   },
   "repository": {
     "type": "git",