ioredis-toolkit 0.0.7 → 0.0.9

package/dist/cache.d.ts

@@ -20,6 +20,7 @@ export declare class Cache {
     private logger;
     private defaultTTL;
     private compressionThreshold;
+    private namespace;
     /**
      * Creates a cache bound to a Redis client.
      *
@@ -31,6 +32,7 @@ export declare class Cache {
      *     applied when no per-call TTL is specified.
      *   - `compressionThreshold` (number, optional, default: `1024`) - Byte threshold
      *     above which values are gzip-compressed transparently.
+     *   - `namespace` (string, optional, default: `cache`) - Namespace prefix for all keys.
      * - `logger` - Optional pino-compatible logger. Supports `trace/debug/info/warn/error/fatal`
      *   levels and `child()` for namespace logging. Defaults to `console`.
      *
@@ -39,7 +41,7 @@ export declare class Cache {
      *
      * **Example:**
      * ```ts
-     * const cache = new Cache(client, { defaultTTL: 600, compressionThreshold: 2048 });
+     * const cache = new Cache(client, { defaultTTL: 600, compressionThreshold: 2048, namespace: "myapp" });
      * ```
      */
     constructor(client: RedisClientWrapper, config: CacheInputConfig, logger?: LoggerLike);

package/dist/cache.js

@@ -23,6 +23,7 @@ export class Cache {
     // private config: RedisConfig;
     defaultTTL;
     compressionThreshold;
+    namespace;
     /**
      * Creates a cache bound to a Redis client.
      *
@@ -34,6 +35,7 @@ export class Cache {
      *     applied when no per-call TTL is specified.
      *   - `compressionThreshold` (number, optional, default: `1024`) - Byte threshold
      *     above which values are gzip-compressed transparently.
+     *   - `namespace` (string, optional, default: `cache`) - Namespace prefix for all keys.
      * - `logger` - Optional pino-compatible logger. Supports `trace/debug/info/warn/error/fatal`
      *   levels and `child()` for namespace logging. Defaults to `console`.
      *
@@ -42,7 +44,7 @@ export class Cache {
      *
      * **Example:**
      * ```ts
-     * const cache = new Cache(client, { defaultTTL: 600, compressionThreshold: 2048 });
+     * const cache = new Cache(client, { defaultTTL: 600, compressionThreshold: 2048, namespace: "myapp" });
      * ```
      */
     constructor(client, config, logger = defaultLogger) {
@@ -51,6 +53,7 @@ export class Cache {
         // this.config = config;
         this.defaultTTL = config.defaultTTL || 3600;
         this.compressionThreshold = config.compressionThreshold || 1024;
+        this.namespace = config.namespace?.trim() || "cache";
     }
     async serialize(value) {
         // Convert to Buffer
@@ -105,7 +108,10 @@ export class Cache {
         return str;
     }
     getKey(key, namespace) {
-        return namespace ? `${namespace}:${key}` : key;
+        if (namespace?.trim()) {
+            return `${this.namespace}:${namespace.trim()}:${key}`;
+        }
+        return `${this.namespace}:${key}`;
     }
     /**
      * Reads a cached value.
@@ -1006,7 +1012,13 @@ export class Cache {
      * @returns The number of deleted keys.
      */
     async deletePattern(pattern, namespace) {
-        const fullPattern = namespace ? `${namespace}:${pattern}` : pattern;
+        let fullPattern;
+        if (namespace?.trim()) {
+            fullPattern = `${this.namespace}:${namespace.trim()}:${pattern}`;
+        }
+        else {
+            fullPattern = `${this.namespace}:${pattern}`;
+        }
         let deleted = 0;
         for await (const key of this.client.scanIterator(fullPattern)) {
             const result = await this.client.del(key);
@@ -1055,7 +1067,13 @@ export class Cache {
      * @returns Matching keys.
      */
     async keys(pattern, namespace) {
-        const fullPattern = namespace ? `${namespace}:${pattern}` : pattern;
+        let fullPattern;
+        if (namespace?.trim()) {
+            fullPattern = `${this.namespace}:${namespace.trim()}:${pattern}`;
+        }
+        else {
+            fullPattern = `${this.namespace}:${pattern}`;
+        }
         const keys = [];
         for await (const key of this.client.scanIterator(fullPattern)) {
             keys.push(key);

package/dist/client.js

@@ -295,6 +295,7 @@ export class RedisClientWrapper {
                 revocationStore: options.revocationStore ?? this.revocationStore,
             };
             this._session = createSessionManager(params);
+            void this._session.init();
             this.config.sessionOptions = params;
         }
         return this._session;

package/dist/types.d.ts

@@ -50,6 +50,7 @@ export type CacheOptions = {
 export declare const CacheOptionsSchema: z.ZodObject<{
     defaultTTL: z.ZodDefault<z.ZodNumber>;
     compressionThreshold: z.ZodDefault<z.ZodNumber>;
+    namespace: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 export type CacheInputConfig = z.input<typeof CacheOptionsSchema>;
 export type CacheStats = {
@@ -135,6 +136,7 @@ export declare const BaseRedisConfigSchema: z.ZodObject<{
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -179,6 +181,7 @@ export declare const StandaloneRedisConfigSchema: z.ZodObject<{
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -224,6 +227,7 @@ export declare const SentinelRedisConfigSchema: z.ZodObject<{
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -271,6 +275,7 @@ export declare const ClusterRedisConfigSchema: z.ZodObject<{
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -322,6 +327,7 @@ export declare const RedisConfigInputSchema: z.ZodUnion<readonly [z.ZodObject<{
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -362,6 +368,7 @@ export declare const RedisConfigInputSchema: z.ZodUnion<readonly [z.ZodObject<{
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -403,6 +410,7 @@ export declare const RedisConfigInputSchema: z.ZodUnion<readonly [z.ZodObject<{
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -462,6 +470,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -502,6 +511,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -543,6 +553,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions: z.ZodOptional<z.ZodObject<{
         defaultTTL: z.ZodDefault<z.ZodNumber>;
         compressionThreshold: z.ZodDefault<z.ZodNumber>;
+        namespace: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
     slowCommandThreshold: z.ZodDefault<z.ZodNumber>;
     rateLimit: z.ZodOptional<z.ZodObject<{
@@ -592,6 +603,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions?: {
         defaultTTL: number;
         compressionThreshold: number;
+        namespace: string;
     } | undefined;
     rateLimit?: {
         limit: number;
@@ -630,6 +642,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions?: {
         defaultTTL: number;
         compressionThreshold: number;
+        namespace: string;
     } | undefined;
     rateLimit?: {
         limit: number;
@@ -666,6 +679,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions?: {
         defaultTTL: number;
         compressionThreshold: number;
+        namespace: string;
     } | undefined;
     rateLimit?: {
         limit: number;
@@ -702,6 +716,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions?: {
         defaultTTL: number;
         compressionThreshold: number;
+        namespace: string;
     } | undefined;
     rateLimit?: {
         limit: number;
@@ -743,6 +758,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions?: {
         defaultTTL: number;
         compressionThreshold: number;
+        namespace: string;
     } | undefined;
     rateLimit?: {
         limit: number;
@@ -781,6 +797,7 @@ export declare const RedisConfigSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObje
     cacheOptions?: {
         defaultTTL: number;
         compressionThreshold: number;
+        namespace: string;
     } | undefined;
     rateLimit?: {
         limit: number;

package/dist/types.js

@@ -7,6 +7,7 @@ export const DistributedLockOptionsSchema = z.object({
 export const CacheOptionsSchema = z.object({
     defaultTTL: z.number().int().min(0).default(3_600),
     compressionThreshold: z.number().int().min(1).default(1_024),
+    namespace: z.string().min(1).default("cache"),
 });
 // ============================================================================
 // Rate Limiting

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ioredis-toolkit",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Production-grade, type-safe Redis infrastructure for standalone, Sentinel, and Cluster deployments",
   "type": "module",
   "main": "./dist/index.js",