@naman_deep_singh/cache 1.2.0 → 1.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @naman_deep_singh/cache
 
-**Version:** 1.2.0 (with Redis Clustering support)
+**Version:** 1.3.0 (with Redis Clustering support)
 
 A flexible, extensible caching layer with support for Redis, Memcache, and in-memory caches. Includes session management, health checks, and Express middleware.
 
@@ -687,3 +687,9 @@ ISC
 ## Author
 
 Naman Deep Singh
+
+## TypeScript Notes
+
+- The package provides strong generics for `ICache<T>` and `SessionStore` so you can store typed values safely.
+- Middleware in this package may attach runtime properties (for example session data) to `Request` objects in Express. If you're using TypeScript, import the package into your project so the included type augmentations are picked up automatically — no need to cast `req` to `any` in most cases.
+

package/dist/cjs/adapters/memcache/MemcacheCache.js

@@ -86,19 +86,28 @@ class MemcacheCache extends BaseCache_1.BaseCache {
                         reject(err);
                         return;
                     }
-                    if (data === undefined) {
+                    if (data === undefined || data === null) {
                         this.recordMiss();
                         resolve(null);
+                        return;
                     }
-                    else {
-                        this.recordHit();
-                        try {
+                    this.recordHit();
+                    try {
+                        if (typeof data === 'string') {
                             resolve(this.deserialize(data));
                         }
-                        catch (parseErr) {
-                            reject(parseErr);
+                        else if (Buffer.isBuffer(data)) {
+                            resolve(this.deserialize(data.toString()));
+                        }
+                        else {
+                            // Unknown shape from memcached client - treat as miss
+                            this.recordMiss();
+                            resolve(null);
                         }
                     }
+                    catch (parseErr) {
+                        reject(parseErr);
+                    }
                 });
             });
         }
@@ -201,21 +210,42 @@ class MemcacheCache extends BaseCache_1.BaseCache {
                         return;
                     }
                     const result = {};
+                    if (!data || typeof data !== 'object') {
+                        // Treat as all misses
+                        for (const key of keys) {
+                            this.recordMiss();
+                            result[key] = null;
+                        }
+                        resolve(result);
+                        return;
+                    }
+                    const map = data;
                     keys.forEach((key) => {
                         const fullKey = this.buildKey(key);
-                        if (fullKey in data) {
+                        const value = map[fullKey];
+                        if (value === undefined || value === null) {
+                            this.recordMiss();
+                            result[key] = null;
+                        }
+                        else {
                             this.recordHit();
                             try {
-                                result[key] = this.deserialize(data[fullKey]);
+                                if (typeof value === 'string') {
+                                    result[key] = this.deserialize(value);
+                                }
+                                else if (Buffer.isBuffer(value)) {
+                                    result[key] = this.deserialize(value.toString());
+                                }
+                                else {
+                                    // Unknown, treat as miss
+                                    this.recordMiss();
+                                    result[key] = null;
+                                }
                             }
                             catch (parseErr) {
                                 reject(parseErr);
                             }
                         }
-                        else {
-                            this.recordMiss();
-                            result[key] = null;
-                        }
                     });
                     resolve(result);
                 });

package/dist/cjs/adapters/redis/RedisCache.js

@@ -159,7 +159,7 @@ class RedisCache extends BaseCache_1.BaseCache {
             else {
                 // Clear all keys only in single-instance mode
                 const client = this.client;
-                if (client.flushDb) {
+                if (client && typeof client.flushDb === 'function') {
                     await client.flushDb();
                 }
                 else {
@@ -277,7 +277,13 @@ class RedisCache extends BaseCache_1.BaseCache {
         try {
             await this.ensureConnected();
             // Use sendCommand which works for both single and cluster
-            await this.client.sendCommand(['PING']);
+            // `sendCommand` exists on both single and cluster clients in runtime; cast narrowly for the call
+            if (this.client && typeof this.client.sendCommand === 'function') {
+                await this.client.sendCommand(['PING']);
+            }
+            else if (this.client && typeof this.client.ping === 'function') {
+                await this.client.ping();
+            }
             return {
                 isAlive: true,
                 adapter: 'redis',

package/dist/cjs/middleware/express/cacheMiddleware.js

@@ -82,10 +82,23 @@ function cacheResponseMiddleware(cache, options) {
                 if (res.statusCode >= 200 &&
                     res.statusCode < 300 &&
                     !excludeStatusCodes.includes(res.statusCode)) {
-                    const responseData = typeof data === 'string' ? data : JSON.stringify(data);
-                    cache.set(cacheKey, responseData, ttl).catch((err) => {
-                        console.error('Failed to cache response:', err);
-                    });
+                    let responseData = null;
+                    if (typeof data === 'string') {
+                        responseData = data;
+                    }
+                    else {
+                        try {
+                            responseData = JSON.stringify(data);
+                        }
+                        catch (e) {
+                            responseData = null;
+                        }
+                    }
+                    if (responseData !== null) {
+                        cache.set(cacheKey, responseData, ttl).catch((err) => {
+                            console.error('Failed to cache response:', err);
+                        });
+                    }
                 }
                 res.set('X-Cache', 'MISS');
                 return originalSend.call(this, data);

package/dist/cjs/session/SessionStore.d.ts

@@ -48,4 +48,10 @@ export declare class SessionStore {
      * Get session data and extend expiry in one operation
      */
     getAndExtend(sessionId: string, ttl?: number): Promise<SessionData | null>;
+    /**
+     * Optional close hook for graceful shutdowns.
+     * Present to allow callers to call `close()` during shutdown without
+     * requiring every store implementation to provide one.
+     */
+    close(): Promise<void>;
 }

package/dist/cjs/session/SessionStore.js

@@ -149,5 +149,13 @@ class SessionStore {
             throw new errors_1.CacheError(`Failed to get and extend session "${sessionId}"`, 'SESSION_GET_EXTEND_ERROR', 'session', err);
         }
     }
+    /**
+     * Optional close hook for graceful shutdowns.
+     * Present to allow callers to call `close()` during shutdown without
+     * requiring every store implementation to provide one.
+     */
+    async close() {
+        return;
+    }
 }
 exports.SessionStore = SessionStore;

package/dist/esm/adapters/memcache/MemcacheCache.js

@@ -80,19 +80,28 @@ export class MemcacheCache extends BaseCache {
                         reject(err);
                         return;
                     }
-                    if (data === undefined) {
+                    if (data === undefined || data === null) {
                         this.recordMiss();
                         resolve(null);
+                        return;
                     }
-                    else {
-                        this.recordHit();
-                        try {
+                    this.recordHit();
+                    try {
+                        if (typeof data === 'string') {
                             resolve(this.deserialize(data));
                         }
-                        catch (parseErr) {
-                            reject(parseErr);
+                        else if (Buffer.isBuffer(data)) {
+                            resolve(this.deserialize(data.toString()));
+                        }
+                        else {
+                            // Unknown shape from memcached client - treat as miss
+                            this.recordMiss();
+                            resolve(null);
                         }
                     }
+                    catch (parseErr) {
+                        reject(parseErr);
+                    }
                 });
             });
         }
@@ -195,21 +204,42 @@ export class MemcacheCache extends BaseCache {
                         return;
                     }
                     const result = {};
+                    if (!data || typeof data !== 'object') {
+                        // Treat as all misses
+                        for (const key of keys) {
+                            this.recordMiss();
+                            result[key] = null;
+                        }
+                        resolve(result);
+                        return;
+                    }
+                    const map = data;
                     keys.forEach((key) => {
                         const fullKey = this.buildKey(key);
-                        if (fullKey in data) {
+                        const value = map[fullKey];
+                        if (value === undefined || value === null) {
+                            this.recordMiss();
+                            result[key] = null;
+                        }
+                        else {
                             this.recordHit();
                             try {
-                                result[key] = this.deserialize(data[fullKey]);
+                                if (typeof value === 'string') {
+                                    result[key] = this.deserialize(value);
+                                }
+                                else if (Buffer.isBuffer(value)) {
+                                    result[key] = this.deserialize(value.toString());
+                                }
+                                else {
+                                    // Unknown, treat as miss
+                                    this.recordMiss();
+                                    result[key] = null;
+                                }
                             }
                             catch (parseErr) {
                                 reject(parseErr);
                             }
                         }
-                        else {
-                            this.recordMiss();
-                            result[key] = null;
-                        }
                     });
                     resolve(result);
                 });

package/dist/esm/adapters/redis/RedisCache.js

@@ -156,7 +156,7 @@ export class RedisCache extends BaseCache {
             else {
                 // Clear all keys only in single-instance mode
                 const client = this.client;
-                if (client.flushDb) {
+                if (client && typeof client.flushDb === 'function') {
                     await client.flushDb();
                 }
                 else {
@@ -274,7 +274,13 @@ export class RedisCache extends BaseCache {
         try {
             await this.ensureConnected();
             // Use sendCommand which works for both single and cluster
-            await this.client.sendCommand(['PING']);
+            // `sendCommand` exists on both single and cluster clients in runtime; cast narrowly for the call
+            if (this.client && typeof this.client.sendCommand === 'function') {
+                await this.client.sendCommand(['PING']);
+            }
+            else if (this.client && typeof this.client.ping === 'function') {
+                await this.client.ping();
+            }
             return {
                 isAlive: true,
                 adapter: 'redis',

package/dist/esm/middleware/express/cacheMiddleware.js

@@ -77,10 +77,23 @@ export function cacheResponseMiddleware(cache, options) {
                 if (res.statusCode >= 200 &&
                     res.statusCode < 300 &&
                     !excludeStatusCodes.includes(res.statusCode)) {
-                    const responseData = typeof data === 'string' ? data : JSON.stringify(data);
-                    cache.set(cacheKey, responseData, ttl).catch((err) => {
-                        console.error('Failed to cache response:', err);
-                    });
+                    let responseData = null;
+                    if (typeof data === 'string') {
+                        responseData = data;
+                    }
+                    else {
+                        try {
+                            responseData = JSON.stringify(data);
+                        }
+                        catch (e) {
+                            responseData = null;
+                        }
+                    }
+                    if (responseData !== null) {
+                        cache.set(cacheKey, responseData, ttl).catch((err) => {
+                            console.error('Failed to cache response:', err);
+                        });
+                    }
                 }
                 res.set('X-Cache', 'MISS');
                 return originalSend.call(this, data);

package/dist/esm/session/SessionStore.d.ts

@@ -48,4 +48,10 @@ export declare class SessionStore {
      * Get session data and extend expiry in one operation
      */
     getAndExtend(sessionId: string, ttl?: number): Promise<SessionData | null>;
+    /**
+     * Optional close hook for graceful shutdowns.
+     * Present to allow callers to call `close()` during shutdown without
+     * requiring every store implementation to provide one.
+     */
+    close(): Promise<void>;
 }

package/dist/esm/session/SessionStore.js

@@ -146,4 +146,12 @@ export class SessionStore {
             throw new CacheError(`Failed to get and extend session "${sessionId}"`, 'SESSION_GET_EXTEND_ERROR', 'session', err);
         }
     }
+    /**
+     * Optional close hook for graceful shutdowns.
+     * Present to allow callers to call `close()` during shutdown without
+     * requiring every store implementation to provide one.
+     */
+    async close() {
+        return;
+    }
 }

package/dist/types/session/SessionStore.d.ts

@@ -48,4 +48,10 @@ export declare class SessionStore {
      * Get session data and extend expiry in one operation
      */
     getAndExtend(sessionId: string, ttl?: number): Promise<SessionData | null>;
+    /**
+     * Optional close hook for graceful shutdowns.
+     * Present to allow callers to call `close()` during shutdown without
+     * requiring every store implementation to provide one.
+     */
+    close(): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naman_deep_singh/cache",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Extensible caching layer supporting Redis, Memcache, and in-memory caches with automatic fallback, namespacing, session management, and Express middleware.",
   "type": "module",
   "main": "./dist/cjs/index.js",