@winible/winible-typed 2.109.0 → 2.111.0

package/dist/utils/cacheService/cacheService.js

@@ -26,6 +26,8 @@ class CacheService {
     constructor() {
         this.client = null;
         this.errorHandler = null;
+        this.isConnected = false; // Track connection state
+        this.hasConnectedBefore = false; // Track if we've ever connected
     }
     /**
      * Set a custom error handler for capturing errors to Sentry or other services
@@ -68,13 +70,31 @@ class CacheService {
             const username = process.env.ELASTICACHE_USERNAME;
             const password = process.env.ELASTICACHE_PASSWORD;
             if (!host) {
-                throw new Error("ELASTICACHE_HOST environment variable is required");
+                const error = new Error("ELASTICACHE_HOST environment variable is required");
+                this.handleError(error, null, {
+                    method: "CacheService.initialize",
+                    action: "validation_error",
+                    additionalData: { message: "Missing ELASTICACHE_HOST" },
+                });
+                return;
             }
             if (!username) {
-                throw new Error("ELASTICACHE_USERNAME environment variable is required");
+                const error = new Error("ELASTICACHE_USERNAME environment variable is required");
+                this.handleError(error, null, {
+                    method: "CacheService.initialize",
+                    action: "validation_error",
+                    additionalData: { message: "Missing ELASTICACHE_USERNAME" },
+                });
+                return;
             }
             if (!password) {
-                throw new Error("ELASTICACHE_PASSWORD environment variable is required");
+                const error = new Error("ELASTICACHE_PASSWORD environment variable is required");
+                this.handleError(error, null, {
+                    method: "CacheService.initialize",
+                    action: "validation_error",
+                    additionalData: { message: "Missing ELASTICACHE_PASSWORD" },
+                });
+                return;
             }
             (0, logger_1.default)("Initializing cache client", {
                 level: "info",
@@ -88,55 +108,76 @@ class CacheService {
                 username,
                 password,
                 connectTimeout: 10000,
+                commandTimeout: 5000,
+                // enableOfflineQueue: false, // fail immediately when disconnected
+                maxRetriesPerRequest: 1,
                 retryStrategy: (times) => {
-                    // Stop retrying after 3 attempts
-                    if (times > 3) {
-                        return null; // Stop retrying - this will cause the connection to fail
-                    }
-                    const delay = Math.min(times * 50, 2000);
+                    // Retry with exponential backoff, max 30 seconds between attempts
+                    const delay = Math.min(times * 1000, 30000);
                     return delay;
                 },
-                maxRetriesPerRequest: parseInt(process.env.ELASTICACHE_MAX_RETRIES, 10) || 3,
-                tls: process.env.ELASTICACHE_SSL === "false" || process.env.ENVIRONMENT === "local"
-                    ? null : {
-                    rejectUnauthorized: true,
-                }
-            });
-            this.client.on("connect", () => {
-                (0, logger_1.default)("Cache client connected", {
-                    level: "info",
-                    method: "CacheService",
-                    action: "connected",
-                });
+                tls: process.env.ELASTICACHE_SSL === "false" ||
+                    process.env.ENVIRONMENT === "local"
+                    ? null
+                    : {
+                        rejectUnauthorized: true,
+                    },
             });
             this.client.on("ready", () => {
-                (0, logger_1.default)("Cache client ready", {
-                    level: "info",
-                    method: "CacheService",
-                    action: "ready",
-                });
+                // Only log when transitioning from disconnected to connected
+                if (!this.isConnected) {
+                    this.isConnected = true;
+                    // Only alert Sentry on Reconnection, not initial connection
+                    if (this.hasConnectedBefore && this.errorHandler) {
+                        const reconnectInfo = new Error("Cache reconnected successfully");
+                        reconnectInfo.name = "CacheReconnected";
+                        this.errorHandler(reconnectInfo, undefined, {
+                            method: "CacheService",
+                            action: "reconnected",
+                            additionalData: { message: "Cache connection restored" },
+                        });
+                    }
+                    else {
+                        // Mark that we've connected at least once
+                        this.hasConnectedBefore = true;
+                        (0, logger_1.default)("Cache client connected successfully", {
+                            level: "info",
+                            method: "CacheService",
+                            action: "connected",
+                        });
+                    }
+                }
             });
             this.client.on("error", (error) => {
-                (0, logger_1.default)("Cache client error", {
-                    level: "error",
-                    method: "CacheService",
-                    action: "error",
-                    additionalData: { error: error.message },
-                });
+                // Only report error when transitioning from connected to disconnected
+                if (this.isConnected) {
+                    this.isConnected = false;
+                    this.handleError(error, null, {
+                        method: "CacheService",
+                        action: "disconnected",
+                        additionalData: {
+                            message: "Cache connection lost",
+                            error: error.message,
+                        },
+                    });
+                }
+                // Ignore repeated errors while already disconnected
             });
             this.client.on("close", () => {
-                (0, logger_1.default)("Cache client disconnected", {
-                    level: "info",
-                    method: "CacheService",
-                    action: "disconnected",
-                });
+                // Only log when transitioning from connected to disconnected
+                if (this.isConnected) {
+                    this.isConnected = false;
+                    this.handleError(new Error("Cache Connection Closed"), null, {
+                        method: "CacheService",
+                        action: "disconnected",
+                        additionalData: { message: "Cache client disconnected" },
+                    });
+                }
+                // Ignore repeated close events while already disconnected
             });
-            // Wait for connection with timeout and throw if it fails
-            await Promise.race([
-                this.client.ping(),
-                new Promise((_, reject) => setTimeout(() => reject(new Error("Connection timeout after 20 seconds")), 20000)),
-            ]);
-            (0, logger_1.default)("Cache client connected successfully", {
+            await this.client.ping();
+            this.isConnected = true;
+            (0, logger_1.default)("Cache client initialized successfully", {
                 level: "info",
                 method: "CacheService.initialize",
                 action: "completed",
@@ -146,7 +187,9 @@ class CacheService {
             this.handleError(error, null, {
                 method: "CacheService.initialize",
                 action: "error",
-                additionalData: { message: error.message || "Failed to initialize cache client", },
+                additionalData: {
+                    message: error.message || "Failed to initialize cache client",
+                },
             });
         }
     }
@@ -156,6 +199,8 @@ class CacheService {
      * @returns The cached value or null if not found
      */
     async get(key) {
+        if (!this.isConnected)
+            return null;
         try {
             const value = await this.client.get(key);
             if (value === null) {
@@ -179,6 +224,8 @@ class CacheService {
      * @param ttl - Optional time-to-live in seconds
      */
     async set(key, value, ttl) {
+        if (!this.isConnected)
+            return;
         try {
             const serialized = JSON.stringify(value);
             if (ttl) {
@@ -201,6 +248,8 @@ class CacheService {
      * @param key - The cache key to delete
      */
     async delete(key) {
+        if (!this.isConnected)
+            return;
         try {
             await this.client.del(key);
         }
@@ -219,6 +268,8 @@ class CacheService {
      * @returns Array of matching keys
      */
     async keys(pattern) {
+        if (!this.isConnected)
+            return [];
         try {
             const keys = [];
             let cursor = "0";
@@ -244,6 +295,8 @@ class CacheService {
      * @returns The total number of keys
      */
     async dbsize() {
+        if (!this.isConnected)
+            return 0;
         try {
             const size = await this.client.dbsize();
             return size;
@@ -263,6 +316,8 @@ class CacheService {
      * @param pattern - Pattern to match (e.g., "user:*", "*:session")
      */
     async clearPattern(pattern) {
+        if (!this.isConnected)
+            return;
         try {
             const keys = await this.keys(pattern);
             if (keys.length > 0) {
@@ -282,7 +337,10 @@ class CacheService {
             this.handleError(error, null, {
                 method: "CacheService.clearPattern",
                 action: "error",
-                additionalData: { message: "Failed to clear keys matching pattern", pattern },
+                additionalData: {
+                    message: "Failed to clear keys matching pattern",
+                    pattern,
+                },
             });
         }
     }
@@ -292,6 +350,8 @@ class CacheService {
      * @returns true if the key exists, false otherwise
      */
     async exists(key) {
+        if (!this.isConnected)
+            return false;
         try {
             const result = await this.client.exists(key);
             return result === 1;
@@ -310,6 +370,8 @@ class CacheService {
      * @param entries - Array of key-value-ttl tuples
      */
     async mset(entries) {
+        if (!this.isConnected)
+            return;
         try {
             const pipeline = this.client.pipeline();
             entries.forEach(({ key, value, ttl }) => {
@@ -327,7 +389,10 @@ class CacheService {
             this.handleError(error, null, {
                 method: "CacheService.mset",
                 action: "error",
-                additionalData: { message: "Failed to set multiple values in cache", count: entries.length },
+                additionalData: {
+                    message: "Failed to set multiple values in cache",
+                    count: entries.length,
+                },
             });
         }
     }
@@ -337,15 +402,20 @@ class CacheService {
      * @returns Array of cached values (null for missing keys)
      */
     async mget(keys) {
+        if (!this.isConnected)
+            return keys.map(() => null);
         try {
             const values = await this.client.mget(...keys);
-            return values.map((value) => value ? JSON.parse(value) : null);
+            return values.map((value) => (value ? JSON.parse(value) : null));
         }
         catch (error) {
             this.handleError(error, null, {
                 method: "CacheService.mget",
                 action: "error",
-                additionalData: { message: "Failed to get multiple values from cache", count: keys.length },
+                additionalData: {
+                    message: "Failed to get multiple values from cache",
+                    count: keys.length,
+                },
             });
             return keys.map(() => null);
         }
@@ -357,6 +427,8 @@ class CacheService {
      * @returns The new value after increment
      */
     async increment(key, increment = 1) {
+        if (!this.isConnected)
+            return 0;
         try {
             return await this.client.incrby(key, increment);
         }
@@ -364,7 +436,11 @@ class CacheService {
             this.handleError(error, null, {
                 method: "CacheService.increment",
                 action: "error",
-                additionalData: { message: "Failed to increment value in cache", key, increment },
+                additionalData: {
+                    message: "Failed to increment value in cache",
+                    key,
+                    increment,
+                },
             });
             return 0;
         }
@@ -376,6 +452,8 @@ class CacheService {
      * @returns The new value after decrement
      */
     async decrement(key, decrement = 1) {
+        if (!this.isConnected)
+            return 0;
         try {
             return await this.client.decrby(key, decrement);
         }
@@ -383,7 +461,11 @@ class CacheService {
             this.handleError(error, null, {
                 method: "CacheService.decrement",
                 action: "error",
-                additionalData: { message: "Failed to decrement value in cache", key, decrement },
+                additionalData: {
+                    message: "Failed to decrement value in cache",
+                    key,
+                    decrement,
+                },
             });
             return 0;
         }
@@ -395,6 +477,8 @@ class CacheService {
      * @returns true if the timeout was set, false if key doesn't exist
      */
     async expire(key, ttl) {
+        if (!this.isConnected)
+            return false;
         try {
             const result = await this.client.expire(key, ttl);
             return result === 1;
@@ -403,7 +487,11 @@ class CacheService {
             this.handleError(error, null, {
                 method: "CacheService.expire",
                 action: "error",
-                additionalData: { message: "Failed to set expiration on key", key, ttl },
+                additionalData: {
+                    message: "Failed to set expiration on key",
+                    key,
+                    ttl,
+                },
             });
             return false;
         }
@@ -414,6 +502,8 @@ class CacheService {
      * @returns TTL in seconds, -1 if key exists but has no expire, -2 if key doesn't exist
      */
     async ttl(key) {
+        if (!this.isConnected)
+            return -2;
         try {
             return await this.client.ttl(key);
         }
@@ -426,6 +516,58 @@ class CacheService {
             return -2;
         }
     }
+    /**
+     * Atomically set a value only if the key doesn't exist (SETNX)
+     * Uses Redis SET NX EX command which is atomic - no race conditions possible.
+     *
+     * @param key - The cache key
+     * @param value - The value to cache (will be JSON serialized)
+     * @param ttl - Time-to-live in seconds (required for safety)
+     * @returns true if the value was set (key didn't exist), false if key already exists
+     *
+     * @example
+     * // Single-use token implementation
+     * const wasSet = await cacheService.setIfNotExists('magic_link:abc123', { userId: '123' }, 300);
+     * if (!wasSet) {
+     *   throw new Error('Token already used');
+     * }
+     *
+     * @example
+     * // Distributed lock
+     * const lockAcquired = await cacheService.setIfNotExists('lock:resource_id', { owner: 'worker-1' }, 30);
+     * if (lockAcquired) {
+     *   try {
+     *     // Do work while holding lock
+     *   } finally {
+     *     await cacheService.delete('lock:resource_id');
+     *   }
+     * }
+     */
+    async setIfNotExists(key, value, ttl) {
+        if (!this.isConnected)
+            return false;
+        try {
+            const serialized = JSON.stringify(value);
+            // Atomic operation: SET key value EX ttl NX
+            // EX = Set expiry in seconds
+            // NX = Only set if key doesn't exist
+            // Returns "OK" if set successfully, null if key already exists
+            const result = await this.client.set(key, serialized, "EX", ttl, "NX");
+            return result === "OK";
+        }
+        catch (error) {
+            this.handleError(error, null, {
+                method: "CacheService.setIfNotExists",
+                action: "error",
+                additionalData: {
+                    message: "Failed to set value atomically",
+                    key,
+                    ttl,
+                },
+            });
+            return false;
+        }
+    }
     /**
      * Disconnect the cache client
      * Use this for graceful shutdown
@@ -440,8 +582,7 @@ class CacheService {
                 this.client.disconnect();
             }
             this.client = null;
-            // this.isInitialized = false;
-            // this.initPromise = null;
+            this.isConnected = false;
             (0, logger_1.default)("Cache client disconnected", {
                 level: "info",
                 method: "CacheService.disconnect",
@@ -450,6 +591,8 @@ class CacheService {
         }
     }
     async ping() {
+        if (!this.isConnected)
+            return "";
         try {
             const result = await this.client.ping();
             return result;
@@ -460,6 +603,7 @@ class CacheService {
                 action: "error",
                 additionalData: { message: "Failed to ping cache client" },
             });
+            return "";
         }
     }
 }

package/dist/utils/cacheService/cacheService.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@winible/winible-typed",
-  "version": "2.109.0",
+  "version": "2.111.0",
   "description": "",
   "main": "dist/index.js",
   "types": "./dist/index.d.ts",

package/utils/cacheService/cacheService.test.ts

@@ -52,7 +52,7 @@ describe('CacheService', () => {
         undefined,
         expect.objectContaining({
           method: 'CacheService.initialize',
-          action: 'error',
+          action: 'validation_error',
           additionalData: expect.objectContaining({
             message: expect.any(String),
           }),
@@ -73,7 +73,7 @@ describe('CacheService', () => {
         undefined,
         expect.objectContaining({
           method: 'CacheService.initialize',
-          action: 'error',
+          action: 'validation_error',
           additionalData: expect.objectContaining({
             message: expect.any(String),
           }),
@@ -94,7 +94,7 @@ describe('CacheService', () => {
         undefined,
         expect.objectContaining({
           method: 'CacheService.initialize',
-          action: 'error',
+          action: 'validation_error',
           additionalData: expect.objectContaining({
             message: expect.any(String),
           }),
@@ -446,6 +446,142 @@ describe('CacheService', () => {
     });
   });
 
+  describe('Atomic Operations', () => {
+    describe('setIfNotExists', () => {
+      it('should set value if key does not exist', async () => {
+        const wasSet = await cacheService.setIfNotExists('atomic:1', { data: 'value1' }, 300);
+        expect(wasSet).toBe(true);
+
+        const value = await cacheService.get('atomic:1');
+        expect(value).toEqual({ data: 'value1' });
+      });
+
+      it('should return false if key already exists', async () => {
+        // Set initial value
+        await cacheService.set('atomic:2', { data: 'original' }, 300);
+
+        // Try to set with setIfNotExists
+        const wasSet = await cacheService.setIfNotExists('atomic:2', { data: 'new' }, 300);
+        expect(wasSet).toBe(false);
+
+        // Verify original value unchanged
+        const value = await cacheService.get('atomic:2');
+        expect(value).toEqual({ data: 'original' });
+      });
+
+      it('should set value with TTL', async () => {
+        const wasSet = await cacheService.setIfNotExists('atomic:ttl', { data: 'temp' }, 1);
+        expect(wasSet).toBe(true);
+
+        // Verify key exists immediately
+        let value = await cacheService.get('atomic:ttl');
+        expect(value).toEqual({ data: 'temp' });
+
+        // Wait for expiry
+        await new Promise(resolve => setTimeout(resolve, 1100));
+
+        // Verify key is gone
+        value = await cacheService.get('atomic:ttl');
+        expect(value).toBeNull();
+      });
+
+      it('should handle concurrent requests atomically', async () => {
+        const key = 'atomic:concurrent';
+        const promises = Array(10)
+          .fill(null)
+          .map((_, i) => cacheService.setIfNotExists(key, { request: i }, 300));
+
+        const results = await Promise.all(promises);
+        const successCount = results.filter(r => r === true).length;
+
+        // Only ONE request should succeed
+        expect(successCount).toBe(1);
+
+        // Verify a value was set
+        const value = await cacheService.get<{ request: number }>(key);
+        expect(value).toHaveProperty('request');
+        expect(typeof value!.request).toBe('number');
+        expect(value!.request).toBeGreaterThanOrEqual(0);
+        expect(value!.request).toBeLessThan(10);
+      });
+
+      it('should allow setting after key expires', async () => {
+        // Set with 1 second TTL
+        const firstSet = await cacheService.setIfNotExists('atomic:expire', { data: 'first' }, 1);
+        expect(firstSet).toBe(true);
+
+        // Wait for expiry
+        await new Promise(resolve => setTimeout(resolve, 1100));
+
+        // Should be able to set again after expiration
+        const secondSet = await cacheService.setIfNotExists('atomic:expire', { data: 'second' }, 300);
+        expect(secondSet).toBe(true);
+
+        const value = await cacheService.get('atomic:expire');
+        expect(value).toEqual({ data: 'second' });
+      });
+
+      it('should work with string values', async () => {
+        const wasSet = await cacheService.setIfNotExists('atomic:string', 'simple-value', 300);
+        expect(wasSet).toBe(true);
+
+        const value = await cacheService.get<string>('atomic:string');
+        expect(value).toBe('simple-value');
+      });
+
+      it('should work with numeric values', async () => {
+        const wasSet = await cacheService.setIfNotExists('atomic:number', 42, 300);
+        expect(wasSet).toBe(true);
+
+        const value = await cacheService.get<number>('atomic:number');
+        expect(value).toBe(42);
+      });
+
+      it('should work with array values', async () => {
+        const arr = [1, 2, 3, 4, 5];
+        const wasSet = await cacheService.setIfNotExists('atomic:array', arr, 300);
+        expect(wasSet).toBe(true);
+
+        const value = await cacheService.get<number[]>('atomic:array');
+        expect(value).toEqual(arr);
+      });
+
+      it('should work with complex nested objects', async () => {
+        const complex = {
+          userId: 'user-123',
+          metadata: {
+            usedAt: Date.now(),
+            source: 'mobile',
+            nested: {
+              deep: {
+                value: true,
+              },
+            },
+          },
+        };
+
+        const wasSet = await cacheService.setIfNotExists('atomic:complex', complex, 300);
+        expect(wasSet).toBe(true);
+
+        const value = await cacheService.get('atomic:complex');
+        expect(value).toEqual(complex);
+      });
+
+      it('should return false when trying to overwrite existing key with different TTL', async () => {
+        // Set initial value with 300s TTL
+        await cacheService.set('atomic:overwrite', { data: 'original' }, 300);
+
+        // Try to set with different TTL
+        const wasSet = await cacheService.setIfNotExists('atomic:overwrite', { data: 'new' }, 600);
+        expect(wasSet).toBe(false);
+
+        // Verify original value and TTL unchanged
+        const value = await cacheService.get('atomic:overwrite');
+        expect(value).toEqual({ data: 'original' });
+      });
+    });
+  });
+
   describe('Connection Management', () => {
     it('should disconnect gracefully', async () => {
       await cacheService.set('test', 'value');

package/utils/cacheService/cacheService.ts

@@ -33,12 +33,14 @@ type ErrorHandler = (
 class CacheService {
   private client: Redis | null = null;
   private errorHandler: any = null;
+  private isConnected: boolean = false; // Track connection state
+  private hasConnectedBefore: boolean = false; // Track if we've ever connected
 
   /**
    * Set a custom error handler for capturing errors to Sentry or other services
    * @param handler - Function to handle errors
    */
-  setErrorHandler(handler: any): void {
+  setErrorHandler(handler: (error: any, req: any, context: any) => void): void {
     this.errorHandler = handler;
   }
 
@@ -56,7 +58,7 @@ class CacheService {
     }
   ): void {
     if (this.errorHandler) {
-      error.name = context.method
+      error.name = context.method;
       this.errorHandler(error, undefined, context);
     } else {
       // Fallback to logger if no error handler is set
@@ -85,13 +87,37 @@ class CacheService {
       const password = process.env.ELASTICACHE_PASSWORD;
 
       if (!host) {
-        throw new Error("ELASTICACHE_HOST environment variable is required");
+        const error = new Error(
+          "ELASTICACHE_HOST environment variable is required"
+        );
+        this.handleError(error, null, {
+          method: "CacheService.initialize",
+          action: "validation_error",
+          additionalData: { message: "Missing ELASTICACHE_HOST" },
+        });
+        return;
       }
       if (!username) {
-        throw new Error("ELASTICACHE_USERNAME environment variable is required");
+        const error = new Error(
+          "ELASTICACHE_USERNAME environment variable is required"
+        );
+        this.handleError(error, null, {
+          method: "CacheService.initialize",
+          action: "validation_error",
+          additionalData: { message: "Missing ELASTICACHE_USERNAME" },
+        });
+        return;
       }
       if (!password) {
-        throw new Error("ELASTICACHE_PASSWORD environment variable is required");
+        const error = new Error(
+          "ELASTICACHE_PASSWORD environment variable is required"
+        );
+        this.handleError(error, null, {
+          method: "CacheService.initialize",
+          action: "validation_error",
+          additionalData: { message: "Missing ELASTICACHE_PASSWORD" },
+        });
+        return;
       }
 
       logger("Initializing cache client", {
@@ -106,64 +132,85 @@ class CacheService {
         port,
         username,
         password,
-        connectTimeout: 10000, // 10 seconds timeout for initial connection
+        connectTimeout: 10000, // 10s connection timeout
+        commandTimeout: 5000, // fail commands taking longer than 5s
+        // enableOfflineQueue: false, // fail immediately when disconnected
+        maxRetriesPerRequest: 1, // fail fast with only 1 retry attempt
         retryStrategy: (times: number) => {
-          // Stop retrying after 3 attempts
-          if (times > 3) {
-            return null; // Stop retrying - this will cause the connection to fail
-          }
-          const delay = Math.min(times * 50, 2000);
+          // Retry with exponential backoff, max 30 seconds between attempts
+          const delay = Math.min(times * 1000, 30000);
           return delay;
         },
-        maxRetriesPerRequest: parseInt(process.env.ELASTICACHE_MAX_RETRIES, 10) || 3,
-        tls: process.env.ELASTICACHE_SSL === "false" || process.env.ENVIRONMENT === "local"
-          ? null : {
-            rejectUnauthorized: true,
-          }
-      });
-
-      this.client.on("connect", () => {
-        logger("Cache client connected", {
-          level: "info",
-          method: "CacheService",
-          action: "connected",
-        });
+        tls:
+          process.env.ELASTICACHE_SSL === "false" ||
+          process.env.ENVIRONMENT === "local"
+            ? null
+            : {
+                rejectUnauthorized: true,
+              },
       });
 
       this.client.on("ready", () => {
-        logger("Cache client ready", {
-          level: "info",
-          method: "CacheService",
-          action: "ready",
-        });
+        // Only log when transitioning from disconnected to connected
+        if (!this.isConnected) {
+          this.isConnected = true;
+
+          // Only alert Sentry on Reconnection, not initial connection
+          if (this.hasConnectedBefore && this.errorHandler) {
+            const reconnectInfo = new Error("Cache reconnected successfully");
+            reconnectInfo.name = "CacheReconnected";
+
+            this.errorHandler(reconnectInfo, undefined, {
+              method: "CacheService",
+              action: "reconnected",
+              additionalData: { message: "Cache connection restored" },
+            });
+          } else {
+            // Mark that we've connected at least once
+            this.hasConnectedBefore = true;
+
+            logger("Cache client connected successfully", {
+              level: "info",
+              method: "CacheService",
+              action: "connected",
+            });
+          }
+        }
       });
 
       this.client.on("error", (error) => {
-        logger("Cache client error", {
-          level: "error",
-          method: "CacheService",
-          action: "error",
-          additionalData: { error: error.message },
-        });
+        // Only report error when transitioning from connected to disconnected
+        if (this.isConnected) {
+          this.isConnected = false;
+          this.handleError(error, null, {
+            method: "CacheService",
+            action: "disconnected",
+            additionalData: {
+              message: "Cache connection lost",
+              error: error.message,
+            },
+          });
+        }
+        // Ignore repeated errors while already disconnected
       });
 
       this.client.on("close", () => {
-        logger("Cache client disconnected", {
-          level: "info",
-          method: "CacheService",
-          action: "disconnected",
-        });
+        // Only log when transitioning from connected to disconnected
+        if (this.isConnected) {
+          this.isConnected = false;
+          this.handleError(new Error("Cache Connection Closed"), null, {
+            method: "CacheService",
+            action: "disconnected",
+            additionalData: { message: "Cache client disconnected" },
+          });
+        }
+        // Ignore repeated close events while already disconnected
       });
 
-      // Wait for connection with timeout and throw if it fails
-      await Promise.race([
-        this.client.ping(),
-        new Promise((_, reject) =>
-          setTimeout(() => reject(new Error("Connection timeout after 20 seconds")), 20000)
-        ),
-      ]);
+      await this.client.ping();
+      this.isConnected = true;
 
-      logger("Cache client connected successfully", {
+      logger("Cache client initialized successfully", {
         level: "info",
         method: "CacheService.initialize",
         action: "completed",
@@ -172,7 +219,9 @@ class CacheService {
       this.handleError(error, null, {
         method: "CacheService.initialize",
         action: "error",
-        additionalData: { message: error.message || "Failed to initialize cache client", },
+        additionalData: {
+          message: error.message || "Failed to initialize cache client",
+        },
       });
     }
   }
@@ -183,6 +232,8 @@ class CacheService {
    * @returns The cached value or null if not found
    */
   async get<T>(key: string): Promise<T | null> {
+    if (!this.isConnected) return null;
+
     try {
       const value = await this.client!.get(key);
       if (value === null) {
@@ -206,6 +257,8 @@ class CacheService {
    * @param ttl - Optional time-to-live in seconds
    */
   async set<T>(key: string, value: T, ttl?: number): Promise<void> {
+    if (!this.isConnected) return;
+
     try {
       const serialized = JSON.stringify(value);
       if (ttl) {
@@ -227,6 +280,8 @@ class CacheService {
    * @param key - The cache key to delete
    */
   async delete(key: string): Promise<void> {
+    if (!this.isConnected) return;
+
     try {
       await this.client!.del(key);
     } catch (error) {
@@ -245,6 +300,8 @@ class CacheService {
    * @returns Array of matching keys
    */
   async keys(pattern: string): Promise<string[]> {
+    if (!this.isConnected) return [];
+
     try {
       const keys: string[] = [];
       let cursor = "0";
@@ -278,6 +335,8 @@ class CacheService {
    * @returns The total number of keys
    */
   async dbsize(): Promise<number> {
+    if (!this.isConnected) return 0;
+
     try {
       const size = await this.client!.dbsize();
       return size;
@@ -297,6 +356,8 @@ class CacheService {
    * @param pattern - Pattern to match (e.g., "user:*", "*:session")
    */
   async clearPattern(pattern: string): Promise<void> {
+    if (!this.isConnected) return;
+
     try {
       const keys = await this.keys(pattern);
       if (keys.length > 0) {
@@ -315,7 +376,10 @@ class CacheService {
       this.handleError(error, null, {
         method: "CacheService.clearPattern",
         action: "error",
-        additionalData: { message: "Failed to clear keys matching pattern", pattern },
+        additionalData: {
+          message: "Failed to clear keys matching pattern",
+          pattern,
+        },
       });
     }
   }
@@ -326,6 +390,8 @@ class CacheService {
    * @returns true if the key exists, false otherwise
    */
   async exists(key: string): Promise<boolean> {
+    if (!this.isConnected) return false;
+
     try {
       const result = await this.client!.exists(key);
       return result === 1;
@@ -346,6 +412,8 @@ class CacheService {
   async mset(
     entries: Array<{ key: string; value: any; ttl?: number }>
   ): Promise<void> {
+    if (!this.isConnected) return;
+
     try {
       const pipeline = this.client!.pipeline();
       entries.forEach(({ key, value, ttl }) => {
@@ -361,7 +429,10 @@ class CacheService {
       this.handleError(error, null, {
         method: "CacheService.mset",
         action: "error",
-        additionalData: { message: "Failed to set multiple values in cache", count: entries.length },
+        additionalData: {
+          message: "Failed to set multiple values in cache",
+          count: entries.length,
+        },
       });
     }
   }
@@ -372,16 +443,19 @@ class CacheService {
    * @returns Array of cached values (null for missing keys)
    */
   async mget<T>(keys: string[]): Promise<Array<T | null>> {
+    if (!this.isConnected) return keys.map(() => null);
+
     try {
       const values = await this.client!.mget(...keys);
-      return values.map((value) =>
-        value ? (JSON.parse(value) as T) : null
-      );
+      return values.map((value) => (value ? (JSON.parse(value) as T) : null));
     } catch (error) {
       this.handleError(error, null, {
         method: "CacheService.mget",
         action: "error",
-        additionalData: { message: "Failed to get multiple values from cache", count: keys.length },
+        additionalData: {
+          message: "Failed to get multiple values from cache",
+          count: keys.length,
+        },
       });
       return keys.map(() => null);
     }
@@ -394,13 +468,19 @@ class CacheService {
    * @returns The new value after increment
    */
   async increment(key: string, increment: number = 1): Promise<number> {
+    if (!this.isConnected) return 0;
+
     try {
       return await this.client!.incrby(key, increment);
     } catch (error) {
       this.handleError(error, null, {
         method: "CacheService.increment",
         action: "error",
-        additionalData: { message: "Failed to increment value in cache", key, increment },
+        additionalData: {
+          message: "Failed to increment value in cache",
+          key,
+          increment,
+        },
       });
       return 0;
     }
@@ -413,13 +493,19 @@ class CacheService {
    * @returns The new value after decrement
    */
   async decrement(key: string, decrement: number = 1): Promise<number> {
+    if (!this.isConnected) return 0;
+
     try {
       return await this.client!.decrby(key, decrement);
     } catch (error) {
       this.handleError(error, null, {
         method: "CacheService.decrement",
         action: "error",
-        additionalData: { message: "Failed to decrement value in cache", key, decrement },
+        additionalData: {
+          message: "Failed to decrement value in cache",
+          key,
+          decrement,
+        },
       });
       return 0;
     }
@@ -432,6 +518,8 @@ class CacheService {
    * @returns true if the timeout was set, false if key doesn't exist
    */
   async expire(key: string, ttl: number): Promise<boolean> {
+    if (!this.isConnected) return false;
+
     try {
       const result = await this.client!.expire(key, ttl);
       return result === 1;
@@ -439,7 +527,11 @@ class CacheService {
       this.handleError(error, null, {
         method: "CacheService.expire",
         action: "error",
-        additionalData: { message: "Failed to set expiration on key", key, ttl },
+        additionalData: {
+          message: "Failed to set expiration on key",
+          key,
+          ttl,
+        },
       });
       return false;
     }
@@ -451,6 +543,8 @@ class CacheService {
    * @returns TTL in seconds, -1 if key exists but has no expire, -2 if key doesn't exist
    */
   async ttl(key: string): Promise<number> {
+    if (!this.isConnected) return -2;
+
     try {
       return await this.client!.ttl(key);
     } catch (error) {
@@ -463,6 +557,64 @@ class CacheService {
     }
   }
 
+  /**
+   * Atomically set a value only if the key doesn't exist (SETNX)
+   * Uses Redis SET NX EX command which is atomic - no race conditions possible.
+   *
+   * @param key - The cache key
+   * @param value - The value to cache (will be JSON serialized)
+   * @param ttl - Time-to-live in seconds (required for safety)
+   * @returns true if the value was set (key didn't exist), false if key already exists
+   *
+   * @example
+   * // Single-use token implementation
+   * const wasSet = await cacheService.setIfNotExists('magic_link:abc123', { userId: '123' }, 300);
+   * if (!wasSet) {
+   *   throw new Error('Token already used');
+   * }
+   *
+   * @example
+   * // Distributed lock
+   * const lockAcquired = await cacheService.setIfNotExists('lock:resource_id', { owner: 'worker-1' }, 30);
+   * if (lockAcquired) {
+   *   try {
+   *     // Do work while holding lock
+   *   } finally {
+   *     await cacheService.delete('lock:resource_id');
+   *   }
+   * }
+   */
+  async setIfNotExists<T>(
+    key: string,
+    value: T,
+    ttl: number
+  ): Promise<boolean> {
+    if (!this.isConnected) return false;
+
+    try {
+      const serialized = JSON.stringify(value);
+
+      // Atomic operation: SET key value EX ttl NX
+      // EX = Set expiry in seconds
+      // NX = Only set if key doesn't exist
+      // Returns "OK" if set successfully, null if key already exists
+      const result = await this.client!.set(key, serialized, "EX", ttl, "NX");
+
+      return result === "OK";
+    } catch (error) {
+      this.handleError(error, null, {
+        method: "CacheService.setIfNotExists",
+        action: "error",
+        additionalData: {
+          message: "Failed to set value atomically",
+          key,
+          ttl,
+        },
+      });
+      return false;
+    }
+  }
+
   /**
    * Disconnect the cache client
    * Use this for graceful shutdown
@@ -476,8 +628,7 @@ class CacheService {
         this.client.disconnect();
       }
       this.client = null;
-      // this.isInitialized = false;
-      // this.initPromise = null;
+      this.isConnected = false;
       logger("Cache client disconnected", {
         level: "info",
         method: "CacheService.disconnect",
@@ -487,6 +638,8 @@ class CacheService {
   }
 
   async ping(): Promise<string> {
+    if (!this.isConnected) return "";
+
     try {
       const result = await this.client!.ping();
       return result;
@@ -496,6 +649,7 @@ class CacheService {
         action: "error",
         additionalData: { message: "Failed to ping cache client" },
       });
+      return "";
     }
   }
 }