@pikku/redis 0.11.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+## 0.11.0
+
+### Minor Changes
+
+- Initial release with Redis-backed channel, eventhub, and workflow stores
+
+
+# @pikku-workflows/redis
+
+## 0.10.0
+
+### Major Changes
+
+- Initial release of @pikku-workflows/redis
+- Redis-based WorkflowStateService implementation
+- Distributed locking with Redis SET NX
+- Support for shared or owned Redis connections
+- Configurable key prefixes

package/README.md

@@ -0,0 +1,202 @@
+# @pikku-workflows/redis
+
+Redis-based implementation of WorkflowStateService for Pikku Workflows.
+
+## Features
+
+- **RedisWorkflowService**: Redis implementation of WorkflowStateService for persistent workflow execution state
+- **Fast in-memory storage**: Leverage Redis for high-performance workflow state management
+- **Configurable key prefix**: Use custom key prefixes for namespace isolation (default: 'workflows')
+- **Distributed locking**: Uses Redis SET NX with TTL for concurrent run safety
+- **Type-safe**: Full TypeScript support
+
+## Installation
+
+```bash
+npm install @pikku-workflows/redis ioredis
+# or
+yarn add @pikku-workflows/redis ioredis
+```
+
+## Usage
+
+### Basic Setup (Remote Mode)
+
+```typescript
+import Redis from 'ioredis'
+import { RedisWorkflowService } from '@pikku-workflows/redis'
+import { BullQueueService } from '@pikku/queue-bullmq'
+
+// Create Redis connection
+const redis = new Redis({
+  host: 'localhost',
+  port: 6379,
+})
+
+// Create queue service for remote mode
+const queueService = new BullQueueService('redis://localhost:6379')
+
+// Create workflow state service
+const workflowService = new RedisWorkflowService(
+  redis,
+  queueService,
+  'workflows'
+)
+
+// Initialize (verifies connection)
+await workflowService.init()
+```
+
+### Inline Mode Setup (Testing)
+
+For testing, pass `undefined` as the queue service to enable inline mode:
+
+```typescript
+// Create workflow state service without queue = inline mode
+const workflowService = new RedisWorkflowService(
+  redis,
+  undefined, // No queue service = inline mode
+  'workflows'
+)
+
+await workflowService.init()
+```
+
+### Custom Key Prefix
+
+```typescript
+// Use a custom key prefix
+const workflowService = new RedisWorkflowService(
+  redis,
+  queueService,
+  'myapp_workflows'
+)
+await workflowService.init()
+```
+
+### With Connection String
+
+```typescript
+// Create service with Redis connection string
+const workflowService = new RedisWorkflowService(
+  'redis://localhost:6379',
+  queueService
+)
+await workflowService.init()
+```
+
+### With Existing Connection
+
+```typescript
+// Share connection with other services
+const redis = new Redis('redis://localhost:6379')
+const workflowService = new RedisWorkflowService(redis, queueService)
+// Connection is shared, won't be closed by workflowService.close()
+```
+
+### With Config (Owned Connection)
+
+```typescript
+// Let service create its own connection
+const workflowService = new RedisWorkflowService(
+  { host, port, password },
+  queueService
+)
+await workflowService.init()
+// Later...
+await workflowService.close() // Closes the connection
+```
+
+## Redis Data Structure
+
+The service uses the following Redis data structures:
+
+### Workflow Runs
+
+- **Hash**: `{keyPrefix}:run:{runId}` - Stores workflow run data
+  - `id`: Run ID
+  - `workflow`: Workflow name
+  - `status`: Current status ('running', 'completed', 'failed', 'cancelled')
+  - `input`: JSON string of input data
+  - `output`: JSON string of output data (if completed)
+  - `error`: JSON string of error (if failed)
+  - `createdAt`: Timestamp
+  - `updatedAt`: Timestamp
+
+### Workflow Steps
+
+- **Hash**: `{keyPrefix}:step:{runId}:{stepName}` - Stores step execution data
+  - `stepId`: Unique step ID
+  - `status`: Step status ('pending', 'scheduled', 'succeeded', 'failed')
+  - `rpcName`: RPC function name (if RPC step)
+  - `data`: JSON string of step input data
+  - `result`: JSON string of result (if succeeded)
+  - `error`: JSON string of error (if failed)
+  - `retries`: Number of retry attempts allowed
+  - `retryDelay`: Delay between retries
+  - `attemptCount`: Current attempt number
+  - `createdAt`: Timestamp
+  - `updatedAt`: Timestamp
+
+### Workflow Step History
+
+- **List**: `{keyPrefix}:history:{runId}` - Stores all step attempts in chronological order
+  - Each entry contains complete step state for that attempt
+
+### Locking
+
+- **String**: `{keyPrefix}:lock:{runId}` - Distributed lock with TTL (30 seconds)
+
+## API
+
+### RedisWorkflowService
+
+Extends `WorkflowStateService` from `@pikku/core/workflow`.
+
+#### Constructor
+
+```typescript
+new RedisWorkflowService(
+  connectionOrConfig: Redis | RedisOptions | string,
+  queue?: any,
+  keyPrefix?: string
+)
+```
+
+- `connectionOrConfig`: ioredis Redis instance, RedisOptions config, or connection string
+- `queue`: Optional queue service for remote workflow execution
+- `keyPrefix`: Redis key prefix (default: 'workflows')
+
+#### Methods
+
+- `init()`: Initialize the service (verifies Redis connection)
+- `createRun(workflowName, input)`: Create a new workflow run
+- `getRun(id)`: Get workflow run by ID
+- `getRunHistory(runId)`: Get all step attempts in chronological order
+- `updateRunStatus(id, status, output?, error?)`: Update run status
+- `insertStepState(runId, stepName, rpcName, data, stepOptions?)`: Insert initial step state
+- `getStepState(runId, stepName)`: Get step state with attempt count
+- `setStepScheduled(stepId)`: Mark step as scheduled
+- `setStepRunning(stepId)`: Mark step as running
+- `setStepResult(stepId, result)`: Store step result and mark as succeeded
+- `setStepError(stepId, error)`: Store step error and mark as failed
+- `createRetryAttempt(failedStepId)`: Create a new retry attempt for a failed step
+- `withRunLock(id, fn)`: Execute function with distributed lock
+- `close()`: Close Redis connection (if owned)
+
+## Documentation
+
+For complete workflow documentation, see [pikku.dev/docs/workflows](https://pikku.dev/docs/workflows)
+
+## Locking Behavior
+
+The `withRunLock` method uses Redis SET NX with a 30-second TTL for distributed locking:
+
+- Retries up to 10 times with 100ms delay between attempts
+- Automatically releases lock after function execution
+- Uses Lua script to ensure only the lock owner can release it
+- Lock automatically expires after 30 seconds if not released
+
+## License
+
+MIT

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { RedisChannelStore } from './redis-channel-store.js';
+export { RedisEventHubStore } from './redis-eventhub-store.js';
+export { RedisWorkflowService } from './redis-workflow-service.js';

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export { RedisChannelStore } from './redis-channel-store.js';
+export { RedisEventHubStore } from './redis-eventhub-store.js';
+export { RedisWorkflowService } from './redis-workflow-service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/src/redis-channel-store.d.ts

@@ -0,0 +1,18 @@
+import { CoreUserSession } from '@pikku/core';
+import { Channel, ChannelStore } from '@pikku/core/channel';
+import { Redis, type RedisOptions } from 'ioredis';
+export declare class RedisChannelStore extends ChannelStore {
+    private redis;
+    private keyPrefix;
+    private ownsConnection;
+    constructor(connectionOrConfig: Redis | RedisOptions | string, keyPrefix?: string);
+    init(): Promise<void>;
+    private channelKey;
+    addChannel({ channelId, channelName, openingData, }: Channel): Promise<void>;
+    removeChannels(channelIds: string[]): Promise<void>;
+    setUserSession(channelId: string, session: CoreUserSession | null): Promise<void>;
+    getChannelAndSession(channelId: string): Promise<Channel & {
+        session: CoreUserSession;
+    }>;
+    close(): Promise<void>;
+}

package/dist/src/redis-channel-store.js

@@ -0,0 +1,73 @@
+import { ChannelStore } from '@pikku/core/channel';
+import { Redis } from 'ioredis';
+export class RedisChannelStore extends ChannelStore {
+    redis;
+    keyPrefix;
+    ownsConnection;
+    constructor(connectionOrConfig, keyPrefix = 'pikku') {
+        super();
+        this.keyPrefix = keyPrefix;
+        if (connectionOrConfig instanceof Redis) {
+            this.redis = connectionOrConfig;
+            this.ownsConnection = false;
+        }
+        else if (typeof connectionOrConfig === 'string') {
+            this.redis = new Redis(connectionOrConfig);
+            this.ownsConnection = true;
+        }
+        else {
+            this.redis = new Redis(connectionOrConfig);
+            this.ownsConnection = true;
+        }
+    }
+    async init() {
+        await this.redis.ping();
+    }
+    channelKey(channelId) {
+        return `${this.keyPrefix}:channel:${channelId}`;
+    }
+    async addChannel({ channelId, channelName, openingData, }) {
+        const key = this.channelKey(channelId);
+        await this.redis.hmset(key, 'channelId', channelId, 'channelName', channelName, 'openingData', JSON.stringify(openingData || {}), 'createdAt', Date.now().toString());
+    }
+    async removeChannels(channelIds) {
+        if (channelIds.length === 0) {
+            return;
+        }
+        const pipeline = this.redis.pipeline();
+        for (const channelId of channelIds) {
+            const key = this.channelKey(channelId);
+            pipeline.del(key);
+            pipeline.del(`${this.keyPrefix}:subs:${channelId}`);
+        }
+        await pipeline.exec();
+    }
+    async setUserSession(channelId, session) {
+        const key = this.channelKey(channelId);
+        if (session) {
+            await this.redis.hset(key, 'userSession', JSON.stringify(session));
+        }
+        else {
+            await this.redis.hdel(key, 'userSession');
+        }
+    }
+    async getChannelAndSession(channelId) {
+        const key = this.channelKey(channelId);
+        const data = await this.redis.hgetall(key);
+        if (!data.channelId) {
+            throw new Error(`Channel not found: ${channelId}`);
+        }
+        return {
+            channelId: data.channelId,
+            channelName: data.channelName,
+            openingData: data.openingData ? JSON.parse(data.openingData) : {},
+            session: data.userSession ? JSON.parse(data.userSession) : {},
+        };
+    }
+    async close() {
+        if (this.ownsConnection) {
+            await this.redis.quit();
+        }
+    }
+}
+//# sourceMappingURL=redis-channel-store.js.map

package/dist/src/redis-channel-store.js.map

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

package/dist/src/redis-eventhub-store.d.ts

@@ -0,0 +1,15 @@
+import { EventHubStore } from '@pikku/core/channel';
+import { Redis, type RedisOptions } from 'ioredis';
+export declare class RedisEventHubStore implements EventHubStore {
+    private redis;
+    private keyPrefix;
+    private ownsConnection;
+    constructor(connectionOrConfig: Redis | RedisOptions | string, keyPrefix?: string);
+    init(): Promise<void>;
+    private topicKey;
+    private channelSubsKey;
+    getChannelIdsForTopic(topic: string): Promise<string[]>;
+    subscribe(topic: string, channelId: string): Promise<boolean>;
+    unsubscribe(topic: string, channelId: string): Promise<boolean>;
+    close(): Promise<void>;
+}

package/dist/src/redis-eventhub-store.js

@@ -0,0 +1,58 @@
+import { Redis } from 'ioredis';
+export class RedisEventHubStore {
+    redis;
+    keyPrefix;
+    ownsConnection;
+    constructor(connectionOrConfig, keyPrefix = 'pikku') {
+        this.keyPrefix = keyPrefix;
+        if (connectionOrConfig instanceof Redis) {
+            this.redis = connectionOrConfig;
+            this.ownsConnection = false;
+        }
+        else if (typeof connectionOrConfig === 'string') {
+            this.redis = new Redis(connectionOrConfig);
+            this.ownsConnection = true;
+        }
+        else {
+            this.redis = new Redis(connectionOrConfig);
+            this.ownsConnection = true;
+        }
+    }
+    async init() {
+        await this.redis.ping();
+    }
+    topicKey(topic) {
+        return `${this.keyPrefix}:topic:${topic}`;
+    }
+    channelSubsKey(channelId) {
+        return `${this.keyPrefix}:subs:${channelId}`;
+    }
+    async getChannelIdsForTopic(topic) {
+        const key = this.topicKey(topic);
+        return await this.redis.smembers(key);
+    }
+    async subscribe(topic, channelId) {
+        const topicKey = this.topicKey(topic);
+        const subsKey = this.channelSubsKey(channelId);
+        const pipeline = this.redis.pipeline();
+        pipeline.sadd(topicKey, channelId);
+        pipeline.sadd(subsKey, topic);
+        await pipeline.exec();
+        return true;
+    }
+    async unsubscribe(topic, channelId) {
+        const topicKey = this.topicKey(topic);
+        const subsKey = this.channelSubsKey(channelId);
+        const pipeline = this.redis.pipeline();
+        pipeline.srem(topicKey, channelId);
+        pipeline.srem(subsKey, topic);
+        const results = await pipeline.exec();
+        return results[0][1] > 0;
+    }
+    async close() {
+        if (this.ownsConnection) {
+            await this.redis.quit();
+        }
+    }
+}
+//# sourceMappingURL=redis-eventhub-store.js.map

package/dist/src/redis-eventhub-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-eventhub-store.js","sourceRoot":"","sources":["../../src/redis-eventhub-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAqB,MAAM,SAAS,CAAA;AAclD,MAAM,OAAO,kBAAkB;IACrB,KAAK,CAAO;IACZ,SAAS,CAAQ;IACjB,cAAc,CAAS;IAM/B,YACE,kBAAiD,EACjD,SAAS,GAAG,OAAO;QAEnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAG1B,IAAI,kBAAkB,YAAY,KAAK,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,GAAG,kBAAkB,CAAA;YAC/B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;QAC7B,CAAC;aAAM,IAAI,OAAO,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YAElD,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;YAC1C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC5B,CAAC;aAAM,CAAC;YAEN,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;YAC1C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC5B,CAAC;IACH,CAAC;IAKM,KAAK,CAAC,IAAI;QAEf,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC;IAEO,QAAQ,CAAC,KAAa;QAC5B,OAAO,GAAG,IAAI,CAAC,SAAS,UAAU,KAAK,EAAE,CAAA;IAC3C,CAAC;IAEO,cAAc,CAAC,SAAiB;QACtC,OAAO,GAAG,IAAI,CAAC,SAAS,SAAS,SAAS,EAAE,CAAA;IAC9C,CAAC;IAEM,KAAK,CAAC,qBAAqB,CAAC,KAAa;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAChC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IACvC,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,SAAiB;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;QAG9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAA;QACtC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAClC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAE7B,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAErB,OAAO,IAAI,CAAA;IACb,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,SAAiB;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;QAG9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAA;QACtC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAClC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAE7B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAGrC,OAAQ,OAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAY,GAAG,CAAC,CAAA;IACxC,CAAC;IAKM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/src/redis-workflow-service.d.ts

@@ -0,0 +1,35 @@
+import type { SerializedError } from '@pikku/core';
+import { PikkuWorkflowService, type WorkflowRun, type StepState, type WorkflowStatus } from '@pikku/core/workflow';
+import { Redis, type RedisOptions } from 'ioredis';
+export declare class RedisWorkflowService extends PikkuWorkflowService {
+    private redis;
+    private keyPrefix;
+    private ownsConnection;
+    private lockTTL;
+    constructor(connectionOrConfig: Redis | RedisOptions | string | undefined, keyPrefix?: string);
+    init(): Promise<void>;
+    private runKey;
+    private stepKey;
+    private stepHistoryKey;
+    private lockKey;
+    private saveStepHistory;
+    private updateCurrentHistoryRecord;
+    createRun(workflowName: string, input: any): Promise<string>;
+    getRun(id: string): Promise<WorkflowRun | null>;
+    updateRunStatus(id: string, status: WorkflowStatus, output?: any, error?: SerializedError): Promise<void>;
+    insertStepState(runId: string, stepName: string, rpcName: string, data: any, stepOptions?: {
+        retries?: number;
+        retryDelay?: string | number;
+    }): Promise<StepState>;
+    getStepState(runId: string, stepName: string): Promise<StepState>;
+    getRunHistory(runId: string): Promise<Array<StepState & {
+        stepName: string;
+    }>>;
+    setStepRunning(stepId: string): Promise<void>;
+    setStepScheduled(stepId: string): Promise<void>;
+    setStepResult(stepId: string, result: any): Promise<void>;
+    setStepError(stepId: string, error: Error): Promise<void>;
+    withRunLock<T>(id: string, fn: () => Promise<T>): Promise<T>;
+    createRetryAttempt(stepId: string, status: 'pending' | 'running'): Promise<StepState>;
+    close(): Promise<void>;
+}