ioredis-toolkit 0.0.9 → 0.5.0

package/dist/pubsub/pubsub.js

@@ -0,0 +1,54 @@
+import { Cluster } from 'ioredis';
+/** JSON Pub/Sub abstraction using a dedicated subscriber connection. */
+export class RedisPubSub {
+    redis;
+    config;
+    subscriber;
+    handlers = new Map();
+    /** Creates a Pub/Sub module using the same connection configuration as the shared client. */
+    constructor(redis, config) {
+        this.redis = redis;
+        this.config = config;
+        this.subscriber = redis.duplicateConnection();
+        this.subscriber.on('error', () => { });
+        this.subscriber.on('message', (channel, message) => this.handlers.get(channel)?.forEach(handler => handler(message)));
+    }
+    /** Publishes a JSON value to a namespaced channel and returns subscriber count. */
+    async publish(channel, value) {
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined)
+            throw new TypeError('Pub/Sub values must be JSON-serializable');
+        if (Buffer.byteLength(encoded, 'utf8') > this.config.maxMessageBytes)
+            throw new RangeError('Pub/Sub message exceeds maxMessageBytes');
+        return this.redis.publish(this.fullChannel(channel), encoded);
+    }
+    /** Subscribes to a namespaced channel and parses each JSON message. */
+    async subscribe(channel, handler) {
+        const full = this.fullChannel(channel);
+        const wrapped = (raw) => {
+            let value;
+            try {
+                value = JSON.parse(raw);
+            }
+            catch {
+                return;
+            }
+            handler({ channel, value });
+        };
+        const existing = this.handlers.get(full);
+        const set = existing ?? new Set();
+        set.add(wrapped);
+        this.handlers.set(full, set);
+        if (!existing)
+            await this.subscriber.subscribe(full);
+        return { channel, unsubscribe: async () => { set.delete(wrapped); if (set.size === 0) {
+                this.handlers.delete(full);
+                await this.subscriber.unsubscribe(full);
+            } } };
+    }
+    /** Closes the dedicated subscriber connection. */
+    async close() { await this.subscriber.quit(); this.handlers.clear(); }
+    /** Returns the physical namespaced channel. */
+    fullChannel(channel) { return `${this.config.channelPrefix}:${channel}`; }
+}
+//# sourceMappingURL=pubsub.js.map

package/dist/pubsub/pubsub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../../src/pubsub/pubsub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,SAAS,CAAC;AAI9C,wEAAwE;AACxE,MAAM,OAAO,WAAW;IAIO;IAA4C;IAHxD,UAAU,CAAkB;IAC5B,QAAQ,GAAG,IAAI,GAAG,EAA0C,CAAC;IAC9E,6FAA6F;IAC7F,YAA6B,KAAyB,EAAmB,MAAoB;QAAhE,UAAK,GAAL,KAAK,CAAoB;QAAmB,WAAM,GAAN,MAAM,CAAc;QAC3F,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAA4G,CAAC,CAAC,CAAC;QAChJ,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAe,EAAE,OAAe,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACxI,CAAC;IACD,mFAAmF;IACnF,KAAK,CAAC,OAAO,CAAI,OAAe,EAAE,KAAQ;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAC3F,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe;YAAE,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;QACtI,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IACD,uEAAuE;IACvE,KAAK,CAAC,SAAS,CAAI,OAAe,EAAE,OAA4C;QAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE;YAC9B,IAAI,KAAQ,CAAC;YACb,IAAI,CAAC;gBAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO;YAAC,CAAC;YACvD,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,GAAG,EAA6B,CAAC;QAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7G,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAAC,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrK,CAAC;IACD,kDAAkD;IAClD,KAAK,CAAC,KAAK,KAAoB,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrF,+CAA+C;IAC/C,WAAW,CAAC,OAAe,IAAY,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;CAC3F"}

package/dist/pubsub/types.d.ts

@@ -0,0 +1,24 @@
+/** Normalized configuration for {@link RedisPubSub}. */
+export interface PubSubConfig {
+    /** Whether the application has enabled the module. The class remains directly constructible when false; {@link RedisClient}'s `pubsub` getter throws when disabled. */
+    enabled: boolean;
+    /** Prefix used for physical Redis channel names. */
+    channelPrefix: string;
+    /** Maximum UTF-8 encoded JSON message size. */
+    maxMessageBytes: number;
+}
+/** Handle returned by a Pub/Sub subscription. */
+export interface Subscription {
+    /** Logical, unprefixed channel name. */
+    readonly channel: string;
+    /** Removes this subscription and unsubscribes the physical channel when no handlers remain. */
+    unsubscribe(): Promise<void>;
+}
+/** Decoded Pub/Sub message delivered to a subscriber callback. */
+export interface PubSubMessage<T = unknown> {
+    /** Logical, unprefixed channel name. */
+    channel: string;
+    /** Application payload decoded from JSON. */
+    value: T;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pubsub/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pubsub/types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,uKAAuK;IACvK,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+FAA+F;IAC/F,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,EAAE,CAAC,CAAC;CACV"}

package/dist/pubsub/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pubsub/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pubsub/types.ts"],"names":[],"mappings":""}

package/dist/rate-limit/config.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { RateLimitConfig } from './types.js';
+/** Runtime schema for rate-limiter configuration. */
+export declare const RateLimitConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    namespace: z.ZodDefault<z.ZodString>;
+    windowSeconds: z.ZodDefault<z.ZodNumber>;
+    maxRequests: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/** Validates and normalizes rate-limiter configuration. */
+export declare function parseRateLimitConfig(input: unknown): RateLimitConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/rate-limit/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/rate-limit/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,qDAAqD;AACrD,eAAO,MAAM,qBAAqB;;;;;iBAA2P,CAAC;AAC9R,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAAwE"}

package/dist/rate-limit/config.js

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+/** Runtime schema for rate-limiter configuration. */
+export const RateLimitConfigSchema = z.object({ enabled: z.boolean().default(false), namespace: z.string().min(1).max(128).default('rate-limit'), windowSeconds: z.number().int().positive().max(86400).default(60), maxRequests: z.number().int().positive().max(10_000_000).default(100) });
+/** Validates and normalizes rate-limiter configuration. */
+export function parseRateLimitConfig(input) { return RateLimitConfigSchema.parse(input ?? {}); }
+//# sourceMappingURL=config.js.map

package/dist/rate-limit/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/rate-limit/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qDAAqD;AACrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC9R,2DAA2D;AAC3D,MAAM,UAAU,oBAAoB,CAAC,KAAc,IAAqB,OAAO,qBAAqB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAoB,CAAC,CAAC,CAAC"}

package/dist/rate-limit/rate-limiter.d.ts

@@ -0,0 +1,18 @@
+import type { RedisClientWrapper } from '../redis/wrapper.js';
+import type { RateLimitConfig, RateLimitResult } from './types.js';
+/** Fixed-window Redis rate limiter with atomic increment-and-expire behavior. */
+export declare class RedisRateLimiter {
+    private readonly redis;
+    private readonly config;
+    /** Creates a rate limiter bound to the shared Redis client. */
+    constructor(redis: RedisClientWrapper, config: RateLimitConfig);
+    /** Builds the physical key for a subject and current time window. */
+    key(subject: string, nowSeconds?: number): string;
+    /** Consumes one request from the configured fixed window. */
+    consume(subject: string, cost?: number, nowSeconds?: number): Promise<RateLimitResult>;
+    /** Checks the current window without consuming a request. */
+    check(subject: string, nowSeconds?: number): Promise<RateLimitResult>;
+    /** Resets the current fixed-window counter for a subject. */
+    reset(subject: string, nowSeconds?: number): Promise<boolean>;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/rate-limit/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/rate-limit/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAInE,iFAAiF;AACjF,qBAAa,gBAAgB;IAEf,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAsB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAD/E,+DAA+D;gBAClC,KAAK,EAAE,kBAAkB,EAAmB,MAAM,EAAE,eAAe;IAEhG,qEAAqE;IACrE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAgC,GAAG,MAAM;IAExE,6DAA6D;IACvD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,UAAU,SAAgC,GAAG,OAAO,CAAC,eAAe,CAAC;IAW9G,6DAA6D;IACvD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAgC,GAAG,OAAO,CAAC,eAAe,CAAC;IAKlG,6DAA6D;IACvD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAgC,GAAG,OAAO,CAAC,OAAO,CAAC;CAC3F"}

package/dist/rate-limit/rate-limiter.js

@@ -0,0 +1,37 @@
+const SCRIPT = `local c=redis.call('INCRBY',KEYS[1],ARGV[2]); if c==1 then redis.call('EXPIRE',KEYS[1],ARGV[1]) end; local ttl=redis.call('TTL',KEYS[1]); return {c,ttl}`;
+/** Fixed-window Redis rate limiter with atomic increment-and-expire behavior. */
+export class RedisRateLimiter {
+    redis;
+    config;
+    /** Creates a rate limiter bound to the shared Redis client. */
+    constructor(redis, config) {
+        this.redis = redis;
+        this.config = config;
+    }
+    /** Builds the physical key for a subject and current time window. */
+    key(subject, nowSeconds = Math.floor(Date.now() / 1000)) { return `${this.config.namespace}:${subject}:${Math.floor(nowSeconds / this.config.windowSeconds)}`; }
+    /** Consumes one request from the configured fixed window. */
+    async consume(subject, cost = 1, nowSeconds = Math.floor(Date.now() / 1000)) {
+        if (!Number.isSafeInteger(nowSeconds) || nowSeconds < 0)
+            throw new RangeError('nowSeconds must be a non-negative safe integer');
+        if (!Number.isInteger(cost) || cost <= 0)
+            throw new RangeError('Rate-limit cost must be a positive integer');
+        const key = this.key(subject, nowSeconds);
+        const raw = await this.redis.eval(SCRIPT, 1, key, String(this.config.windowSeconds), String(cost));
+        const [countRaw, ttlRaw] = raw;
+        const count = Number(countRaw);
+        const ttl = Math.max(0, Number(ttlRaw));
+        const resetAt = nowSeconds + ttl;
+        return { allowed: count <= this.config.maxRequests, limit: this.config.maxRequests, remaining: Math.max(0, this.config.maxRequests - count), resetAt, retryAfterSeconds: count > this.config.maxRequests ? ttl : 0, count };
+    }
+    /** Checks the current window without consuming a request. */
+    async check(subject, nowSeconds = Math.floor(Date.now() / 1000)) {
+        const key = this.key(subject, nowSeconds);
+        const count = Number((await this.redis.get(key)) ?? 0);
+        const ttl = Math.max(0, await this.redis.ttl(key));
+        return { allowed: count < this.config.maxRequests, limit: this.config.maxRequests, remaining: Math.max(0, this.config.maxRequests - count), resetAt: nowSeconds + ttl, retryAfterSeconds: count >= this.config.maxRequests ? ttl : 0, count };
+    }
+    /** Resets the current fixed-window counter for a subject. */
+    async reset(subject, nowSeconds = Math.floor(Date.now() / 1000)) { return (await this.redis.del(this.key(subject, nowSeconds))) > 0; }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/rate-limit/rate-limiter.js.map

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

package/dist/rate-limit/types.d.ts

@@ -0,0 +1,27 @@
+/** Normalized configuration for the fixed-window rate limiter. */
+export interface RateLimitConfig {
+    /** Whether the application has enabled the module. The class remains directly constructible when false; {@link RedisClient}'s `rateLimiter` getter throws when disabled. */
+    enabled: boolean;
+    /** Prefix used for counter keys. */
+    namespace: string;
+    /** Length of each fixed window in seconds. */
+    windowSeconds: number;
+    /** Maximum consumed units permitted during one window. */
+    maxRequests: number;
+}
+/** Result returned by a rate-limit check or consumption operation. */
+export interface RateLimitResult {
+    /** Whether the attempted cost is within the configured limit. */
+    allowed: boolean;
+    /** Configured maximum number of units. */
+    limit: number;
+    /** Remaining units after the operation. */
+    remaining: number;
+    /** Approximate Unix timestamp at which the current fixed window expires. */
+    resetAt: number;
+    /** Seconds until the counter resets when the request is denied; otherwise zero. */
+    retryAfterSeconds: number;
+    /** Current counter value after the operation, or current value for `check()`. */
+    count: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rate-limit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rate-limit/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,4KAA4K;IAC5K,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/rate-limit/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rate-limit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rate-limit/types.ts"],"names":[],"mappings":""}

package/dist/redis/client-facade.d.ts

@@ -0,0 +1,77 @@
+import type { RedisConfig } from './types.js';
+import { createRedisConnection } from './client.js';
+import { RedisClientWrapper } from './wrapper.js';
+import { RedisCache } from '../cache/cache.js';
+import type { CacheConfig } from '../cache/types.js';
+import { RedisLock } from '../lock/lock.js';
+import type { LockConfig } from '../lock/types.js';
+import { RedisRateLimiter } from '../rate-limit/rate-limiter.js';
+import type { RateLimitConfig } from '../rate-limit/types.js';
+import { RedisPubSub } from '../pubsub/pubsub.js';
+import type { PubSubConfig } from '../pubsub/types.js';
+import { RedisStreams } from '../streams/streams.js';
+import type { StreamsConfig } from '../streams/types.js';
+import { type SessionConfig } from '../session/config.js';
+import type { KeyManager, SessionMetrics } from '../session/types.js';
+import type { SessionManager } from '../session/manager.js';
+import type { ModuleConfigMode } from '../modules-config.js';
+/** Complete package configuration. Module sections are optional and disabled by default. */
+export type RedisClientConfig = RedisConfig & {
+    cache?: Partial<CacheConfig>;
+    lock?: Partial<LockConfig>;
+    rateLimit?: Partial<RateLimitConfig>;
+    pubsub?: Partial<PubSubConfig>;
+    streams?: Partial<StreamsConfig>;
+    sessions?: Partial<SessionConfig>;
+};
+/** Optional dependencies for the session module: a key manager when encryption is enabled, and/or a metrics sink. */
+export interface RedisClientDependencies {
+    encryptionKeyManager?: KeyManager;
+    metrics?: SessionMetrics;
+}
+/** Shared Redis client facade exposing all package modules through one connection/configuration boundary. */
+export declare class RedisClient extends RedisClientWrapper {
+    private cacheModule?;
+    private lockModule?;
+    private rateLimitModule?;
+    private pubsubModule;
+    private streamsModule?;
+    private sessionModule;
+    private readonly moduleConfig;
+    private readonly dependencies;
+    /** Creates the shared Redis facade and normalizes every module's global configuration. */
+    constructor(connection: ReturnType<typeof createRedisConnection>, config: RedisClientConfig, dependencies?: RedisClientDependencies);
+    /** Returns the configured cache module, creating it lazily. Throws if the module is disabled. */
+    get cache(): RedisCache;
+    /** Returns the configured distributed-lock module, creating it lazily. Throws if the module is disabled. */
+    get lock(): RedisLock;
+    /** Returns the configured rate-limiter module, creating it lazily. Throws if the module is disabled. */
+    get rateLimiter(): RedisRateLimiter;
+    /** Returns the configured Pub/Sub module, creating it lazily. Throws if the module is disabled. */
+    get pubsub(): RedisPubSub;
+    /** Returns the configured Streams module, creating it lazily. Throws if the module is disabled. */
+    get streams(): RedisStreams;
+    /** Returns the configured session manager, creating it lazily. */
+    get sessions(): SessionManager;
+    /** Merges or replaces the global cache configuration and returns this client for fluent chaining. */
+    withCache(options?: Partial<CacheConfig>, mode?: ModuleConfigMode): this;
+    /** Merges or replaces the global lock configuration and returns this client for fluent chaining. */
+    withLock(options?: Partial<LockConfig>, mode?: ModuleConfigMode): this;
+    /** Alias for withLock for codebases that prefer lowercase module naming. */
+    withlock(options?: Partial<LockConfig>, mode?: ModuleConfigMode): this;
+    /** Merges or replaces the global rate-limit configuration and returns this client for fluent chaining. */
+    withRateLimit(options?: Partial<RateLimitConfig>, mode?: ModuleConfigMode): this;
+    /** Merges or replaces the global Pub/Sub configuration and returns this client for fluent chaining. */
+    withPubSub(options?: Partial<PubSubConfig>, mode?: ModuleConfigMode): this;
+    /** Merges or replaces the global Streams configuration and returns this client for fluent chaining. */
+    withStreams(options?: Partial<StreamsConfig>, mode?: ModuleConfigMode): this;
+    /** Merges or replaces the global session configuration and returns this client for fluent chaining. */
+    withSessions(options?: Partial<SessionConfig>, mode?: ModuleConfigMode): this;
+    /** Alias for withSession for singular naming. */
+    withSession(options?: Partial<SessionConfig>, mode?: ModuleConfigMode): this;
+    /** Returns a snapshot of normalized global module configuration. */
+    get config(): Readonly<typeof this.moduleConfig>;
+}
+/** Creates a single shared Redis client with all optional modules configured from one object. */
+export declare function createRedisClient(config: RedisClientConfig, dependencies?: RedisClientDependencies): RedisClient;
+//# sourceMappingURL=client-facade.d.ts.map

package/dist/redis/client-facade.d.ts.map

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

package/dist/redis/client-facade.js

@@ -0,0 +1,102 @@
+import { createRedisConnection } from './client.js';
+import { RedisClientWrapper } from './wrapper.js';
+import { RedisConfigurationError } from './errors.js';
+import { parseCacheConfig } from '../cache/config.js';
+import { RedisCache } from '../cache/cache.js';
+import { parseLockConfig } from '../lock/config.js';
+import { RedisLock } from '../lock/lock.js';
+import { parseRateLimitConfig } from '../rate-limit/config.js';
+import { RedisRateLimiter } from '../rate-limit/rate-limiter.js';
+import { parsePubSubConfig } from '../pubsub/config.js';
+import { RedisPubSub } from '../pubsub/pubsub.js';
+import { parseStreamsConfig } from '../streams/config.js';
+import { RedisStreams } from '../streams/streams.js';
+import { parseSessionConfig } from '../session/config.js';
+import { createSessionManager } from '../session/factory.js';
+/** Shared Redis client facade exposing all package modules through one connection/configuration boundary. */
+export class RedisClient extends RedisClientWrapper {
+    cacheModule;
+    lockModule;
+    rateLimitModule;
+    pubsubModule;
+    streamsModule;
+    sessionModule;
+    moduleConfig;
+    dependencies;
+    /** Creates the shared Redis facade and normalizes every module's global configuration. */
+    constructor(connection, config, dependencies = {}) {
+        super(connection);
+        this.dependencies = dependencies;
+        this.moduleConfig = {
+            cache: parseCacheConfig(config.cache), lock: parseLockConfig(config.lock), rateLimit: parseRateLimitConfig(config.rateLimit), pubsub: parsePubSubConfig(config.pubsub), streams: parseStreamsConfig(config.streams), sessions: parseSessionConfig(config.sessions),
+        };
+    }
+    /** Returns the configured cache module, creating it lazily. Throws if the module is disabled. */
+    get cache() {
+        if (!this.moduleConfig.cache.enabled)
+            throw new RedisConfigurationError('Cache module is disabled');
+        return this.cacheModule ??= new RedisCache(this, this.moduleConfig.cache);
+    }
+    /** Returns the configured distributed-lock module, creating it lazily. Throws if the module is disabled. */
+    get lock() {
+        if (!this.moduleConfig.lock.enabled)
+            throw new RedisConfigurationError('Lock module is disabled');
+        return this.lockModule ??= new RedisLock(this, this.moduleConfig.lock);
+    }
+    /** Returns the configured rate-limiter module, creating it lazily. Throws if the module is disabled. */
+    get rateLimiter() {
+        if (!this.moduleConfig.rateLimit.enabled)
+            throw new RedisConfigurationError('Rate-limit module is disabled');
+        return this.rateLimitModule ??= new RedisRateLimiter(this, this.moduleConfig.rateLimit);
+    }
+    /** Returns the configured Pub/Sub module, creating it lazily. Throws if the module is disabled. */
+    get pubsub() {
+        if (!this.moduleConfig.pubsub.enabled)
+            throw new RedisConfigurationError('Pub/Sub module is disabled');
+        return this.pubsubModule ??= new RedisPubSub(this, this.moduleConfig.pubsub);
+    }
+    /** Returns the configured Streams module, creating it lazily. Throws if the module is disabled. */
+    get streams() {
+        if (!this.moduleConfig.streams.enabled)
+            throw new RedisConfigurationError('Streams module is disabled');
+        return this.streamsModule ??= new RedisStreams(this, this.moduleConfig.streams);
+    }
+    /** Returns the configured session manager, creating it lazily. */
+    get sessions() {
+        if (!this.sessionModule) {
+            const options = { redis: this, config: this.moduleConfig.sessions, ...(this.dependencies.encryptionKeyManager ? { encryptionKeyManager: this.dependencies.encryptionKeyManager } : {}), ...(this.dependencies.metrics ? { metrics: this.dependencies.metrics } : {}) };
+            this.sessionModule = createSessionManager(options);
+        }
+        return this.sessionModule;
+    }
+    /** Merges or replaces the global cache configuration and returns this client for fluent chaining. */
+    withCache(options = {}, mode = 'merge') { this.moduleConfig.cache = parseCacheConfig(mode === 'merge' ? { ...this.moduleConfig.cache, ...options } : options); this.cacheModule = new RedisCache(this, this.moduleConfig.cache); return this; }
+    /** Merges or replaces the global lock configuration and returns this client for fluent chaining. */
+    withLock(options = {}, mode = 'merge') { this.moduleConfig.lock = parseLockConfig(mode === 'merge' ? { ...this.moduleConfig.lock, ...options } : options); this.lockModule = new RedisLock(this, this.moduleConfig.lock); return this; }
+    /** Alias for withLock for codebases that prefer lowercase module naming. */
+    withlock(options = {}, mode = 'merge') { return this.withLock(options, mode); }
+    /** Merges or replaces the global rate-limit configuration and returns this client for fluent chaining. */
+    withRateLimit(options = {}, mode = 'merge') { this.moduleConfig.rateLimit = parseRateLimitConfig(mode === 'merge' ? { ...this.moduleConfig.rateLimit, ...options } : options); this.rateLimitModule = new RedisRateLimiter(this, this.moduleConfig.rateLimit); return this; }
+    /** Merges or replaces the global Pub/Sub configuration and returns this client for fluent chaining. */
+    withPubSub(options = {}, mode = 'merge') { void this.pubsubModule?.close().catch(() => undefined); this.pubsubModule = undefined; this.moduleConfig.pubsub = parsePubSubConfig(mode === 'merge' ? { ...this.moduleConfig.pubsub, ...options } : options); this.pubsubModule = new RedisPubSub(this, this.moduleConfig.pubsub); return this; }
+    /** Merges or replaces the global Streams configuration and returns this client for fluent chaining. */
+    withStreams(options = {}, mode = 'merge') { this.moduleConfig.streams = parseStreamsConfig(mode === 'merge' ? { ...this.moduleConfig.streams, ...options } : options); this.streamsModule = new RedisStreams(this, this.moduleConfig.streams); return this; }
+    /** Merges or replaces the global session configuration and returns this client for fluent chaining. */
+    withSessions(options = {}, mode = 'merge') { this.moduleConfig.sessions = parseSessionConfig(mode === 'merge' ? { ...this.moduleConfig.sessions, ...options } : options); this.sessionModule = undefined; return this; }
+    /** Alias for withSession for singular naming. */
+    withSession(options = {}, mode = 'merge') { return this.withSessions(options, mode); }
+    /** Returns a snapshot of normalized global module configuration. */
+    get config() { return this.moduleConfig; }
+}
+/** Creates a single shared Redis client with all optional modules configured from one object. */
+export function createRedisClient(config, dependencies = {}) {
+    const { cache: _cache, lock: _lock, rateLimit: _rateLimit, pubsub: _pubsub, streams: _streams, sessions: _sessions, ...redisConfig } = config;
+    void _cache;
+    void _lock;
+    void _rateLimit;
+    void _pubsub;
+    void _streams;
+    void _sessions;
+    return new RedisClient(createRedisConnection(redisConfig), config, dependencies);
+}
+//# sourceMappingURL=client-facade.js.map

package/dist/redis/client-facade.js.map

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

package/dist/redis/client.d.ts

@@ -0,0 +1,10 @@
+import type { RedisConfig, RedisConnection } from './types.js';
+/**
+ * Creates a topology-appropriate ioredis connection. Always attaches a no-op
+ * `'error'` listener: ioredis (like every Node `EventEmitter`) throws an uncaught
+ * exception and crashes the process when an `'error'` event fires with zero
+ * listeners. Attaching this default does not prevent callers from adding their
+ * own listener on the returned connection for real observability/alerting.
+ */
+export declare function createRedisConnection(config: RedisConfig): RedisConnection;
+//# sourceMappingURL=client.d.ts.map

package/dist/redis/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/redis/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkB/D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAI1E"}

package/dist/redis/client.js

@@ -0,0 +1,29 @@
+import Redis, { Cluster } from 'ioredis';
+function buildConnection(config) {
+    if (config.mode === "cluster") {
+        const { mode: _mode, nodes, ...options } = config;
+        void _mode;
+        return new Cluster(nodes, options);
+    }
+    if (config.mode === "sentinel") {
+        const { mode: _mode, sentinels, name, ...options } = config;
+        void _mode;
+        return new Redis.Redis({ ...options, sentinels, name });
+    }
+    const { mode: _mode, ...options } = config;
+    void _mode;
+    return new Redis.Redis(options);
+}
+/**
+ * Creates a topology-appropriate ioredis connection. Always attaches a no-op
+ * `'error'` listener: ioredis (like every Node `EventEmitter`) throws an uncaught
+ * exception and crashes the process when an `'error'` event fires with zero
+ * listeners. Attaching this default does not prevent callers from adding their
+ * own listener on the returned connection for real observability/alerting.
+ */
+export function createRedisConnection(config) {
+    const connection = buildConnection(config);
+    connection.on('error', () => { });
+    return connection;
+}
+//# sourceMappingURL=client.js.map

package/dist/redis/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/redis/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzC,SAAS,eAAe,CAAC,MAAmB;IAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;QAClD,KAAK,KAAK,CAAC;QACX,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;QAC5D,KAAK,KAAK,CAAC;QACX,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3C,KAAK,KAAK,CAAC;IACX,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAmB;IACvD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAA2F,CAAC,CAAC,CAAC;IAC1H,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/redis/cluster.d.ts

@@ -0,0 +1,7 @@
+/** Calculates the Redis Cluster hash slot (0-16383), honoring the first valid hash tag. */
+export declare function redisHashSlot(key: string): number;
+/** Derives a fixed-length SHA-256 user tag safe for Redis Cluster hash-tagging. */
+export declare function safeUserTag(userId: string): string;
+/** Throws when two or more keys do not resolve to the same Redis Cluster slot. */
+export declare function assertSameSlot(keys: readonly string[]): void;
+//# sourceMappingURL=cluster.d.ts.map

package/dist/redis/cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../../src/redis/cluster.ts"],"names":[],"mappings":"AAyBA,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAM5D"}

package/dist/redis/cluster.js

@@ -0,0 +1,47 @@
+import { createHash } from 'node:crypto';
+const SLOT_COUNT = 16_384;
+const CRC16_TABLE = (() => {
+    const table = new Uint16Array(256);
+    for (let i = 0; i < 256; i += 1) {
+        let crc = i << 8;
+        for (let j = 0; j < 8; j += 1) {
+            crc = (crc & 0x8000) !== 0 ? ((crc << 1) ^ 0x1021) & 0xffff : (crc << 1) & 0xffff;
+        }
+        table[i] = crc;
+    }
+    return table;
+})();
+function hashInput(key) {
+    const first = key.indexOf('{');
+    if (first !== -1) {
+        const second = key.indexOf('}', first + 1);
+        if (second !== -1 && second > first + 1)
+            return Buffer.from(key.slice(first + 1, second));
+    }
+    return Buffer.from(key);
+}
+/** Calculates the Redis Cluster hash slot (0-16383), honoring the first valid hash tag. */
+export function redisHashSlot(key) {
+    const input = hashInput(key);
+    let crc = 0;
+    for (const byte of input) {
+        const index = ((crc >>> 8) ^ byte) & 0xff;
+        crc = ((crc << 8) ^ CRC16_TABLE[index]) & 0xffff;
+    }
+    return crc % SLOT_COUNT;
+}
+/** Derives a fixed-length SHA-256 user tag safe for Redis Cluster hash-tagging. */
+export function safeUserTag(userId) {
+    return createHash('sha256').update(userId, 'utf8').digest('hex');
+}
+/** Throws when two or more keys do not resolve to the same Redis Cluster slot. */
+export function assertSameSlot(keys) {
+    if (keys.length < 2)
+        return;
+    const slot = redisHashSlot(keys[0]);
+    for (const key of keys.slice(1)) {
+        if (redisHashSlot(key) !== slot)
+            throw new Error('Redis keys do not share a hash slot');
+    }
+}
+//# sourceMappingURL=cluster.js.map

package/dist/redis/cluster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../../src/redis/cluster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE;IACxB,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,GAAG,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;QACpF,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,EAAE,CAAC;AAEL,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,KAAK,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAAC,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAE,CAAC,GAAG,MAAM,CAAC;IAAC,CAAC;IAC3H,OAAO,GAAG,GAAG,UAAU,CAAC;AAC1B,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,IAAuB;IACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAC5B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC"}

package/dist/redis/config.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import type { RedisConfig } from './types.js';
+/** Runtime schema for the standalone Redis connection subset accepted by this package. */
+export declare const RedisConnectionConfigSchema: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"standalone">;
+    host: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    password: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodNumber>;
+    tls: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$loose>, z.ZodObject<{
+    mode: z.ZodLiteral<"sentinel">;
+    sentinels: z.ZodArray<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, z.core.$strip>>;
+    name: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodNumber>;
+    tls: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$loose>, z.ZodObject<{
+    mode: z.ZodLiteral<"cluster">;
+    nodes: z.ZodArray<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, z.core.$strip>>;
+    redisOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>], "mode">, unknown>;
+/**
+ * Validates the public Redis connection configuration and returns it in the
+ * package's topology-independent shape. Unsupported extra ioredis options are
+ * preserved so advanced users can still configure retries, TLS, timeouts, and
+ * other supported client features. `mode` may be omitted for standalone Redis,
+ * matching {@link StandaloneRedisConfig}'s optional `mode` field.
+ */
+export declare function parseRedisConnectionConfig(input: unknown): RedisConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/redis/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/redis/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C,0FAA0F;AAC1F,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;qCAgCvC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAMtE"}