@naman_deep_singh/cache 1.3.2 → 1.4.0

package/dist/types/adapters/memcache/MemcacheCache.d.ts

@@ -1,71 +1,18 @@
 import { BaseCache } from '../../core/BaseCache';
 import type { HealthCheckResponse, MemcacheCacheConfig } from '../../types';
-/**
- * Memcache adapter
- */
 export declare class MemcacheCache<T = unknown> extends BaseCache<T> {
     private memcacheConfig;
     private client;
     private isConnected;
     constructor(memcacheConfig: MemcacheCacheConfig);
-    /**
-     * Connect to Memcache
-     */
     connect(): Promise<void>;
-    /**
-     * Ensure client is connected
-     */
     private ensureConnected;
-    /**
-     * Ping memcache
-     */
     private ping;
-    /**
-     * Get a value from Memcache
-     */
+    exists(key: string): Promise<boolean>;
     get(key: string): Promise<T | null>;
-    /**
-     * Set a value in Memcache
-     */
     set(key: string, value: T, ttl?: number): Promise<void>;
-    /**
-     * Delete a key from Memcache
-     */
     delete(key: string): Promise<boolean>;
-    /**
-     * Check if key exists
-     */
-    exists(key: string): Promise<boolean>;
-    /**
-     * Clear all keys (Memcache limitation: flushes entire cache)
-     */
     clear(): Promise<void>;
-    /**
-     * Get multiple values at once
-     */
-    getMultiple(keys: string[]): Promise<Record<string, T | null>>;
-    /**
-     * Set multiple values at once
-     */
-    setMultiple(data: Record<string, T>, ttl?: number): Promise<void>;
-    /**
-     * Delete multiple keys at once
-     */
-    deleteMultiple(keys: string[]): Promise<number>;
-    /**
-     * Increment a numeric value (not natively supported by Memcache in this library)
-     */
-    increment(key: string, amount?: number): Promise<number>;
-    /**
-     * Decrement a numeric value
-     */
-    decrement(key: string, amount?: number): Promise<number>;
-    /**
-     * Check if Memcache is alive
-     */
     isAlive(): Promise<HealthCheckResponse>;
-    /**
-     * Close Memcache connection
-     */
     close(): Promise<void>;
 }

package/dist/types/errors/CacheError.d.ts

@@ -1,9 +1,12 @@
-/**
- * Custom error class for cache operations
- */
-export declare class CacheError extends Error {
-    readonly code: string;
+import { AppError } from '@naman_deep_singh/errors-utils';
+import type { CacheErrorCode } from './cacheErrorCodes';
+export declare class CacheError extends AppError {
     readonly adapter?: string;
-    readonly originalError?: Error;
-    constructor(message: string, code?: string, adapter?: string, originalError?: Error);
+    readonly operation?: string;
+    constructor(code: CacheErrorCode, options?: {
+        adapter?: string;
+        operation?: string;
+        details?: unknown;
+        cause?: Error;
+    });
 }

package/dist/types/errors/cacheErrorCodes.d.ts

@@ -0,0 +1,22 @@
+export declare const CACHE_ERROR_CODES: {
+    readonly CACHE_ERROR: "Temporary caching issue, please retry";
+    readonly CACHE_CONNECTION_FAILED: "Failed to connect to the cache server";
+    readonly CACHE_UNSUPPORTED_ADAPTER: "The specified cache adapter is not supported";
+    readonly CACHE_INVALID_CONFIG: "The provided cache configuration is invalid";
+    readonly CACHE_KEY_NOT_FOUND: "The requested cache key was not found";
+    readonly CACHE_OPERATION_TIMEOUT: "The cache operation timed out";
+    readonly CACHE_SERIALIZE_ERROR: "Failed to serialize cached data";
+    readonly CACHE_DESERIALIZE_ERROR: "Failed to deserialize cached data";
+    readonly SESSION_CREATE_ERROR: "Failed to create a new session";
+    readonly SESSION_GET_ERROR: "Failed to get session data";
+    readonly SESSION_UPDATE_ERROR: "Failed to update session data";
+    readonly SESSION_DELETE_ERROR: "Failed to delete session data";
+    readonly SESSION_EXISTS_ERROR: "Failed to check session existence";
+    readonly SESSION_CLEAR_ERROR: "Failed to clear sessions";
+    readonly SESSION_GET_MULTIPLE_ERROR: "Failed to get multiple sessions";
+    readonly SESSION_DELETE_MULTIPLE_ERROR: "Failed to delete multiple sessions";
+    readonly SESSION_EXTEND_ERROR: "Failed to extend session expiry";
+    readonly SESSION_GET_EXTEND_ERROR: "Failed to get and extend session data";
+    readonly SESSION_NOT_FOUND: "Session not found";
+};
+export type CacheErrorCode = (typeof CACHE_ERROR_CODES)[keyof typeof CACHE_ERROR_CODES];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naman_deep_singh/cache",
-  "version": "1.3.2",
+  "version": "1.4.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",
@@ -29,16 +29,18 @@
   "author": "Naman Deep Singh",
   "license": "ISC",
   "devDependencies": {
-    "@types/memcached": "^2.2.7",
     "@types/express": "^5.0.5",
+    "@types/memcached": "^2.2.7",
     "@types/node": "^25.0.1",
     "express": "^5.1.0",
-    "typescript": "^5.9.3",
-    "rimraf": "^5.0.5"
+    "rimraf": "^5.0.5",
+    "typescript": "^5.9.3"
   },
   "dependencies": {
-    "redis": "^4.6.10",
-    "memcached": "^2.2.2"
+    "@naman_deep_singh/errors-utils": "^1.4.2",
+    "@naman_deep_singh/response-utils": "^2.1.4",
+    "memcached": "^2.2.2",
+    "redis": "^4.6.10"
   },
   "scripts": {
     "build": "pnpm run build:types && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json",