@saga-bus/store-redis 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dean Foran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,218 @@
+# @saga-bus/store-redis
+
+Redis-backed saga store for saga-bus with optimistic concurrency.
+
+## Installation
+
+```bash
+npm install @saga-bus/store-redis ioredis
+# or
+pnpm add @saga-bus/store-redis ioredis
+```
+
+## Features
+
+- **Fast**: Sub-millisecond read/write operations
+- **Optimistic Concurrency**: WATCH/MULTI for conflict detection
+- **TTL Support**: Automatic cleanup of completed sagas
+- **Index Lookup**: Find sagas by ID or correlation ID
+- **Clustering**: Works with Redis Cluster
+
+## Quick Start
+
+```typescript
+import { createBus } from "@saga-bus/core";
+import { RedisSagaStore } from "@saga-bus/store-redis";
+
+const store = new RedisSagaStore({
+  connection: { host: "localhost", port: 6379 },
+  completedTtlSeconds: 86400, // Auto-cleanup after 1 day
+});
+
+await store.initialize();
+
+const bus = createBus({
+  store,
+  // ... other config
+});
+
+await bus.start();
+```
+
+## Configuration
+
+```typescript
+interface RedisSagaStoreOptions {
+  /** Existing Redis client */
+  redis?: Redis;
+
+  /** Connection options for creating new client */
+  connection?: RedisOptions;
+
+  /** Key prefix for all saga keys (default: "saga-bus:") */
+  keyPrefix?: string;
+
+  /** TTL in seconds for completed sagas (0 = no expiry) */
+  completedTtlSeconds?: number;
+
+  /** TTL in seconds for all sagas (0 = no expiry) */
+  defaultTtlSeconds?: number;
+
+  /** Maximum retries for optimistic locking conflicts (default: 3) */
+  maxRetries?: number;
+
+  /** Delay between retries in milliseconds (default: 100) */
+  retryDelayMs?: number;
+}
+```
+
+## Examples
+
+### Basic Usage
+
+```typescript
+import { RedisSagaStore } from "@saga-bus/store-redis";
+
+const store = new RedisSagaStore({
+  connection: { host: "localhost", port: 6379 },
+});
+
+await store.initialize();
+
+// Find by correlation ID
+const state = await store.findByCorrelationId("OrderSaga", "order-123");
+
+// Find by saga ID
+const stateById = await store.findById("OrderSaga", "saga-456");
+
+// Save state
+await store.save("OrderSaga", {
+  id: "saga-456",
+  correlationId: "order-123",
+  status: "running",
+  data: { orderId: "order-123" },
+  metadata: { /* ... */ },
+});
+
+// Delete
+await store.delete("OrderSaga", "order-123");
+```
+
+### With Existing Redis Client
+
+```typescript
+import { Redis } from "ioredis";
+
+const redis = new Redis({
+  host: "localhost",
+  port: 6379,
+  password: "secret",
+  db: 1,
+});
+
+const store = new RedisSagaStore({
+  redis,
+  keyPrefix: "myapp:",
+});
+```
+
+### With TTL for Auto-Cleanup
+
+```typescript
+const store = new RedisSagaStore({
+  connection: { host: "localhost", port: 6379 },
+  completedTtlSeconds: 86400,  // Delete completed sagas after 24 hours
+  defaultTtlSeconds: 604800,   // Delete all sagas after 7 days
+});
+```
+
+### Redis Cluster
+
+```typescript
+import { Cluster } from "ioredis";
+
+const cluster = new Cluster([
+  { host: "redis-1", port: 6379 },
+  { host: "redis-2", port: 6379 },
+  { host: "redis-3", port: 6379 },
+]);
+
+const store = new RedisSagaStore({
+  redis: cluster as any,
+});
+```
+
+## Key Structure
+
+The store uses the following key structure:
+
+```
+{prefix}saga:{sagaName}:{correlationId}     -> JSON serialized state
+{prefix}saga:{sagaName}:idx:id:{sagaId}     -> correlation ID (index)
+```
+
+Example:
+```
+saga-bus:saga:OrderSaga:order-123           -> {"id":"saga-456",...}
+saga-bus:saga:OrderSaga:idx:id:saga-456     -> "order-123"
+```
+
+## Optimistic Concurrency
+
+The store uses Redis WATCH/MULTI for optimistic locking:
+
+1. `WATCH` the key before reading
+2. Read current state and check version
+3. `MULTI` to start transaction
+4. `SET` new state
+5. `EXEC` - fails if key was modified
+
+If a conflict is detected, the operation is retried up to `maxRetries` times.
+
+```typescript
+const store = new RedisSagaStore({
+  connection: { host: "localhost", port: 6379 },
+  maxRetries: 5,      // More retries for high-contention scenarios
+  retryDelayMs: 50,   // Shorter delay between retries
+});
+```
+
+## Performance Considerations
+
+1. **Use Key Prefixes**: Helps with Redis SCAN operations and debugging
+2. **Set TTLs**: Prevents unbounded growth of saga data
+3. **Connection Pooling**: Reuse Redis connections across stores
+4. **Clustering**: Use Redis Cluster for horizontal scaling
+
+## Error Handling
+
+```typescript
+try {
+  await store.save("OrderSaga", state);
+} catch (error) {
+  if (error.message.includes("Optimistic concurrency conflict")) {
+    // State was modified by another process
+    // Reload and retry
+  }
+}
+```
+
+## Testing
+
+For testing, you can run Redis locally:
+
+```bash
+docker run -p 6379:6379 redis:latest
+```
+
+Or use an in-memory store for unit tests:
+
+```typescript
+import { InMemorySagaStore } from "@saga-bus/core";
+
+const testStore = new InMemorySagaStore();
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,212 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  RedisSagaStore: () => RedisSagaStore
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/RedisSagaStore.ts
+var import_ioredis = require("ioredis");
+var import_core = require("@saga-bus/core");
+var RedisSagaStore = class {
+  redis = null;
+  options;
+  ownsRedis;
+  constructor(options) {
+    if (!options.redis && !options.connection) {
+      throw new Error("Either redis or connection must be provided");
+    }
+    this.options = {
+      keyPrefix: "saga-bus:",
+      completedTtlSeconds: 0,
+      defaultTtlSeconds: 0,
+      maxRetries: 3,
+      retryDelayMs: 100,
+      ...options
+    };
+    this.ownsRedis = !options.redis;
+  }
+  async initialize() {
+    if (this.options.redis) {
+      this.redis = this.options.redis;
+    } else {
+      this.redis = new import_ioredis.Redis(this.options.connection);
+    }
+  }
+  async close() {
+    if (this.ownsRedis && this.redis) {
+      await this.redis.quit();
+    }
+    this.redis = null;
+  }
+  async getById(sagaName, sagaId) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const indexKey = this.buildIdIndexKey(sagaName, sagaId);
+    const correlationId = await this.redis.get(indexKey);
+    if (!correlationId) return null;
+    return this.getByCorrelationId(sagaName, correlationId);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const key = this.buildKey(sagaName, correlationId);
+    const data = await this.redis.get(key);
+    if (!data) return null;
+    return this.deserializeState(data);
+  }
+  async insert(sagaName, correlationId, state) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const key = this.buildKey(sagaName, correlationId);
+    const indexKey = this.buildIdIndexKey(sagaName, state.metadata.sagaId);
+    const existing = await this.redis.get(key);
+    if (existing) {
+      throw new Error(
+        `Saga ${sagaName} with correlation ID ${correlationId} already exists`
+      );
+    }
+    const serialized = this.serializeState(state);
+    let ttl = this.options.defaultTtlSeconds;
+    if (state.metadata.isCompleted && this.options.completedTtlSeconds > 0) {
+      ttl = this.options.completedTtlSeconds;
+    }
+    const multi = this.redis.multi();
+    if (ttl > 0) {
+      multi.setex(key, ttl, serialized);
+      multi.setex(indexKey, ttl, correlationId);
+    } else {
+      multi.set(key, serialized);
+      multi.set(indexKey, correlationId);
+    }
+    await multi.exec();
+  }
+  async update(sagaName, state, expectedVersion) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const indexKey = this.buildIdIndexKey(sagaName, state.metadata.sagaId);
+    const correlationId = await this.redis.get(indexKey);
+    if (!correlationId) {
+      throw new Error(`Saga ${state.metadata.sagaId} not found`);
+    }
+    const key = this.buildKey(sagaName, correlationId);
+    for (let attempt = 0; attempt < this.options.maxRetries; attempt++) {
+      await this.redis.watch(key);
+      try {
+        const existing = await this.redis.get(key);
+        if (!existing) {
+          await this.redis.unwatch();
+          throw new Error(`Saga ${state.metadata.sagaId} not found`);
+        }
+        const currentState = this.deserializeState(existing);
+        if (currentState.metadata.version !== expectedVersion) {
+          await this.redis.unwatch();
+          throw new import_core.ConcurrencyError(
+            state.metadata.sagaId,
+            expectedVersion,
+            currentState.metadata.version
+          );
+        }
+        const multi = this.redis.multi();
+        const serialized = this.serializeState(state);
+        let ttl = this.options.defaultTtlSeconds;
+        if (state.metadata.isCompleted && this.options.completedTtlSeconds > 0) {
+          ttl = this.options.completedTtlSeconds;
+        }
+        if (ttl > 0) {
+          multi.setex(key, ttl, serialized);
+          multi.setex(indexKey, ttl, correlationId);
+        } else {
+          multi.set(key, serialized);
+          multi.set(indexKey, correlationId);
+        }
+        const result = await multi.exec();
+        if (result === null) {
+          if (attempt < this.options.maxRetries - 1) {
+            await this.delay(this.options.retryDelayMs);
+            continue;
+          }
+          throw new import_core.ConcurrencyError(
+            state.metadata.sagaId,
+            expectedVersion,
+            -1
+            // Unknown current version due to race
+          );
+        }
+        return;
+      } catch (error) {
+        await this.redis.unwatch();
+        throw error;
+      }
+    }
+  }
+  async delete(sagaName, sagaId) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const indexKey = this.buildIdIndexKey(sagaName, sagaId);
+    const correlationId = await this.redis.get(indexKey);
+    if (!correlationId) return;
+    const key = this.buildKey(sagaName, correlationId);
+    await this.redis.del(key, indexKey);
+  }
+  buildKey(sagaName, correlationId) {
+    return `${this.options.keyPrefix}saga:${sagaName}:${correlationId}`;
+  }
+  buildIdIndexKey(sagaName, sagaId) {
+    return `${this.options.keyPrefix}saga:${sagaName}:idx:id:${sagaId}`;
+  }
+  serializeState(state) {
+    return JSON.stringify({
+      ...state,
+      metadata: {
+        ...state.metadata,
+        createdAt: state.metadata.createdAt.toISOString(),
+        updatedAt: state.metadata.updatedAt.toISOString(),
+        archivedAt: state.metadata.archivedAt?.toISOString() ?? null,
+        timeoutExpiresAt: state.metadata.timeoutExpiresAt?.toISOString() ?? null
+      }
+    });
+  }
+  deserializeState(data) {
+    const parsed = JSON.parse(data);
+    return {
+      ...parsed,
+      metadata: {
+        ...parsed.metadata,
+        createdAt: new Date(parsed.metadata.createdAt),
+        updatedAt: new Date(parsed.metadata.updatedAt),
+        archivedAt: parsed.metadata.archivedAt ? new Date(parsed.metadata.archivedAt) : null,
+        timeoutExpiresAt: parsed.metadata.timeoutExpiresAt ? new Date(parsed.metadata.timeoutExpiresAt) : null
+      }
+    };
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  // ============ Query Helpers ============
+  /**
+   * Get the underlying Redis client for advanced operations.
+   */
+  getRedis() {
+    return this.redis;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RedisSagaStore
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/RedisSagaStore.ts"],"sourcesContent":["export { RedisSagaStore } from \"./RedisSagaStore.js\";\nexport type { RedisSagaStoreOptions } from \"./types.js\";\n","import { Redis } from \"ioredis\";\nimport type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type { RedisSagaStoreOptions } from \"./types.js\";\n\n/**\n * Redis-backed saga store for saga-bus.\n *\n * Uses WATCH/MULTI for optimistic concurrency control.\n *\n * @example\n * ```typescript\n * import { RedisSagaStore } from \"@saga-bus/store-redis\";\n *\n * const store = new RedisSagaStore<OrderState>({\n *   connection: { host: \"localhost\", port: 6379 },\n *   completedTtlSeconds: 86400, // 1 day\n * });\n *\n * await store.initialize();\n * ```\n */\nexport class RedisSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private redis: Redis | null = null;\n  private readonly options: Required<\n    Pick<\n      RedisSagaStoreOptions,\n      | \"keyPrefix\"\n      | \"completedTtlSeconds\"\n      | \"defaultTtlSeconds\"\n      | \"maxRetries\"\n      | \"retryDelayMs\"\n    >\n  > &\n    RedisSagaStoreOptions;\n  private readonly ownsRedis: boolean;\n\n  constructor(options: RedisSagaStoreOptions) {\n    if (!options.redis && !options.connection) {\n      throw new Error(\"Either redis or connection must be provided\");\n    }\n\n    this.options = {\n      keyPrefix: \"saga-bus:\",\n      completedTtlSeconds: 0,\n      defaultTtlSeconds: 0,\n      maxRetries: 3,\n      retryDelayMs: 100,\n      ...options,\n    };\n\n    this.ownsRedis = !options.redis;\n  }\n\n  async initialize(): Promise<void> {\n    if (this.options.redis) {\n      this.redis = this.options.redis;\n    } else {\n      this.redis = new Redis(this.options.connection!);\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.ownsRedis && this.redis) {\n      await this.redis.quit();\n    }\n    this.redis = null;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    // Lookup correlation ID from index\n    const indexKey = this.buildIdIndexKey(sagaName, sagaId);\n    const correlationId = await this.redis.get(indexKey);\n\n    if (!correlationId) return null;\n\n    return this.getByCorrelationId(sagaName, correlationId);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    const key = this.buildKey(sagaName, correlationId);\n    const data = await this.redis.get(key);\n\n    if (!data) return null;\n\n    return this.deserializeState(data);\n  }\n\n  async insert(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    const key = this.buildKey(sagaName, correlationId);\n    const indexKey = this.buildIdIndexKey(sagaName, state.metadata.sagaId);\n\n    // Check if saga already exists\n    const existing = await this.redis.get(key);\n    if (existing) {\n      throw new Error(\n        `Saga ${sagaName} with correlation ID ${correlationId} already exists`\n      );\n    }\n\n    // Serialize and save\n    const serialized = this.serializeState(state);\n\n    // Determine TTL\n    let ttl = this.options.defaultTtlSeconds;\n    if (state.metadata.isCompleted && this.options.completedTtlSeconds > 0) {\n      ttl = this.options.completedTtlSeconds;\n    }\n\n    const multi = this.redis.multi();\n\n    if (ttl > 0) {\n      multi.setex(key, ttl, serialized);\n      multi.setex(indexKey, ttl, correlationId);\n    } else {\n      multi.set(key, serialized);\n      multi.set(indexKey, correlationId);\n    }\n\n    await multi.exec();\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    // We need to find the correlation ID for this saga\n    const indexKey = this.buildIdIndexKey(sagaName, state.metadata.sagaId);\n    const correlationId = await this.redis.get(indexKey);\n\n    if (!correlationId) {\n      throw new Error(`Saga ${state.metadata.sagaId} not found`);\n    }\n\n    const key = this.buildKey(sagaName, correlationId);\n\n    for (let attempt = 0; attempt < this.options.maxRetries; attempt++) {\n      // Watch the key for changes\n      await this.redis.watch(key);\n\n      try {\n        // Check current version\n        const existing = await this.redis.get(key);\n        if (!existing) {\n          await this.redis.unwatch();\n          throw new Error(`Saga ${state.metadata.sagaId} not found`);\n        }\n\n        const currentState = this.deserializeState(existing);\n        if (currentState.metadata.version !== expectedVersion) {\n          await this.redis.unwatch();\n          throw new ConcurrencyError(\n            state.metadata.sagaId,\n            expectedVersion,\n            currentState.metadata.version\n          );\n        }\n\n        // Start transaction\n        const multi = this.redis.multi();\n\n        // Serialize and save\n        const serialized = this.serializeState(state);\n\n        // Determine TTL\n        let ttl = this.options.defaultTtlSeconds;\n        if (state.metadata.isCompleted && this.options.completedTtlSeconds > 0) {\n          ttl = this.options.completedTtlSeconds;\n        }\n\n        if (ttl > 0) {\n          multi.setex(key, ttl, serialized);\n          multi.setex(indexKey, ttl, correlationId);\n        } else {\n          multi.set(key, serialized);\n          multi.set(indexKey, correlationId);\n        }\n\n        // Execute transaction\n        const result = await multi.exec();\n\n        if (result === null) {\n          // Transaction aborted due to WATCH - retry\n          if (attempt < this.options.maxRetries - 1) {\n            await this.delay(this.options.retryDelayMs);\n            continue;\n          }\n          throw new ConcurrencyError(\n            state.metadata.sagaId,\n            expectedVersion,\n            -1 // Unknown current version due to race\n          );\n        }\n\n        return; // Success\n      } catch (error) {\n        await this.redis.unwatch();\n        throw error;\n      }\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    // Lookup correlation ID from index\n    const indexKey = this.buildIdIndexKey(sagaName, sagaId);\n    const correlationId = await this.redis.get(indexKey);\n\n    if (!correlationId) return;\n\n    const key = this.buildKey(sagaName, correlationId);\n    await this.redis.del(key, indexKey);\n  }\n\n  private buildKey(sagaName: string, correlationId: string): string {\n    return `${this.options.keyPrefix}saga:${sagaName}:${correlationId}`;\n  }\n\n  private buildIdIndexKey(sagaName: string, sagaId: string): string {\n    return `${this.options.keyPrefix}saga:${sagaName}:idx:id:${sagaId}`;\n  }\n\n  private serializeState(state: TState): string {\n    return JSON.stringify({\n      ...state,\n      metadata: {\n        ...state.metadata,\n        createdAt: state.metadata.createdAt.toISOString(),\n        updatedAt: state.metadata.updatedAt.toISOString(),\n        archivedAt: state.metadata.archivedAt?.toISOString() ?? null,\n        timeoutExpiresAt: state.metadata.timeoutExpiresAt?.toISOString() ?? null,\n      },\n    });\n  }\n\n  private deserializeState(data: string): TState {\n    const parsed = JSON.parse(data);\n    return {\n      ...parsed,\n      metadata: {\n        ...parsed.metadata,\n        createdAt: new Date(parsed.metadata.createdAt),\n        updatedAt: new Date(parsed.metadata.updatedAt),\n        archivedAt: parsed.metadata.archivedAt\n          ? new Date(parsed.metadata.archivedAt)\n          : null,\n        timeoutExpiresAt: parsed.metadata.timeoutExpiresAt\n          ? new Date(parsed.metadata.timeoutExpiresAt)\n          : null,\n      },\n    } as TState;\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  // ============ Query Helpers ============\n\n  /**\n   * Get the underlying Redis client for advanced operations.\n   */\n  getRedis(): Redis | null {\n    return this.redis;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,64 @@
+import { Redis, RedisOptions } from 'ioredis';
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+/**
+ * Configuration options for the Redis saga store.
+ */
+interface RedisSagaStoreOptions {
+    /** Existing Redis client */
+    redis?: Redis;
+    /** Connection options for creating new client */
+    connection?: RedisOptions;
+    /** Key prefix for all saga keys (default: "saga-bus:") */
+    keyPrefix?: string;
+    /** TTL in seconds for completed sagas (0 = no expiry, default: 0) */
+    completedTtlSeconds?: number;
+    /** TTL in seconds for all sagas (0 = no expiry, default: 0) */
+    defaultTtlSeconds?: number;
+    /** Maximum retries for optimistic locking conflicts (default: 3) */
+    maxRetries?: number;
+    /** Delay between retries in milliseconds (default: 100) */
+    retryDelayMs?: number;
+}
+
+/**
+ * Redis-backed saga store for saga-bus.
+ *
+ * Uses WATCH/MULTI for optimistic concurrency control.
+ *
+ * @example
+ * ```typescript
+ * import { RedisSagaStore } from "@saga-bus/store-redis";
+ *
+ * const store = new RedisSagaStore<OrderState>({
+ *   connection: { host: "localhost", port: 6379 },
+ *   completedTtlSeconds: 86400, // 1 day
+ * });
+ *
+ * await store.initialize();
+ * ```
+ */
+declare class RedisSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private redis;
+    private readonly options;
+    private readonly ownsRedis;
+    constructor(options: RedisSagaStoreOptions);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getById(sagaName: string, sagaId: string): Promise<TState | null>;
+    getByCorrelationId(sagaName: string, correlationId: string): Promise<TState | null>;
+    insert(sagaName: string, correlationId: string, state: TState): Promise<void>;
+    update(sagaName: string, state: TState, expectedVersion: number): Promise<void>;
+    delete(sagaName: string, sagaId: string): Promise<void>;
+    private buildKey;
+    private buildIdIndexKey;
+    private serializeState;
+    private deserializeState;
+    private delay;
+    /**
+     * Get the underlying Redis client for advanced operations.
+     */
+    getRedis(): Redis | null;
+}
+
+export { RedisSagaStore, type RedisSagaStoreOptions };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { Redis, RedisOptions } from 'ioredis';
+import { SagaState, SagaStore } from '@saga-bus/core';
+
+/**
+ * Configuration options for the Redis saga store.
+ */
+interface RedisSagaStoreOptions {
+    /** Existing Redis client */
+    redis?: Redis;
+    /** Connection options for creating new client */
+    connection?: RedisOptions;
+    /** Key prefix for all saga keys (default: "saga-bus:") */
+    keyPrefix?: string;
+    /** TTL in seconds for completed sagas (0 = no expiry, default: 0) */
+    completedTtlSeconds?: number;
+    /** TTL in seconds for all sagas (0 = no expiry, default: 0) */
+    defaultTtlSeconds?: number;
+    /** Maximum retries for optimistic locking conflicts (default: 3) */
+    maxRetries?: number;
+    /** Delay between retries in milliseconds (default: 100) */
+    retryDelayMs?: number;
+}
+
+/**
+ * Redis-backed saga store for saga-bus.
+ *
+ * Uses WATCH/MULTI for optimistic concurrency control.
+ *
+ * @example
+ * ```typescript
+ * import { RedisSagaStore } from "@saga-bus/store-redis";
+ *
+ * const store = new RedisSagaStore<OrderState>({
+ *   connection: { host: "localhost", port: 6379 },
+ *   completedTtlSeconds: 86400, // 1 day
+ * });
+ *
+ * await store.initialize();
+ * ```
+ */
+declare class RedisSagaStore<TState extends SagaState> implements SagaStore<TState> {
+    private redis;
+    private readonly options;
+    private readonly ownsRedis;
+    constructor(options: RedisSagaStoreOptions);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getById(sagaName: string, sagaId: string): Promise<TState | null>;
+    getByCorrelationId(sagaName: string, correlationId: string): Promise<TState | null>;
+    insert(sagaName: string, correlationId: string, state: TState): Promise<void>;
+    update(sagaName: string, state: TState, expectedVersion: number): Promise<void>;
+    delete(sagaName: string, sagaId: string): Promise<void>;
+    private buildKey;
+    private buildIdIndexKey;
+    private serializeState;
+    private deserializeState;
+    private delay;
+    /**
+     * Get the underlying Redis client for advanced operations.
+     */
+    getRedis(): Redis | null;
+}
+
+export { RedisSagaStore, type RedisSagaStoreOptions };

package/dist/index.js

@@ -0,0 +1,185 @@
+// src/RedisSagaStore.ts
+import { Redis } from "ioredis";
+import { ConcurrencyError } from "@saga-bus/core";
+var RedisSagaStore = class {
+  redis = null;
+  options;
+  ownsRedis;
+  constructor(options) {
+    if (!options.redis && !options.connection) {
+      throw new Error("Either redis or connection must be provided");
+    }
+    this.options = {
+      keyPrefix: "saga-bus:",
+      completedTtlSeconds: 0,
+      defaultTtlSeconds: 0,
+      maxRetries: 3,
+      retryDelayMs: 100,
+      ...options
+    };
+    this.ownsRedis = !options.redis;
+  }
+  async initialize() {
+    if (this.options.redis) {
+      this.redis = this.options.redis;
+    } else {
+      this.redis = new Redis(this.options.connection);
+    }
+  }
+  async close() {
+    if (this.ownsRedis && this.redis) {
+      await this.redis.quit();
+    }
+    this.redis = null;
+  }
+  async getById(sagaName, sagaId) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const indexKey = this.buildIdIndexKey(sagaName, sagaId);
+    const correlationId = await this.redis.get(indexKey);
+    if (!correlationId) return null;
+    return this.getByCorrelationId(sagaName, correlationId);
+  }
+  async getByCorrelationId(sagaName, correlationId) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const key = this.buildKey(sagaName, correlationId);
+    const data = await this.redis.get(key);
+    if (!data) return null;
+    return this.deserializeState(data);
+  }
+  async insert(sagaName, correlationId, state) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const key = this.buildKey(sagaName, correlationId);
+    const indexKey = this.buildIdIndexKey(sagaName, state.metadata.sagaId);
+    const existing = await this.redis.get(key);
+    if (existing) {
+      throw new Error(
+        `Saga ${sagaName} with correlation ID ${correlationId} already exists`
+      );
+    }
+    const serialized = this.serializeState(state);
+    let ttl = this.options.defaultTtlSeconds;
+    if (state.metadata.isCompleted && this.options.completedTtlSeconds > 0) {
+      ttl = this.options.completedTtlSeconds;
+    }
+    const multi = this.redis.multi();
+    if (ttl > 0) {
+      multi.setex(key, ttl, serialized);
+      multi.setex(indexKey, ttl, correlationId);
+    } else {
+      multi.set(key, serialized);
+      multi.set(indexKey, correlationId);
+    }
+    await multi.exec();
+  }
+  async update(sagaName, state, expectedVersion) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const indexKey = this.buildIdIndexKey(sagaName, state.metadata.sagaId);
+    const correlationId = await this.redis.get(indexKey);
+    if (!correlationId) {
+      throw new Error(`Saga ${state.metadata.sagaId} not found`);
+    }
+    const key = this.buildKey(sagaName, correlationId);
+    for (let attempt = 0; attempt < this.options.maxRetries; attempt++) {
+      await this.redis.watch(key);
+      try {
+        const existing = await this.redis.get(key);
+        if (!existing) {
+          await this.redis.unwatch();
+          throw new Error(`Saga ${state.metadata.sagaId} not found`);
+        }
+        const currentState = this.deserializeState(existing);
+        if (currentState.metadata.version !== expectedVersion) {
+          await this.redis.unwatch();
+          throw new ConcurrencyError(
+            state.metadata.sagaId,
+            expectedVersion,
+            currentState.metadata.version
+          );
+        }
+        const multi = this.redis.multi();
+        const serialized = this.serializeState(state);
+        let ttl = this.options.defaultTtlSeconds;
+        if (state.metadata.isCompleted && this.options.completedTtlSeconds > 0) {
+          ttl = this.options.completedTtlSeconds;
+        }
+        if (ttl > 0) {
+          multi.setex(key, ttl, serialized);
+          multi.setex(indexKey, ttl, correlationId);
+        } else {
+          multi.set(key, serialized);
+          multi.set(indexKey, correlationId);
+        }
+        const result = await multi.exec();
+        if (result === null) {
+          if (attempt < this.options.maxRetries - 1) {
+            await this.delay(this.options.retryDelayMs);
+            continue;
+          }
+          throw new ConcurrencyError(
+            state.metadata.sagaId,
+            expectedVersion,
+            -1
+            // Unknown current version due to race
+          );
+        }
+        return;
+      } catch (error) {
+        await this.redis.unwatch();
+        throw error;
+      }
+    }
+  }
+  async delete(sagaName, sagaId) {
+    if (!this.redis) throw new Error("Store not initialized");
+    const indexKey = this.buildIdIndexKey(sagaName, sagaId);
+    const correlationId = await this.redis.get(indexKey);
+    if (!correlationId) return;
+    const key = this.buildKey(sagaName, correlationId);
+    await this.redis.del(key, indexKey);
+  }
+  buildKey(sagaName, correlationId) {
+    return `${this.options.keyPrefix}saga:${sagaName}:${correlationId}`;
+  }
+  buildIdIndexKey(sagaName, sagaId) {
+    return `${this.options.keyPrefix}saga:${sagaName}:idx:id:${sagaId}`;
+  }
+  serializeState(state) {
+    return JSON.stringify({
+      ...state,
+      metadata: {
+        ...state.metadata,
+        createdAt: state.metadata.createdAt.toISOString(),
+        updatedAt: state.metadata.updatedAt.toISOString(),
+        archivedAt: state.metadata.archivedAt?.toISOString() ?? null,
+        timeoutExpiresAt: state.metadata.timeoutExpiresAt?.toISOString() ?? null
+      }
+    });
+  }
+  deserializeState(data) {
+    const parsed = JSON.parse(data);
+    return {
+      ...parsed,
+      metadata: {
+        ...parsed.metadata,
+        createdAt: new Date(parsed.metadata.createdAt),
+        updatedAt: new Date(parsed.metadata.updatedAt),
+        archivedAt: parsed.metadata.archivedAt ? new Date(parsed.metadata.archivedAt) : null,
+        timeoutExpiresAt: parsed.metadata.timeoutExpiresAt ? new Date(parsed.metadata.timeoutExpiresAt) : null
+      }
+    };
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  // ============ Query Helpers ============
+  /**
+   * Get the underlying Redis client for advanced operations.
+   */
+  getRedis() {
+    return this.redis;
+  }
+};
+export {
+  RedisSagaStore
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/RedisSagaStore.ts"],"sourcesContent":["import { Redis } from \"ioredis\";\nimport type { SagaStore, SagaState } from \"@saga-bus/core\";\nimport { ConcurrencyError } from \"@saga-bus/core\";\nimport type { RedisSagaStoreOptions } from \"./types.js\";\n\n/**\n * Redis-backed saga store for saga-bus.\n *\n * Uses WATCH/MULTI for optimistic concurrency control.\n *\n * @example\n * ```typescript\n * import { RedisSagaStore } from \"@saga-bus/store-redis\";\n *\n * const store = new RedisSagaStore<OrderState>({\n *   connection: { host: \"localhost\", port: 6379 },\n *   completedTtlSeconds: 86400, // 1 day\n * });\n *\n * await store.initialize();\n * ```\n */\nexport class RedisSagaStore<TState extends SagaState>\n  implements SagaStore<TState>\n{\n  private redis: Redis | null = null;\n  private readonly options: Required<\n    Pick<\n      RedisSagaStoreOptions,\n      | \"keyPrefix\"\n      | \"completedTtlSeconds\"\n      | \"defaultTtlSeconds\"\n      | \"maxRetries\"\n      | \"retryDelayMs\"\n    >\n  > &\n    RedisSagaStoreOptions;\n  private readonly ownsRedis: boolean;\n\n  constructor(options: RedisSagaStoreOptions) {\n    if (!options.redis && !options.connection) {\n      throw new Error(\"Either redis or connection must be provided\");\n    }\n\n    this.options = {\n      keyPrefix: \"saga-bus:\",\n      completedTtlSeconds: 0,\n      defaultTtlSeconds: 0,\n      maxRetries: 3,\n      retryDelayMs: 100,\n      ...options,\n    };\n\n    this.ownsRedis = !options.redis;\n  }\n\n  async initialize(): Promise<void> {\n    if (this.options.redis) {\n      this.redis = this.options.redis;\n    } else {\n      this.redis = new Redis(this.options.connection!);\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.ownsRedis && this.redis) {\n      await this.redis.quit();\n    }\n    this.redis = null;\n  }\n\n  async getById(sagaName: string, sagaId: string): Promise<TState | null> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    // Lookup correlation ID from index\n    const indexKey = this.buildIdIndexKey(sagaName, sagaId);\n    const correlationId = await this.redis.get(indexKey);\n\n    if (!correlationId) return null;\n\n    return this.getByCorrelationId(sagaName, correlationId);\n  }\n\n  async getByCorrelationId(\n    sagaName: string,\n    correlationId: string\n  ): Promise<TState | null> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    const key = this.buildKey(sagaName, correlationId);\n    const data = await this.redis.get(key);\n\n    if (!data) return null;\n\n    return this.deserializeState(data);\n  }\n\n  async insert(\n    sagaName: string,\n    correlationId: string,\n    state: TState\n  ): Promise<void> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    const key = this.buildKey(sagaName, correlationId);\n    const indexKey = this.buildIdIndexKey(sagaName, state.metadata.sagaId);\n\n    // Check if saga already exists\n    const existing = await this.redis.get(key);\n    if (existing) {\n      throw new Error(\n        `Saga ${sagaName} with correlation ID ${correlationId} already exists`\n      );\n    }\n\n    // Serialize and save\n    const serialized = this.serializeState(state);\n\n    // Determine TTL\n    let ttl = this.options.defaultTtlSeconds;\n    if (state.metadata.isCompleted && this.options.completedTtlSeconds > 0) {\n      ttl = this.options.completedTtlSeconds;\n    }\n\n    const multi = this.redis.multi();\n\n    if (ttl > 0) {\n      multi.setex(key, ttl, serialized);\n      multi.setex(indexKey, ttl, correlationId);\n    } else {\n      multi.set(key, serialized);\n      multi.set(indexKey, correlationId);\n    }\n\n    await multi.exec();\n  }\n\n  async update(\n    sagaName: string,\n    state: TState,\n    expectedVersion: number\n  ): Promise<void> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    // We need to find the correlation ID for this saga\n    const indexKey = this.buildIdIndexKey(sagaName, state.metadata.sagaId);\n    const correlationId = await this.redis.get(indexKey);\n\n    if (!correlationId) {\n      throw new Error(`Saga ${state.metadata.sagaId} not found`);\n    }\n\n    const key = this.buildKey(sagaName, correlationId);\n\n    for (let attempt = 0; attempt < this.options.maxRetries; attempt++) {\n      // Watch the key for changes\n      await this.redis.watch(key);\n\n      try {\n        // Check current version\n        const existing = await this.redis.get(key);\n        if (!existing) {\n          await this.redis.unwatch();\n          throw new Error(`Saga ${state.metadata.sagaId} not found`);\n        }\n\n        const currentState = this.deserializeState(existing);\n        if (currentState.metadata.version !== expectedVersion) {\n          await this.redis.unwatch();\n          throw new ConcurrencyError(\n            state.metadata.sagaId,\n            expectedVersion,\n            currentState.metadata.version\n          );\n        }\n\n        // Start transaction\n        const multi = this.redis.multi();\n\n        // Serialize and save\n        const serialized = this.serializeState(state);\n\n        // Determine TTL\n        let ttl = this.options.defaultTtlSeconds;\n        if (state.metadata.isCompleted && this.options.completedTtlSeconds > 0) {\n          ttl = this.options.completedTtlSeconds;\n        }\n\n        if (ttl > 0) {\n          multi.setex(key, ttl, serialized);\n          multi.setex(indexKey, ttl, correlationId);\n        } else {\n          multi.set(key, serialized);\n          multi.set(indexKey, correlationId);\n        }\n\n        // Execute transaction\n        const result = await multi.exec();\n\n        if (result === null) {\n          // Transaction aborted due to WATCH - retry\n          if (attempt < this.options.maxRetries - 1) {\n            await this.delay(this.options.retryDelayMs);\n            continue;\n          }\n          throw new ConcurrencyError(\n            state.metadata.sagaId,\n            expectedVersion,\n            -1 // Unknown current version due to race\n          );\n        }\n\n        return; // Success\n      } catch (error) {\n        await this.redis.unwatch();\n        throw error;\n      }\n    }\n  }\n\n  async delete(sagaName: string, sagaId: string): Promise<void> {\n    if (!this.redis) throw new Error(\"Store not initialized\");\n\n    // Lookup correlation ID from index\n    const indexKey = this.buildIdIndexKey(sagaName, sagaId);\n    const correlationId = await this.redis.get(indexKey);\n\n    if (!correlationId) return;\n\n    const key = this.buildKey(sagaName, correlationId);\n    await this.redis.del(key, indexKey);\n  }\n\n  private buildKey(sagaName: string, correlationId: string): string {\n    return `${this.options.keyPrefix}saga:${sagaName}:${correlationId}`;\n  }\n\n  private buildIdIndexKey(sagaName: string, sagaId: string): string {\n    return `${this.options.keyPrefix}saga:${sagaName}:idx:id:${sagaId}`;\n  }\n\n  private serializeState(state: TState): string {\n    return JSON.stringify({\n      ...state,\n      metadata: {\n        ...state.metadata,\n        createdAt: state.metadata.createdAt.toISOString(),\n        updatedAt: state.metadata.updatedAt.toISOString(),\n        archivedAt: state.metadata.archivedAt?.toISOString() ?? null,\n        timeoutExpiresAt: state.metadata.timeoutExpiresAt?.toISOString() ?? null,\n      },\n    });\n  }\n\n  private deserializeState(data: string): TState {\n    const parsed = JSON.parse(data);\n    return {\n      ...parsed,\n      metadata: {\n        ...parsed.metadata,\n        createdAt: new Date(parsed.metadata.createdAt),\n        updatedAt: new Date(parsed.metadata.updatedAt),\n        archivedAt: parsed.metadata.archivedAt\n          ? new Date(parsed.metadata.archivedAt)\n          : null,\n        timeoutExpiresAt: parsed.metadata.timeoutExpiresAt\n          ? new Date(parsed.metadata.timeoutExpiresAt)\n          : null,\n      },\n    } as TState;\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  // ============ Query Helpers ============\n\n  /**\n   * Get the underlying Redis client for advanced operations.\n   */\n  getRedis(): Redis | null {\n    return this.redis;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@saga-bus/store-redis",
+  "version": "0.1.0",
+  "description": "Redis saga store for saga-bus",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@saga-bus/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "ioredis": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "eslint": "^9.16.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}