@cogitator-ai/redis 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cogitator Contributors
+
+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,77 @@
+# @cogitator-ai/redis
+
+Unified Redis client for Cogitator with standalone and cluster support.
+
+## Installation
+
+```bash
+pnpm add @cogitator-ai/redis ioredis
+```
+
+## Usage
+
+### Standalone Mode
+
+```typescript
+import { createRedisClient } from '@cogitator-ai/redis';
+
+const redis = await createRedisClient({
+  url: 'redis://localhost:6379',
+});
+
+await redis.set('key', 'value');
+const value = await redis.get('key');
+```
+
+### Cluster Mode
+
+```typescript
+import { createRedisClient } from '@cogitator-ai/redis';
+
+const redis = await createRedisClient({
+  cluster: {
+    nodes: [
+      { host: 'node1', port: 6379 },
+      { host: 'node2', port: 6379 },
+      { host: 'node3', port: 6379 },
+    ],
+  },
+});
+```
+
+### Environment Configuration
+
+```typescript
+import { createConfigFromEnv } from '@cogitator-ai/redis';
+
+// Reads from REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD
+// REDIS_CLUSTER_NODES for cluster mode
+const config = createConfigFromEnv();
+const redis = await createRedisClient(config);
+```
+
+### Auto-Detection
+
+```typescript
+import { detectRedisMode } from '@cogitator-ai/redis';
+
+// Automatically detects standalone vs cluster
+const mode = await detectRedisMode(config);
+```
+
+## Environment Variables
+
+- `REDIS_URL` - Redis connection URL
+- `REDIS_HOST` - Redis host (alternative to URL)
+- `REDIS_PORT` - Redis port (default: 6379)
+- `REDIS_PASSWORD` - Redis password
+- `REDIS_CLUSTER_NODES` - JSON array of cluster nodes
+- `REDIS_KEY_PREFIX` - Key prefix (auto-uses `{cogitator}:` for cluster)
+
+## Documentation
+
+See the [Cogitator documentation](https://github.com/eL1fe/cogitator) for full API reference.
+
+## License
+
+MIT

package/dist/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/index.test.js

@@ -0,0 +1,14 @@
+import { describe, it, expect } from 'vitest';
+describe('@cogitator-ai/redis', () => {
+    it('exports createRedisClient', async () => {
+        const { createRedisClient } = await import('../index');
+        expect(createRedisClient).toBeDefined();
+        expect(typeof createRedisClient).toBe('function');
+    });
+    it('exports createConfigFromEnv', async () => {
+        const { createConfigFromEnv } = await import('../index');
+        expect(createConfigFromEnv).toBeDefined();
+        expect(typeof createConfigFromEnv).toBe('function');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/factory.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Redis client factory
+ *
+ * Creates unified Redis clients that work in both standalone and cluster modes.
+ */
+import type { RedisConfig, RedisClient, RedisStandaloneConfig } from './types';
+/**
+ * Create a Redis client from configuration
+ *
+ * @example Standalone mode
+ * ```ts
+ * const client = await createRedisClient({
+ *   url: 'redis://localhost:6379',
+ *   keyPrefix: 'myapp:',
+ * });
+ * ```
+ *
+ * @example Cluster mode
+ * ```ts
+ * const client = await createRedisClient({
+ *   mode: 'cluster',
+ *   nodes: [
+ *     { host: '10.0.0.1', port: 6379 },
+ *     { host: '10.0.0.2', port: 6379 },
+ *     { host: '10.0.0.3', port: 6379 },
+ *   ],
+ *   keyPrefix: '{myapp}:', // Hash tag for cluster key routing
+ * });
+ * ```
+ */
+export declare function createRedisClient(config: RedisConfig): Promise<RedisClient>;
+/**
+ * Detect if a Redis server is running in cluster mode
+ *
+ * Useful for auto-detection when mode is not explicitly specified.
+ */
+export declare function detectRedisMode(config: Omit<RedisStandaloneConfig, 'mode'>): Promise<'standalone' | 'cluster'>;
+/**
+ * Parse REDIS_CLUSTER_NODES environment variable
+ *
+ * @example
+ * ```
+ * REDIS_CLUSTER_NODES='[{"host":"10.0.0.1","port":6379},{"host":"10.0.0.2","port":6379}]'
+ * ```
+ */
+export declare function parseClusterNodesEnv(env?: string): {
+    host: string;
+    port: number;
+}[] | null;
+/**
+ * Create Redis configuration from environment variables
+ *
+ * Supports:
+ * - REDIS_URL - standalone Redis URL
+ * - REDIS_HOST + REDIS_PORT - standalone Redis host/port
+ * - REDIS_CLUSTER_NODES - JSON array of cluster nodes
+ * - REDIS_PASSWORD - authentication password
+ * - REDIS_KEY_PREFIX - key prefix (default: 'cogitator:' or '{cogitator}:' for cluster)
+ */
+export declare function createConfigFromEnv(env?: NodeJS.ProcessEnv): RedisConfig;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAsB,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA2BnG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAejF;AAmGD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAC1C,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CASnC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,IAAI,CAiB1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,WAAW,CAoBrF"}

package/dist/factory.js

@@ -0,0 +1,183 @@
+/**
+ * Redis client factory
+ *
+ * Creates unified Redis clients that work in both standalone and cluster modes.
+ */
+import { isClusterConfig } from './types';
+/**
+ * Create a Redis client from configuration
+ *
+ * @example Standalone mode
+ * ```ts
+ * const client = await createRedisClient({
+ *   url: 'redis://localhost:6379',
+ *   keyPrefix: 'myapp:',
+ * });
+ * ```
+ *
+ * @example Cluster mode
+ * ```ts
+ * const client = await createRedisClient({
+ *   mode: 'cluster',
+ *   nodes: [
+ *     { host: '10.0.0.1', port: 6379 },
+ *     { host: '10.0.0.2', port: 6379 },
+ *     { host: '10.0.0.3', port: 6379 },
+ *   ],
+ *   keyPrefix: '{myapp}:', // Hash tag for cluster key routing
+ * });
+ * ```
+ */
+export async function createRedisClient(config) {
+    const ioredisModule = await import('ioredis');
+    const ioredis = (ioredisModule.default ?? ioredisModule);
+    if (isClusterConfig(config)) {
+        return createClusterClient(ioredis, config);
+    }
+    return createStandaloneClient(ioredis, config);
+}
+/**
+ * Create a standalone Redis client
+ */
+function createStandaloneClient(ioredis, config) {
+    const url = config.url ?? buildUrl(config.host, config.port);
+    const client = new ioredis(url, {
+        password: config.password,
+        db: config.db,
+        tls: config.tls ? {} : undefined,
+        keyPrefix: config.keyPrefix,
+        maxRetriesPerRequest: config.maxRetriesPerRequest ?? 3,
+        lazyConnect: config.lazyConnect ?? false,
+        retryStrategy: (times) => Math.min(times * 50, 2000),
+    });
+    return wrapClient(client);
+}
+/**
+ * Create a Redis Cluster client
+ */
+function createClusterClient(ioredis, config) {
+    const cluster = new ioredis.Cluster(config.nodes, {
+        scaleReads: config.scaleReads ?? 'master',
+        redisOptions: {
+            password: config.password,
+            tls: config.tls ? {} : undefined,
+            maxRetriesPerRequest: config.maxRetriesPerRequest ?? 3,
+            lazyConnect: config.lazyConnect ?? false,
+        },
+        clusterRetryStrategy: (times) => Math.min(100 + times * 2, 2000),
+        natMap: config.natMap,
+        keyPrefix: config.keyPrefix,
+    });
+    return wrapClient(cluster);
+}
+/**
+ * Build Redis URL from host and port
+ */
+function buildUrl(host, port) {
+    return `redis://${host ?? 'localhost'}:${port ?? 6379}`;
+}
+/**
+ * Wrap raw Redis client as unified RedisClient interface
+ */
+function wrapClient(client) {
+    return {
+        ping: () => client.ping(),
+        quit: () => client.quit(),
+        get: (key) => client.get(key),
+        set: (key, value) => client.set(key, value),
+        setex: (key, seconds, value) => client.setex(key, seconds, value),
+        del: (...keys) => client.del(...keys),
+        expire: (key, seconds) => client.expire(key, seconds),
+        mget: (...keys) => client.mget(...keys),
+        zadd: (key, score, member) => client.zadd(key, score, member),
+        zrange: (key, start, stop) => client.zrange(key, start, stop),
+        zrangebyscore: (key, min, max) => client.zrangebyscore(key, min, max),
+        zrem: (key, ...members) => client.zrem(key, ...members),
+        smembers: (key) => client.smembers(key),
+        publish: (channel, message) => client.publish(channel, message),
+        subscribe: async (channel) => {
+            await client.subscribe(channel);
+        },
+        unsubscribe: async (channel) => {
+            await client.unsubscribe(channel);
+        },
+        on: (event, callback) => {
+            client.on(event, callback);
+        },
+        off: (event, callback) => {
+            client.off(event, callback);
+        },
+        keys: (pattern) => client.keys(pattern),
+        duplicate: () => wrapClient(client.duplicate()),
+        info: (section) => (section ? client.info(section) : client.info()),
+    };
+}
+/**
+ * Detect if a Redis server is running in cluster mode
+ *
+ * Useful for auto-detection when mode is not explicitly specified.
+ */
+export async function detectRedisMode(config) {
+    const client = await createRedisClient({ ...config, mode: 'standalone' });
+    try {
+        const info = await client.info('cluster');
+        return info.includes('cluster_enabled:1') ? 'cluster' : 'standalone';
+    }
+    finally {
+        await client.quit();
+    }
+}
+/**
+ * Parse REDIS_CLUSTER_NODES environment variable
+ *
+ * @example
+ * ```
+ * REDIS_CLUSTER_NODES='[{"host":"10.0.0.1","port":6379},{"host":"10.0.0.2","port":6379}]'
+ * ```
+ */
+export function parseClusterNodesEnv(env) {
+    if (!env)
+        return null;
+    try {
+        const nodes = JSON.parse(env);
+        if (!Array.isArray(nodes))
+            return null;
+        return nodes.filter((node) => typeof node === 'object' &&
+            node !== null &&
+            typeof node.host === 'string' &&
+            typeof node.port === 'number');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Create Redis configuration from environment variables
+ *
+ * Supports:
+ * - REDIS_URL - standalone Redis URL
+ * - REDIS_HOST + REDIS_PORT - standalone Redis host/port
+ * - REDIS_CLUSTER_NODES - JSON array of cluster nodes
+ * - REDIS_PASSWORD - authentication password
+ * - REDIS_KEY_PREFIX - key prefix (default: 'cogitator:' or '{cogitator}:' for cluster)
+ */
+export function createConfigFromEnv(env = process.env) {
+    const clusterNodes = parseClusterNodesEnv(env.REDIS_CLUSTER_NODES);
+    if (clusterNodes && clusterNodes.length > 0) {
+        return {
+            mode: 'cluster',
+            nodes: clusterNodes,
+            password: env.REDIS_PASSWORD,
+            keyPrefix: env.REDIS_KEY_PREFIX ?? '{cogitator}:',
+        };
+    }
+    return {
+        mode: 'standalone',
+        url: env.REDIS_URL,
+        host: env.REDIS_HOST ?? 'localhost',
+        port: parseInt(env.REDIS_PORT ?? '6379', 10),
+        password: env.REDIS_PASSWORD,
+        keyPrefix: env.REDIS_KEY_PREFIX ?? 'cogitator:',
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @cogitator-ai/redis - Unified Redis client with cluster support
+ *
+ * @example Standalone mode
+ * ```ts
+ * import { createRedisClient } from '@cogitator-ai/redis';
+ *
+ * const client = await createRedisClient({
+ *   url: 'redis://localhost:6379',
+ *   keyPrefix: 'myapp:',
+ * });
+ *
+ * await client.set('key', 'value');
+ * const value = await client.get('key');
+ * ```
+ *
+ * @example Cluster mode
+ * ```ts
+ * import { createRedisClient } from '@cogitator-ai/redis';
+ *
+ * const client = await createRedisClient({
+ *   mode: 'cluster',
+ *   nodes: [
+ *     { host: '10.0.0.1', port: 6379 },
+ *     { host: '10.0.0.2', port: 6379 },
+ *     { host: '10.0.0.3', port: 6379 },
+ *   ],
+ *   keyPrefix: '{myapp}:', // Hash tag for cluster
+ * });
+ * ```
+ *
+ * @example From environment
+ * ```ts
+ * import { createRedisClient, createConfigFromEnv } from '@cogitator-ai/redis';
+ *
+ * // Uses REDIS_URL, REDIS_CLUSTER_NODES, REDIS_PASSWORD, etc.
+ * const config = createConfigFromEnv();
+ * const client = await createRedisClient(config);
+ * ```
+ */
+export { createRedisClient, detectRedisMode, parseClusterNodesEnv, createConfigFromEnv, } from './factory';
+export { isClusterConfig, type RedisMode, type RedisNodeConfig, type RedisCommonOptions, type RedisStandaloneConfig, type RedisClusterConfig, type RedisConfig, type RedisClient, type QueueMetrics, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * @cogitator-ai/redis - Unified Redis client with cluster support
+ *
+ * @example Standalone mode
+ * ```ts
+ * import { createRedisClient } from '@cogitator-ai/redis';
+ *
+ * const client = await createRedisClient({
+ *   url: 'redis://localhost:6379',
+ *   keyPrefix: 'myapp:',
+ * });
+ *
+ * await client.set('key', 'value');
+ * const value = await client.get('key');
+ * ```
+ *
+ * @example Cluster mode
+ * ```ts
+ * import { createRedisClient } from '@cogitator-ai/redis';
+ *
+ * const client = await createRedisClient({
+ *   mode: 'cluster',
+ *   nodes: [
+ *     { host: '10.0.0.1', port: 6379 },
+ *     { host: '10.0.0.2', port: 6379 },
+ *     { host: '10.0.0.3', port: 6379 },
+ *   ],
+ *   keyPrefix: '{myapp}:', // Hash tag for cluster
+ * });
+ * ```
+ *
+ * @example From environment
+ * ```ts
+ * import { createRedisClient, createConfigFromEnv } from '@cogitator-ai/redis';
+ *
+ * // Uses REDIS_URL, REDIS_CLUSTER_NODES, REDIS_PASSWORD, etc.
+ * const config = createConfigFromEnv();
+ * const client = await createRedisClient(config);
+ * ```
+ */
+export { createRedisClient, detectRedisMode, parseClusterNodesEnv, createConfigFromEnv, } from './factory';
+export { isClusterConfig, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,eAAe,GAShB,MAAM,SAAS,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Redis configuration and client types
+ *
+ * Supports both standalone Redis and Redis Cluster modes.
+ */
+export type RedisMode = 'standalone' | 'cluster';
+/**
+ * Redis node configuration for cluster mode
+ */
+export interface RedisNodeConfig {
+    host: string;
+    port: number;
+}
+/**
+ * Common Redis options shared between standalone and cluster modes
+ */
+export interface RedisCommonOptions {
+    /** Key prefix for all operations (use {hashtag} format for cluster) */
+    keyPrefix?: string;
+    /** Password for authentication */
+    password?: string;
+    /** Enable TLS */
+    tls?: boolean;
+    /** Max retries per request */
+    maxRetriesPerRequest?: number;
+    /** Lazy connect - don't connect immediately */
+    lazyConnect?: boolean;
+}
+/**
+ * Standalone Redis configuration
+ */
+export interface RedisStandaloneConfig extends RedisCommonOptions {
+    mode?: 'standalone';
+    /** Redis URL (e.g., redis://localhost:6379) */
+    url?: string;
+    /** Host (alternative to url) */
+    host?: string;
+    /** Port (alternative to url) */
+    port?: number;
+    /** Database number */
+    db?: number;
+}
+/**
+ * Redis Cluster configuration
+ */
+export interface RedisClusterConfig extends RedisCommonOptions {
+    mode: 'cluster';
+    /** Array of cluster nodes */
+    nodes: RedisNodeConfig[];
+    /** Scale reads to replicas: 'master' | 'slave' | 'all' */
+    scaleReads?: 'master' | 'slave' | 'all';
+    /** NAT mapping for cluster nodes behind NAT */
+    natMap?: Record<string, RedisNodeConfig>;
+}
+/**
+ * Combined Redis configuration type
+ */
+export type RedisConfig = RedisStandaloneConfig | RedisClusterConfig;
+/**
+ * Unified Redis client interface
+ *
+ * Provides a common interface for both standalone Redis and Redis Cluster.
+ * All methods work identically regardless of the underlying implementation.
+ */
+export interface RedisClient {
+    ping(): Promise<string>;
+    quit(): Promise<string>;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<string>;
+    setex(key: string, seconds: number, value: string): Promise<string>;
+    del(...keys: string[]): Promise<number>;
+    expire(key: string, seconds: number): Promise<number>;
+    mget(...keys: string[]): Promise<(string | null)[]>;
+    zadd(key: string, score: number, member: string): Promise<number>;
+    zrange(key: string, start: number, stop: number): Promise<string[]>;
+    zrangebyscore(key: string, min: number | string, max: number | string): Promise<string[]>;
+    zrem(key: string, ...members: string[]): Promise<number>;
+    smembers(key: string): Promise<string[]>;
+    publish(channel: string, message: string): Promise<number>;
+    subscribe(channel: string, callback?: (message: string) => void): Promise<void>;
+    unsubscribe(channel: string): Promise<void>;
+    on(event: string, callback: (...args: any[]) => void): void;
+    off(event: string, callback: (...args: any[]) => void): void;
+    keys(pattern: string): Promise<string[]>;
+    duplicate(): RedisClient;
+    info(section?: string): Promise<string>;
+}
+/**
+ * Queue metrics for monitoring
+ */
+export interface QueueMetrics {
+    /** Jobs waiting to be processed */
+    waiting: number;
+    /** Jobs currently being processed */
+    active: number;
+    /** Jobs completed successfully */
+    completed: number;
+    /** Jobs that failed */
+    failed: number;
+    /** Jobs scheduled for later */
+    delayed: number;
+    /** Total queue depth (waiting + delayed) */
+    depth: number;
+}
+/**
+ * Check if config is for cluster mode
+ */
+export declare function isClusterConfig(config: RedisConfig): config is RedisClusterConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,8BAA8B;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,IAAI,EAAE,SAAS,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IACxC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAEpD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,aAAa,CACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,GAAG,EAAE,MAAM,GAAG,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAE7D,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzC,SAAS,IAAI,WAAW,CAAC;IAEzB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,kBAAkB,CAEjF"}

package/dist/types.js

@@ -0,0 +1,12 @@
+/**
+ * Redis configuration and client types
+ *
+ * Supports both standalone Redis and Redis Cluster modes.
+ */
+/**
+ * Check if config is for cluster mode
+ */
+export function isClusterConfig(config) {
+    return config.mode === 'cluster' || ('nodes' in config && Array.isArray(config.nodes));
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyHH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACzF,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@cogitator-ai/redis",
+  "version": "0.1.0",
+  "description": "Unified Redis client for Cogitator with standalone and cluster support",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@cogitator-ai/types": "0.1.0"
+  },
+  "optionalDependencies": {
+    "ioredis": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eL1fe/cogitator.git",
+    "directory": "packages/redis"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}