ioredis-toolkit 0.0.9 → 0.5.0

package/dist/cache/cache.d.ts

@@ -0,0 +1,30 @@
+import type { RedisClientWrapper } from '../redis/wrapper.js';
+import { type CacheConfig, type CacheResult, type CacheSetOptions } from './types.js';
+/** JSON-based, namespaced Redis cache with TTL and conditional writes. */
+export declare class RedisCache {
+    private readonly redis;
+    private readonly config;
+    /** Creates a cache bound to the shared Redis client. */
+    constructor(redis: RedisClientWrapper, config: CacheConfig);
+    /** Builds the physical Redis key for a logical cache key. */
+    key(key: string): string;
+    /** Reads and JSON-decodes a cached value. */
+    get<T>(key: string): Promise<CacheResult<T>>;
+    /** Reads a cached value and returns null on a miss. */
+    getValue<T>(key: string): Promise<T | null>;
+    /** Stores a JSON-serializable value with optional TTL and NX/XX semantics. */
+    set<T>(key: string, value: T, options?: CacheSetOptions): Promise<boolean>;
+    /** Deletes one or more cache entries. */
+    delete(...keys: string[]): Promise<number>;
+    /** Removes one cache entry. Alias for delete. */
+    del(key: string): Promise<number>;
+    /** Checks whether a cache entry exists. */
+    has(key: string): Promise<boolean>;
+    /** Returns the remaining TTL in seconds. */
+    ttl(key: string): Promise<number>;
+    /** Stores a value only when the key is absent. */
+    setIfAbsent<T>(key: string, value: T, ttl?: number): Promise<boolean>;
+    /** Invalidates all entries matching a namespaced pattern using cluster-aware scanning. */
+    clear(pattern?: string): Promise<number>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAc,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAElG,0EAA0E;AAC1E,qBAAa,UAAU;IAET,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAsB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAD/E,wDAAwD;gBAC3B,KAAK,EAAE,kBAAkB,EAAmB,MAAM,EAAE,WAAW;IAE5F,6DAA6D;IAC7D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAExB,6CAA6C;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAOlD,uDAAuD;IACjD,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAEjD,8EAA8E;IACxE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAapF,yCAAyC;IACnC,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEhD,iDAAiD;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAEvC,2CAA2C;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAExC,4CAA4C;IACtC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAEvC,kDAAkD;IAC5C,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAE3E,0FAA0F;IACpF,KAAK,CAAC,OAAO,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAC5C"}

package/dist/cache/cache.js

@@ -0,0 +1,59 @@
+import { CacheError } from './types.js';
+/** JSON-based, namespaced Redis cache with TTL and conditional writes. */
+export class RedisCache {
+    redis;
+    config;
+    /** Creates a cache bound to the shared Redis client. */
+    constructor(redis, config) {
+        this.redis = redis;
+        this.config = config;
+    }
+    /** Builds the physical Redis key for a logical cache key. */
+    key(key) { return `${this.config.namespace}:${key}`; }
+    /** Reads and JSON-decodes a cached value. */
+    async get(key) {
+        const raw = await this.redis.get(this.key(key));
+        if (raw === null)
+            return { hit: false, value: null };
+        try {
+            return { hit: true, value: JSON.parse(raw) };
+        }
+        catch (error) {
+            throw new CacheError(`Cached value for "${key}" is not valid JSON`, { cause: error });
+        }
+    }
+    /** Reads a cached value and returns null on a miss. */
+    async getValue(key) { return (await this.get(key)).value; }
+    /** Stores a JSON-serializable value with optional TTL and NX/XX semantics. */
+    async set(key, value, options = {}) {
+        if (options.nx && options.xx)
+            throw new RangeError('Cache set options nx and xx are mutually exclusive');
+        if (options.ttl !== undefined && (!Number.isInteger(options.ttl) || options.ttl <= 0))
+            throw new RangeError('Cache TTL must be a positive integer');
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined)
+            throw new TypeError('Cache values must be JSON-serializable');
+        if (Buffer.byteLength(encoded, 'utf8') > this.config.maxValueBytes)
+            throw new RangeError('Cache value exceeds maxValueBytes');
+        const args = ['EX', String(options.ttl ?? this.config.defaultTtl)];
+        if (options.nx)
+            args.push('NX');
+        if (options.xx)
+            args.push('XX');
+        const result = await this.redis.set(this.key(key), encoded, ...args);
+        return result === 'OK';
+    }
+    /** Deletes one or more cache entries. */
+    async delete(...keys) { return this.redis.del(...keys.map(k => this.key(k))); }
+    /** Removes one cache entry. Alias for delete. */
+    async del(key) { return this.delete(key); }
+    /** Checks whether a cache entry exists. */
+    async has(key) { return (await this.redis.exists(this.key(key))) === 1; }
+    /** Returns the remaining TTL in seconds. */
+    async ttl(key) { return this.redis.ttl(this.key(key)); }
+    /** Stores a value only when the key is absent. */
+    async setIfAbsent(key, value, ttl) { return this.set(key, value, ttl === undefined ? { nx: true } : { ttl, nx: true }); }
+    /** Invalidates all entries matching a namespaced pattern using cluster-aware scanning. */
+    async clear(pattern = '*') { return this.redis.deletePatternClusterAware(this.key(pattern)); }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache/cache.js.map

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

package/dist/cache/config.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cache/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AACH,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE5D"}

package/dist/cache/config.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/** Runtime schema for cache configuration. */
+export const CacheConfigSchema = z.object({
+    enabled: z.boolean().default(false),
+    namespace: z.string().min(1).max(128).default('cache'),
+    defaultTtl: z.number().int().positive().default(300),
+    maxValueBytes: z.number().int().positive().max(16 * 1024 * 1024).default(1024 * 1024),
+});
+/** Validates and normalizes cache configuration. */
+export function parseCacheConfig(input) {
+    return CacheConfigSchema.parse(input ?? {});
+}
+//# sourceMappingURL=config.js.map

package/dist/cache/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cache/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACpD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;CACtF,CAAC,CAAC;AACH,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,iBAAiB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAgB,CAAC;AAC7D,CAAC"}

package/dist/cache/types.d.ts

@@ -0,0 +1,32 @@
+/** Thrown when a cached value cannot be decoded, or when the module is used while disabled. */
+export declare class CacheError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Normalized configuration for {@link RedisCache}. */
+export interface CacheConfig {
+    /** Whether the application has enabled the module. The class remains directly constructible when false; {@link RedisClient}'s `cache` getter throws when disabled. */
+    enabled: boolean;
+    /** Prefix used for every physical cache key. */
+    namespace: string;
+    /** TTL in seconds used when a write does not provide an explicit TTL. */
+    defaultTtl: number;
+    /** Maximum UTF-8 encoded JSON payload size accepted by a write. */
+    maxValueBytes: number;
+}
+/** Options controlling a single cache write. */
+export interface CacheSetOptions {
+    /** Explicit TTL in seconds. Must be a positive integer when supplied. */
+    ttl?: number;
+    /** Write only when the key does not already exist. Mutually exclusive with {@link xx}. */
+    nx?: boolean;
+    /** Write only when the key already exists. Mutually exclusive with {@link nx}. */
+    xx?: boolean;
+}
+/** Result of a cache lookup. */
+export interface CacheResult<T> {
+    /** True when Redis contained the requested key. */
+    hit: boolean;
+    /** Decoded value on a hit, otherwise `null`. */
+    value: T | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CACpD;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,sKAAsK;IACtK,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,kFAAkF;IAClF,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED,gCAAgC;AAChC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,mDAAmD;IACnD,GAAG,EAAE,OAAO,CAAC;IACb,gDAAgD;IAChD,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACjB"}

package/dist/cache/types.js

@@ -0,0 +1,5 @@
+/** Thrown when a cached value cannot be decoded, or when the module is used while disabled. */
+export class CacheError extends Error {
+    constructor(message, options) { super(message, options); this.name = 'CacheError'; }
+}
+//# sourceMappingURL=types.js.map

package/dist/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe,EAAE,OAAsB,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC;CAC5G"}

package/dist/index.d.ts

@@ -1,51 +1,43 @@
-export { RedisClientWrapper as RedisClient, createRedisClient } from './client.js';
-export type { RedisClientForMode, ClusterCapabilities } from './client.js';
-export { Cache } from './cache.js';
-export { PubSub } from './pubsub.js';
-export { DistributedLock } from './lock.js';
-export { HealthChecker } from './health.js';
-export { RateLimiter } from './ratelimiter.js';
-export type { RateLimitAlgorithm, RateLimitOptions, RateLimitResult } from './ratelimiter.js';
-export { createSessionManager } from './session/session-manager.js';
-export { SessionManager } from './session/session-manager.js';
-export type { SessionManagerOptions } from './session/session-manager.js';
-export { SessionService } from './session/session-service.js';
-export type { SessionServiceDeps } from './session/session-service.js';
-export { SessionRepository } from './session/session-repository.js';
-export { SessionKeyStrategy, encodeUserId } from './session/session-keys.js';
-export { SessionTokenManager } from './session/session-token.js';
-export { SessionMetrics } from './session/session-metrics.js';
-export type { SessionMetricsAdapter } from './session/session-metrics.js';
-export { SessionCircuitBreaker } from './session/session-circuit-breaker.js';
-export type { CircuitBreakerState } from './session/session-circuit-breaker.js';
-export { SessionHealthChecker } from './session/session-health.js';
-export type { SessionHealthStatus } from './session/session-health.js';
-export { SessionCookieManager, type SerializeCookieOptions, type SerializedCookie, type SerializedCookieAttributes, } from './session/session-cookie.js';
-export { parseSessionConfig, redactSessionConfig, TTL, IDLE_TIMEOUT, TOUCH_INTERVAL, } from './session/session-config.js';
-export type { SessionConfig, SessionConfigInput, PartialSessionConfig, } from './session/session-config.js';
-export { SessionError, SessionNotFoundError, SessionExpiredError, SessionRevokedError, SessionInvalidError, SessionRotationError, SessionReplayError, SessionStorageError, SessionSerializationError, SessionConfigurationError, SessionConcurrencyError, RevocationError, RevocationBatchError, CircuitBreakerOpenError, redactIdentifier, } from './session/session-errors.js';
-export { serializeSession, serializeEncryptedSession, deserializeSession, validateSessionRecord, envelopeKind, encryptedHeaderOf, assertHeaderMatches, } from './session/session-serializer.js';
-export { StaticSessionKeyProvider, createRandomSessionKeyProvider, toKeyBuffer, } from './session/session-encryption.js';
-export type { SessionKeyProvider } from './session/session-encryption.js';
-export type { SessionRecord, SessionCreateInput, SessionUpdatePatch, CreatedSession, RotatedSession, SessionValidationResult, SessionInvalidReason, TouchOutcome, SessionEnvelope, EncryptedSessionEnvelope, PlainSessionEnvelope, ListOptions, RotateOptions, TouchOptions, UpdateOptions, ValidateOptions, BindingMismatch, } from './session/session-types.js';
-export { RedisError } from './errors.js';
-export type { RedisConfig, RedisConfigInput, RedisCommonConfigInput, RedisMode, RedisNode, StandaloneRedisConfig, SentinelRedisConfig, ClusterRedisConfig, RedisConfigForMode, CacheOptions, LockInfo, DistributedLockOptions, HealthStatus, PubSubStats, PubSubMessage, ClusterInfo, ClusterSlotRange, ConnectionStatus, Redis } from './types.js';
-export { RedisConfigSchema } from './types.js';
-export { calculateRedisClusterSlot, hashTag } from './cluster-slot.js';
-export type { RedisConfig as RedisConfiguration } from './types.js';
-import { RedisClientWrapper as RedisClient, createRedisClient } from './client.js';
-import { Cache } from './cache.js';
-import { PubSub } from './pubsub.js';
-import { DistributedLock } from './lock.js';
-import { HealthChecker } from './health.js';
-import { RateLimiter } from './ratelimiter.js';
-declare const _default: {
-    RedisClient: typeof RedisClient;
-    createRedisClient: typeof createRedisClient;
-    Cache: typeof Cache;
-    PubSub: typeof PubSub;
-    DistributedLock: typeof DistributedLock;
-    HealthChecker: typeof HealthChecker;
-    RateLimiter: typeof RateLimiter;
-};
-export default _default;
+export { createRedisConnection } from './redis/client.js';
+export { RedisClientWrapper } from './redis/wrapper.js';
+export { createRedisClient, RedisClient } from './redis/client-facade.js';
+export type { RedisClientConfig, RedisClientDependencies } from './redis/client-facade.js';
+export { redisHashSlot, safeUserTag, assertSameSlot } from './redis/cluster.js';
+export { parseRedisConnectionConfig, RedisConnectionConfigSchema } from './redis/config.js';
+export { RedisConfigurationError } from './redis/errors.js';
+export type { RedisConfig, RedisMode, RedisConnection, RedisCommandClient } from './redis/types.js';
+export { createSessionManager, createSessionManagerFromRedis } from './session/factory.js';
+export type { CreateSessionManagerOptions } from './session/factory.js';
+export { SessionManager } from './session/manager.js';
+export { SessionService } from './session/service.js';
+export { SessionRepository } from './session/repository.js';
+export { SessionTokenManager } from './session/token.js';
+export { SessionSerializer } from './session/serializer.js';
+export { SessionKeyStrategy } from './session/keys.js';
+export { SessionScriptRegistry } from './session/scripts.js';
+export { RedisRevocationStore } from './session/revocation.js';
+export { SessionHealthProvider } from './session/health.js';
+export { NoopMetrics } from './session/metrics.js';
+export { serializeCookie, serializeDeletionCookie } from './session/cookie.js';
+export { parseSessionConfig, SessionConfigSchema } from './session/config.js';
+export type { SessionConfig } from './session/config.js';
+export type { SessionRecord, SessionStatus, CreateSessionInput, CreatedSession, ValidationResult, RotationResult, SessionPatch, SessionMetrics, SessionHealth, KeyManager } from './session/types.js';
+export * from './session/errors.js';
+export { RedisCache } from './cache/cache.js';
+export { parseCacheConfig, CacheConfigSchema } from './cache/config.js';
+export { CacheError } from './cache/types.js';
+export type { CacheConfig, CacheSetOptions, CacheResult } from './cache/types.js';
+export { RedisLock } from './lock/lock.js';
+export { parseLockConfig, LockConfigSchema } from './lock/config.js';
+export type { LockConfig, LockAcquireResult } from './lock/types.js';
+export { RedisRateLimiter } from './rate-limit/rate-limiter.js';
+export { parseRateLimitConfig, RateLimitConfigSchema } from './rate-limit/config.js';
+export type { RateLimitConfig, RateLimitResult } from './rate-limit/types.js';
+export { RedisPubSub } from './pubsub/pubsub.js';
+export { parsePubSubConfig, PubSubConfigSchema } from './pubsub/config.js';
+export type { PubSubConfig, PubSubMessage, Subscription } from './pubsub/types.js';
+export { RedisStreams } from './streams/streams.js';
+export { parseStreamsConfig, StreamsConfigSchema } from './streams/config.js';
+export type { StreamsConfig, StreamEntry, StreamReadOptions } from './streams/types.js';
+export type { ModuleConfigMode } from './modules-config.js';
+//# 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":"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"}

package/dist/index.js

@@ -1,44 +1,32 @@
-// Core exports
-export { RedisClientWrapper as RedisClient, createRedisClient } from './client.js';
-export { Cache } from './cache.js';
-export { PubSub } from './pubsub.js';
-export { DistributedLock } from './lock.js';
-export { HealthChecker } from './health.js';
-export { RateLimiter } from './ratelimiter.js';
-// Session subsystem (new API; the legacy stores remain exported via ./session)
-export { createSessionManager } from './session/session-manager.js';
-export { SessionManager } from './session/session-manager.js';
-export { SessionService } from './session/session-service.js';
-export { SessionRepository } from './session/session-repository.js';
-export { SessionKeyStrategy, encodeUserId } from './session/session-keys.js';
-export { SessionTokenManager } from './session/session-token.js';
-export { SessionMetrics } from './session/session-metrics.js';
-export { SessionCircuitBreaker } from './session/session-circuit-breaker.js';
-export { SessionHealthChecker } from './session/session-health.js';
-export { SessionCookieManager, } from './session/session-cookie.js';
-export { parseSessionConfig, redactSessionConfig, TTL, IDLE_TIMEOUT, TOUCH_INTERVAL, } from './session/session-config.js';
-export { SessionError, SessionNotFoundError, SessionExpiredError, SessionRevokedError, SessionInvalidError, SessionRotationError, SessionReplayError, SessionStorageError, SessionSerializationError, SessionConfigurationError, SessionConcurrencyError, RevocationError, RevocationBatchError, CircuitBreakerOpenError, redactIdentifier, } from './session/session-errors.js';
-export { serializeSession, serializeEncryptedSession, deserializeSession, validateSessionRecord, envelopeKind, encryptedHeaderOf, assertHeaderMatches, } from './session/session-serializer.js';
-export { StaticSessionKeyProvider, createRandomSessionKeyProvider, toKeyBuffer, } from './session/session-encryption.js';
-// Re-export logger types for convenience
-// Error exports
-export { RedisError } from './errors.js';
-// Zod schema
-export { RedisConfigSchema } from './types.js';
-export { calculateRedisClusterSlot, hashTag } from './cluster-slot.js';
-// Default export
-import { RedisClientWrapper as RedisClient, createRedisClient } from './client.js';
-import { Cache } from './cache.js';
-import { PubSub } from './pubsub.js';
-import { DistributedLock } from './lock.js';
-import { HealthChecker } from './health.js';
-import { RateLimiter } from './ratelimiter.js';
-export default {
-    RedisClient,
-    createRedisClient,
-    Cache,
-    PubSub,
-    DistributedLock,
-    HealthChecker,
-    RateLimiter,
-};
+export { createRedisConnection } from './redis/client.js';
+export { RedisClientWrapper } from './redis/wrapper.js';
+export { createRedisClient, RedisClient } from './redis/client-facade.js';
+export { redisHashSlot, safeUserTag, assertSameSlot } from './redis/cluster.js';
+export { parseRedisConnectionConfig, RedisConnectionConfigSchema } from './redis/config.js';
+export { RedisConfigurationError } from './redis/errors.js';
+export { createSessionManager, createSessionManagerFromRedis } from './session/factory.js';
+export { SessionManager } from './session/manager.js';
+export { SessionService } from './session/service.js';
+export { SessionRepository } from './session/repository.js';
+export { SessionTokenManager } from './session/token.js';
+export { SessionSerializer } from './session/serializer.js';
+export { SessionKeyStrategy } from './session/keys.js';
+export { SessionScriptRegistry } from './session/scripts.js';
+export { RedisRevocationStore } from './session/revocation.js';
+export { SessionHealthProvider } from './session/health.js';
+export { NoopMetrics } from './session/metrics.js';
+export { serializeCookie, serializeDeletionCookie } from './session/cookie.js';
+export { parseSessionConfig, SessionConfigSchema } from './session/config.js';
+export * from './session/errors.js';
+export { RedisCache } from './cache/cache.js';
+export { parseCacheConfig, CacheConfigSchema } from './cache/config.js';
+export { CacheError } from './cache/types.js';
+export { RedisLock } from './lock/lock.js';
+export { parseLockConfig, LockConfigSchema } from './lock/config.js';
+export { RedisRateLimiter } from './rate-limit/rate-limiter.js';
+export { parseRateLimitConfig, RateLimitConfigSchema } from './rate-limit/config.js';
+export { RedisPubSub } from './pubsub/pubsub.js';
+export { parsePubSubConfig, PubSubConfigSchema } from './pubsub/config.js';
+export { RedisStreams } from './streams/streams.js';
+export { parseStreamsConfig, StreamsConfigSchema } from './streams/config.js';
+//# 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,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAE3F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,cAAc,qBAAqB,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGrF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lock/config.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lock/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,yDAAyD;AACzD,eAAO,MAAM,gBAAgB;;;;;iBACqI,CAAC;AACnK,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAA8D"}

package/dist/lock/config.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+/** Runtime schema for distributed-lock configuration. */
+export const LockConfigSchema = z.object({ enabled: z.boolean().default(false), namespace: z.string().min(1).max(128).default('lock'), defaultTtl: z.number().int().positive().default(30), maxTtl: z.number().int().positive().default(300) })
+    .superRefine((c, ctx) => { if (c.defaultTtl > c.maxTtl)
+    ctx.addIssue({ code: 'custom', path: ['defaultTtl'], message: 'defaultTtl must not exceed maxTtl' }); });
+/** Validates and normalizes lock configuration. */
+export function parseLockConfig(input) { return LockConfigSchema.parse(input ?? {}); }
+//# sourceMappingURL=config.js.map

package/dist/lock/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lock/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,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,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;KAC5O,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM;IAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnK,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAAC,KAAc,IAAgB,OAAO,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAe,CAAC,CAAC,CAAC"}

package/dist/lock/lock.d.ts

@@ -0,0 +1,20 @@
+import type { RedisClientWrapper } from '../redis/wrapper.js';
+import type { LockAcquireResult, LockConfig } from './types.js';
+/** Redis distributed lock using an ownership token and compare-and-delete semantics. */
+export declare class RedisLock {
+    private readonly redis;
+    private readonly config;
+    /** Creates a lock bound to the shared Redis client. The client must be shared with the other modules. */
+    constructor(redis: RedisClientWrapper, config: LockConfig);
+    /** Builds the physical key for a logical lock name. */
+    key(name: string): string;
+    /** Attempts to acquire a lock and returns a cryptographically random ownership token. */
+    acquire(name: string, ttl?: number): Promise<LockAcquireResult>;
+    /** Releases a lock only when the supplied ownership token still owns it. */
+    release(name: string, token: string): Promise<boolean>;
+    /** Extends a lock only when the supplied ownership token still owns it. */
+    extend(name: string, token: string, ttl?: number): Promise<boolean>;
+    /** Executes a function while holding a lock, releasing it in a finally block. */
+    using<T>(name: string, fn: (token: string) => Promise<T>, ttl?: number): Promise<T>;
+}
+//# sourceMappingURL=lock.d.ts.map

package/dist/lock/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/lock/lock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKhE,wFAAwF;AACxF,qBAAa,SAAS;IAER,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAsB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAD/E,yGAAyG;gBAC5E,KAAK,EAAE,kBAAkB,EAAmB,MAAM,EAAE,UAAU;IAE3F,uDAAuD;IACvD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAEzB,yFAAyF;IACnF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOrF,4EAA4E;IACtE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAE5D,2EAA2E;IACrE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzF,iFAAiF;IAC3E,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,SAAyB,GAAG,OAAO,CAAC,CAAC,CAAC;CAK1G"}

package/dist/lock/lock.js

@@ -0,0 +1,44 @@
+import { randomBytes } from 'node:crypto';
+const RELEASE = `if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end`;
+const EXTEND = `if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('pexpire', KEYS[1], ARGV[2]) else return 0 end`;
+/** Redis distributed lock using an ownership token and compare-and-delete semantics. */
+export class RedisLock {
+    redis;
+    config;
+    /** Creates a lock bound to the shared Redis client. The client must be shared with the other modules. */
+    constructor(redis, config) {
+        this.redis = redis;
+        this.config = config;
+    }
+    /** Builds the physical key for a logical lock name. */
+    key(name) { return `${this.config.namespace}:${name}`; }
+    /** Attempts to acquire a lock and returns a cryptographically random ownership token. */
+    async acquire(name, ttl = this.config.defaultTtl) {
+        if (ttl <= 0 || ttl > this.config.maxTtl)
+            throw new RangeError('Lock TTL is outside the configured bounds');
+        const token = randomBytes(32).toString('base64url');
+        const result = await this.redis.set(this.key(name), token, 'PX', String(ttl * 1000), 'NX');
+        return { acquired: result === 'OK', token };
+    }
+    /** Releases a lock only when the supplied ownership token still owns it. */
+    async release(name, token) { return Number(await this.redis.eval(RELEASE, 1, this.key(name), token)) === 1; }
+    /** Extends a lock only when the supplied ownership token still owns it. */
+    async extend(name, token, ttl = this.config.defaultTtl) {
+        if (ttl <= 0 || ttl > this.config.maxTtl)
+            throw new RangeError('Lock TTL is outside the configured bounds');
+        return Number(await this.redis.eval(EXTEND, 1, this.key(name), token, String(ttl * 1000))) === 1;
+    }
+    /** Executes a function while holding a lock, releasing it in a finally block. */
+    async using(name, fn, ttl = this.config.defaultTtl) {
+        const acquired = await this.acquire(name, ttl);
+        if (!acquired.acquired)
+            throw new Error(`Lock is already held: ${name}`);
+        try {
+            return await fn(acquired.token);
+        }
+        finally {
+            await this.release(name, acquired.token);
+        }
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/lock/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/lock/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,OAAO,GAAG,mGAAmG,CAAC;AACpH,MAAM,MAAM,GAAG,gHAAgH,CAAC;AAEhI,wFAAwF;AACxF,MAAM,OAAO,SAAS;IAES;IAA4C;IADzE,yGAAyG;IACzG,YAA6B,KAAyB,EAAmB,MAAkB;QAA9D,UAAK,GAAL,KAAK,CAAoB;QAAmB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE/F,uDAAuD;IACvD,GAAG,CAAC,IAAY,IAAY,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAExE,yFAAyF;IACzF,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU;QACtD,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,UAAU,CAAC,2CAA2C,CAAC,CAAC;QAC5G,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,KAAa,IAAsB,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE/I,2EAA2E;IAC3E,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,KAAa,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU;QACpE,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,UAAU,CAAC,2CAA2C,CAAC,CAAC;QAC5G,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnG,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,EAAiC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU;QAC1F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;gBAAS,CAAC;YAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;IAChG,CAAC;CACF"}

package/dist/lock/types.d.ts

@@ -0,0 +1,19 @@
+/** Normalized configuration for {@link RedisLock}. */
+export interface LockConfig {
+    /** Whether the application has enabled the module. The class remains directly constructible when false; {@link RedisClient}'s `lock` getter throws when disabled. */
+    enabled: boolean;
+    /** Prefix used for physical lock keys. */
+    namespace: string;
+    /** Default lease duration in seconds. */
+    defaultTtl: number;
+    /** Maximum permitted lease duration in seconds. */
+    maxTtl: number;
+}
+/** Result of a distributed-lock acquisition attempt. */
+export interface LockAcquireResult {
+    /** True when this caller acquired ownership. */
+    acquired: boolean;
+    /** Random ownership secret. Never log or expose it to untrusted callers. */
+    token: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lock/types.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,qKAAqK;IACrK,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/lock/types.js

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

package/dist/lock/types.js.map

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

package/dist/modules-config.d.ts

@@ -0,0 +1,3 @@
+/** Controls whether fluent module configuration merges with or replaces the global module configuration. */
+export type ModuleConfigMode = 'merge' | 'replace';
+//# sourceMappingURL=modules-config.d.ts.map

package/dist/modules-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules-config.d.ts","sourceRoot":"","sources":["../src/modules-config.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC"}

package/dist/modules-config.js

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

package/dist/modules-config.js.map

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

package/dist/pubsub/config.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { PubSubConfig } from './types.js';
+/** Runtime schema for Pub/Sub configuration. */
+export declare const PubSubConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    channelPrefix: z.ZodDefault<z.ZodString>;
+    maxMessageBytes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/** Validates and normalizes Pub/Sub configuration. */
+export declare function parsePubSubConfig(input: unknown): PubSubConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/pubsub/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,gDAAgD;AAChD,eAAO,MAAM,kBAAkB;;;;iBAA0M,CAAC;AAC1O,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAAkE"}

package/dist/pubsub/config.js

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+/** Runtime schema for Pub/Sub configuration. */
+export const PubSubConfigSchema = z.object({ enabled: z.boolean().default(false), channelPrefix: z.string().min(1).max(128).default('events'), maxMessageBytes: z.number().int().positive().max(16 * 1024 * 1024).default(1024 * 1024) });
+/** Validates and normalizes Pub/Sub configuration. */
+export function parsePubSubConfig(input) { return PubSubConfigSchema.parse(input ?? {}); }
+//# sourceMappingURL=config.js.map

package/dist/pubsub/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/pubsub/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gDAAgD;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1O,sDAAsD;AACtD,MAAM,UAAU,iBAAiB,CAAC,KAAc,IAAkB,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAiB,CAAC,CAAC,CAAC"}

package/dist/pubsub/pubsub.d.ts

@@ -0,0 +1,20 @@
+import type { RedisClientWrapper } from '../redis/wrapper.js';
+import type { PubSubConfig, PubSubMessage, Subscription } from './types.js';
+/** JSON Pub/Sub abstraction using a dedicated subscriber connection. */
+export declare class RedisPubSub {
+    private readonly redis;
+    private readonly config;
+    private readonly subscriber;
+    private readonly handlers;
+    /** Creates a Pub/Sub module using the same connection configuration as the shared client. */
+    constructor(redis: RedisClientWrapper, config: PubSubConfig);
+    /** Publishes a JSON value to a namespaced channel and returns subscriber count. */
+    publish<T>(channel: string, value: T): Promise<number>;
+    /** Subscribes to a namespaced channel and parses each JSON message. */
+    subscribe<T>(channel: string, handler: (message: PubSubMessage<T>) => void): Promise<Subscription>;
+    /** Closes the dedicated subscriber connection. */
+    close(): Promise<void>;
+    /** Returns the physical namespaced channel. */
+    fullChannel(channel: string): string;
+}
+//# sourceMappingURL=pubsub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../../src/pubsub/pubsub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5E,wEAAwE;AACxE,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAsB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAH/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqD;IAC9E,6FAA6F;gBAChE,KAAK,EAAE,kBAAkB,EAAmB,MAAM,EAAE,YAAY;IAK7F,mFAAmF;IAC7E,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5D,uEAAuE;IACjE,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAYxG,kDAAkD;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAC5B,+CAA+C;IAC/C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CACrC"}