node-server-engine 1.10.15 → 1.11.0

package/dist/entities/Redis/Redis.js

@@ -3,168 +3,296 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.Redis = void 0;
-exports.createRedisClient = createRedisClient;
-exports.createRedisInstance = createRedisInstance;
-exports.getClient = getClient;
-exports.init = init;
-exports.redisClient = void 0;
-exports.shutdown = shutdown;
+exports.shutdown = exports.redisClient = exports.init = exports.getClient = exports.createRedisClient = exports.Redis = void 0;
 var _ioredis = require("ioredis");
 var _Redis = require("./Redis.validate");
 var _EngineError = require("../EngineError");
 var _LifecycleController = require("../LifecycleController");
 var _report = require("../../utils/report");
-let redisClient = exports.redisClient = void 0;
-
-/**
- * Factory function to create a new Redis instance (exported for testing)
- */
-function createRedisInstance(config) {
-  return new _ioredis.Redis(config);
-}
-
-/**
- * We use a proxy to extend the Redis behavior and allow initialization of the client only when needed while keeping the same interface
- */
-const Redis = exports.Redis = new Proxy(
-// Due to how we do the proxying, we are forced to ignore ts-errors, we could never create an object that respects the interface properly
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore
-{}, {
-  get: function (target, property) {
-    if (property === 'init') return init;
-    if (property === 'shutdown') return shutdown;
-    if (property === 'getClient') return getClient;
-    // Create the redis client if it does not exist
-    if (!redisClient) throw new _EngineError.EngineError({
-      message: 'Redis client was not initialized'
-    });
-    // Call the function on the redis client
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-ignore
-    return redisClient[property];
-  }
-});
-
-/**
- * Get the underlying Redis client (for advanced use cases)
- */
-function getClient() {
-  return redisClient;
-}
+const namespace = 'engine:redis';
 
 /**
- * On init create client and connect
+ * Generic Redis wrapper for caching and data storage
+ * Provides methods for initialization, connection management, and cleanup
+ * 
+ * @example
+ * ```typescript
+ * // Initialize Redis connection
+ * Redis.init();
+ * 
+ * // Use Redis client
+ * await Redis.set('key', 'value');
+ * const value = await Redis.get('key');
+ * 
+ * // Get underlying client for advanced operations
+ * const client = Redis.getClient();
+ * ```
  */
-function init() {
-  // Ignore if already initialized
-  if (redisClient) {
-    (0, _report.reportDebug)({
-      namespace: 'engine:redis',
-      message: 'Redis client already initialized'
-    });
-    return;
-  }
-  exports.redisClient = redisClient = createRedisClient();
-
-  // Setup event listeners
-  redisClient.on('connect', () => {
-    (0, _report.reportDebug)({
-      namespace: 'engine:redis',
-      message: 'Redis client connecting'
-    });
-  });
-  redisClient.on('ready', () => {
-    (0, _report.reportDebug)({
-      namespace: 'engine:redis',
-      message: 'Redis client ready'
-    });
-  });
-  redisClient.on('error', err => {
-    (0, _report.reportError)(new _EngineError.EngineError({
-      message: 'Redis client error',
-      data: {
-        error: err.message
-      }
-    }));
-  });
-  redisClient.on('close', () => {
-    (0, _report.reportDebug)({
-      namespace: 'engine:redis',
-      message: 'Redis connection closed'
-    });
-  });
-  redisClient.on('reconnecting', () => {
-    (0, _report.reportDebug)({
-      namespace: 'engine:redis',
-      message: 'Redis client reconnecting'
-    });
-  });
-  _LifecycleController.LifecycleController.register(Redis);
-}
+const Redis = exports.Redis = {
+  /** Redis client instance */
+  client: undefined,
+  /**
+   * Initialize Redis connection
+   * @param options - Redis configuration options
+   */
+  init(options = {}) {
+    // Ignore if already initialized
+    if (this.client) {
+      (0, _report.reportDebug)({
+        namespace,
+        message: 'Redis client already initialized'
+      });
+      return;
+    }
+    this.client = this.createRedisClient(options);
 
-/**
- * On shutdown close connection and clear client
- */
-async function shutdown() {
-  if (redisClient) {
-    try {
-      await redisClient.quit();
+    // Setup event listeners
+    this.client.on('connect', () => {
       (0, _report.reportDebug)({
-        namespace: 'engine:redis',
-        message: 'Redis client disconnected'
+        namespace,
+        message: 'Redis client connecting'
       });
-    } catch (error) {
+    });
+    this.client.on('ready', () => {
+      (0, _report.reportDebug)({
+        namespace,
+        message: 'Redis client ready'
+      });
+    });
+    this.client.on('error', err => {
       (0, _report.reportError)(new _EngineError.EngineError({
-        message: 'Error during Redis shutdown',
+        message: 'Redis client error',
         data: {
-          error: error.message
+          error: err.message
         }
       }));
+    });
+    this.client.on('close', () => {
+      (0, _report.reportDebug)({
+        namespace,
+        message: 'Redis connection closed'
+      });
+    });
+    this.client.on('reconnecting', () => {
+      (0, _report.reportDebug)({
+        namespace,
+        message: 'Redis client reconnecting'
+      });
+    });
+    _LifecycleController.LifecycleController.register({
+      shutdown: () => this.shutdown()
+    });
+  },
+  /**
+   * Shutdown Redis connection and cleanup
+   * @returns Promise that resolves when shutdown is complete
+   */
+  async shutdown() {
+    if (this.client) {
+      try {
+        await this.client.quit();
+        (0, _report.reportDebug)({
+          namespace,
+          message: 'Redis client disconnected'
+        });
+      } catch (error) {
+        (0, _report.reportError)(new _EngineError.EngineError({
+          message: 'Error during Redis shutdown',
+          data: {
+            error: error.message
+          }
+        }));
+      }
     }
-  }
-  exports.redisClient = redisClient = undefined;
-}
+    this.client = undefined;
+  },
+  /**
+   * Get the underlying Redis client
+   * @returns Redis client instance or undefined
+   */
+  getClient() {
+    return this.client;
+  },
+  /**
+   * Create Redis client with configuration
+   * @param options - Redis creation options
+   * @returns Redis client instance
+   * @private
+   */
+  createRedisClient(options = {}) {
+    // Check that environment variables are correctly set
+    (0, _Redis.validateRedisEnvironment)(options);
 
-/**
- * Create Redis client with enhanced configuration
- */
-function createRedisClient(options = {}) {
-  // Check that environment variables are correctly set
-  (0, _Redis.validateRedisEnvironment)(options);
+    // Throw an error if there is no host
+    if (!process.env.REDIS_HOST) {
+      throw new _EngineError.EngineError({
+        message: 'Host required to initialize Redis connection'
+      });
+    }
+    const config = {
+      port: process.env.REDIS_PORT ? parseInt(process.env.REDIS_PORT) : 6379,
+      host: process.env.REDIS_HOST,
+      username: process.env.REDIS_USERNAME,
+      password: process.env.REDIS_PASSWORD,
+      db: options.db ?? 0,
+      retryStrategy: times => {
+        const delay = Math.min(times * 50, 2000);
+        return delay;
+      },
+      reconnectOnError: err => {
+        const targetErrors = ['READONLY', 'ECONNRESET', 'ETIMEDOUT'];
+        return targetErrors.some(targetError => err.message.includes(targetError));
+      },
+      maxRetriesPerRequest: 3,
+      enableReadyCheck: options.enableReadyCheck ?? true,
+      lazyConnect: options.lazyConnect ?? process.env.NODE_ENV === 'test',
+      ...options.redis
+    };
 
-  // Throw an error if there is no host
-  if (!process.env.REDIS_HOST) throw new _EngineError.EngineError({
-    message: 'Host required to initialize Redis connection'
-  });
-  const config = {
-    port: process.env.REDIS_PORT ? parseInt(process.env.REDIS_PORT) : 6379,
-    host: process.env.REDIS_HOST,
-    username: process.env.REDIS_USERNAME,
-    password: process.env.REDIS_PASSWORD,
-    db: options.db ?? 0,
-    retryStrategy: times => {
-      const delay = Math.min(times * 50, 2000);
-      return delay;
-    },
-    reconnectOnError: err => {
-      const targetErrors = ['READONLY', 'ECONNRESET', 'ETIMEDOUT'];
-      return targetErrors.some(targetError => err.message.includes(targetError));
-    },
-    maxRetriesPerRequest: 3,
-    enableReadyCheck: options.enableReadyCheck ?? true,
-    lazyConnect: options.lazyConnect ?? process.env.NODE_ENV === 'test',
-    ...options.redis
-  };
+    // Add TLS configuration if TLS_CA is provided
+    if (process.env.TLS_CA) {
+      config.tls = {
+        ca: process.env.TLS_CA,
+        rejectUnauthorized: process.env.NODE_ENV === 'production'
+      };
+    }
+    return new _ioredis.Redis(config);
+  },
+  // Proxy common Redis methods to the client
+  async get(key) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.get(key);
+  },
+  async set(key, value, ...args) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.set(key, value, ...args);
+  },
+  async del(...keys) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.del(...keys);
+  },
+  async exists(...keys) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.exists(...keys);
+  },
+  async expire(key, seconds) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.expire(key, seconds);
+  },
+  async ttl(key) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.ttl(key);
+  },
+  async incr(key) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.incr(key);
+  },
+  async decr(key) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.decr(key);
+  },
+  async hget(key, field) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.hget(key, field);
+  },
+  async hset(key, field, value) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.hset(key, field, value);
+  },
+  async hgetall(key) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.hgetall(key);
+  },
+  async lpush(key, ...values) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.lpush(key, ...values);
+  },
+  async rpush(key, ...values) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.rpush(key, ...values);
+  },
+  async lpop(key, count) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    if (count !== undefined) {
+      return this.client.lpop(key, count);
+    }
+    return this.client.lpop(key);
+  },
+  async rpop(key, count) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    if (count !== undefined) {
+      return this.client.rpop(key, count);
+    }
+    return this.client.rpop(key);
+  },
+  async lrange(key, start, stop) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.lrange(key, start, stop);
+  },
+  async sadd(key, ...members) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.sadd(key, ...members);
+  },
+  async smembers(key) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.smembers(key);
+  },
+  async sismember(key, member) {
+    if (!this.client) throw new _EngineError.EngineError({
+      message: 'Redis client was not initialized'
+    });
+    return this.client.sismember(key, member);
+  }
+};
 
-  // Add TLS configuration if TLS_CA is provided
-  if (process.env.TLS_CA) {
-    config.tls = {
-      ca: process.env.TLS_CA,
-      rejectUnauthorized: process.env.NODE_ENV === 'production'
-    };
+// Export backward compatibility functions
+const createRedisClient = exports.createRedisClient = Redis.createRedisClient.bind(Redis);
+const getClient = exports.getClient = Redis.getClient.bind(Redis);
+const init = exports.init = Redis.init.bind(Redis);
+const shutdown = exports.shutdown = Redis.shutdown.bind(Redis);
+
+// For tests that need direct access to the client
+let redisClient = exports.redisClient = void 0;
+Object.defineProperty(Redis, 'client', {
+  get: () => redisClient,
+  set: value => {
+    exports.redisClient = redisClient = value;
   }
-  return createRedisInstance(config);
-}
+});
 //# sourceMappingURL=Redis.js.map

package/dist/entities/Redis/Redis.js.map

@@ -1 +1 @@
-{"version":3,"file":"Redis.js","names":["_ioredis","require","_Redis","_EngineError","_LifecycleController","_report","redisClient","exports","createRedisInstance","config","RedisClient","Redis","Proxy","get","target","property","init","shutdown","getClient","EngineError","message","reportDebug","namespace","createRedisClient","on","err","reportError","data","error","LifecycleController","register","quit","undefined","options","validateRedisEnvironment","process","env","REDIS_HOST","port","REDIS_PORT","parseInt","host","username","REDIS_USERNAME","password","REDIS_PASSWORD","db","retryStrategy","times","delay","Math","min","reconnectOnError","targetErrors","some","targetError","includes","maxRetriesPerRequest","enableReadyCheck","lazyConnect","NODE_ENV","redis","TLS_CA","tls","ca","rejectUnauthorized"],"sources":["../../../src/entities/Redis/Redis.ts"],"sourcesContent":["import { Redis as RedisClient, RedisOptions } from 'ioredis';\nimport { RedisInterface, RedisCreateOptions } from './Redis.types';\nimport { validateRedisEnvironment } from './Redis.validate';\nimport { EngineError } from 'entities/EngineError';\nimport { LifecycleController } from 'entities/LifecycleController';\nimport { reportDebug, reportError } from 'utils/report';\n\nexport let redisClient: undefined | RedisClient;\n\n/**\n * Factory function to create a new Redis instance (exported for testing)\n */\nexport function createRedisInstance(config: RedisOptions): RedisClient {\n  return new RedisClient(config);\n}\n\n/**\n * We use a proxy to extend the Redis behavior and allow initialization of the client only when needed while keeping the same interface\n */\nexport const Redis = new Proxy<RedisInterface>(\n  // Due to how we do the proxying, we are forced to ignore ts-errors, we could never create an object that respects the interface properly\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore\n  {},\n  {\n    get: function (target, property): unknown {\n      if (property === 'init') return init;\n      if (property === 'shutdown') return shutdown;\n      if (property === 'getClient') return getClient;\n      // Create the redis client if it does not exist\n      if (!redisClient)\n        throw new EngineError({ message: 'Redis client was not initialized' });\n      // Call the function on the redis client\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore\n      return redisClient[property] as unknown;\n    }\n  }\n);\n\n/**\n * Get the underlying Redis client (for advanced use cases)\n */\nexport function getClient(): RedisClient | undefined {\n  return redisClient;\n}\n\n/**\n * On init create client and connect\n */\nexport function init(): void {\n  // Ignore if already initialized\n  if (redisClient) {\n    reportDebug({\n      namespace: 'engine:redis',\n      message: 'Redis client already initialized'\n    });\n    return;\n  }\n  \n  redisClient = createRedisClient();\n  \n  // Setup event listeners\n  redisClient.on('connect', () => {\n    reportDebug({\n      namespace: 'engine:redis',\n      message: 'Redis client connecting'\n    });\n  });\n  \n  redisClient.on('ready', () => {\n    reportDebug({\n      namespace: 'engine:redis',\n      message: 'Redis client ready'\n    });\n  });\n  \n  redisClient.on('error', (err) => {\n    reportError(new EngineError({\n      message: 'Redis client error',\n      data: { error: err.message }\n    }));\n  });\n  \n  redisClient.on('close', () => {\n    reportDebug({\n      namespace: 'engine:redis',\n      message: 'Redis connection closed'\n    });\n  });\n  \n  redisClient.on('reconnecting', () => {\n    reportDebug({\n      namespace: 'engine:redis',\n      message: 'Redis client reconnecting'\n    });\n  });\n  \n  LifecycleController.register(Redis);\n}\n\n/**\n * On shutdown close connection and clear client\n */\nexport async function shutdown(): Promise<void> {\n  if (redisClient) {\n    try {\n      await redisClient.quit();\n      reportDebug({\n        namespace: 'engine:redis',\n        message: 'Redis client disconnected'\n      });\n    } catch (error) {\n      reportError(new EngineError({\n        message: 'Error during Redis shutdown',\n        data: { error: (error as Error).message }\n      }));\n    }\n  }\n  redisClient = undefined;\n}\n\n/**\n * Create Redis client with enhanced configuration\n */\nexport function createRedisClient(\n  options: RedisCreateOptions = {}\n): RedisClient {\n  // Check that environment variables are correctly set\n  validateRedisEnvironment(options);\n  \n  // Throw an error if there is no host\n  if (!process.env.REDIS_HOST)\n    throw new EngineError({\n      message: 'Host required to initialize Redis connection'\n    });\n\n  const config: RedisOptions = {\n    port: process.env.REDIS_PORT ? parseInt(process.env.REDIS_PORT) : 6379,\n    host: process.env.REDIS_HOST,\n    username: process.env.REDIS_USERNAME,\n    password: process.env.REDIS_PASSWORD,\n    db: options.db ?? 0,\n    retryStrategy: (times: number) => {\n      const delay = Math.min(times * 50, 2000);\n      return delay;\n    },\n    reconnectOnError: (err: Error) => {\n      const targetErrors = ['READONLY', 'ECONNRESET', 'ETIMEDOUT'];\n      return targetErrors.some(targetError => err.message.includes(targetError));\n    },\n    maxRetriesPerRequest: 3,\n    enableReadyCheck: options.enableReadyCheck ?? true,\n    lazyConnect: options.lazyConnect ?? (process.env.NODE_ENV === 'test'),\n    ...options.redis\n  };\n\n  // Add TLS configuration if TLS_CA is provided\n  if (process.env.TLS_CA) {\n    config.tls = {\n      ca: process.env.TLS_CA,\n      rejectUnauthorized: process.env.NODE_ENV === 'production'\n    };\n  }\n\n  return createRedisInstance(config);\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Redis.js","names":["_ioredis","require","_Redis","_EngineError","_LifecycleController","_report","namespace","Redis","exports","client","undefined","init","options","reportDebug","message","createRedisClient","on","err","reportError","EngineError","data","error","LifecycleController","register","shutdown","quit","getClient","validateRedisEnvironment","process","env","REDIS_HOST","config","port","REDIS_PORT","parseInt","host","username","REDIS_USERNAME","password","REDIS_PASSWORD","db","retryStrategy","times","delay","Math","min","reconnectOnError","targetErrors","some","targetError","includes","maxRetriesPerRequest","enableReadyCheck","lazyConnect","NODE_ENV","redis","TLS_CA","tls","ca","rejectUnauthorized","RedisClient","get","key","set","value","args","del","keys","exists","expire","seconds","ttl","incr","decr","hget","field","hset","hgetall","lpush","values","rpush","lpop","count","rpop","lrange","start","stop","sadd","members","smembers","sismember","member","bind","redisClient","Object","defineProperty"],"sources":["../../../src/entities/Redis/Redis.ts"],"sourcesContent":["import { Redis as RedisClient, RedisOptions } from 'ioredis';\nimport { RedisCreateOptions } from './Redis.types';\nimport { validateRedisEnvironment } from './Redis.validate';\nimport { EngineError } from 'entities/EngineError';\nimport { LifecycleController } from 'entities/LifecycleController';\nimport { reportDebug, reportError } from 'utils/report';\n\nconst namespace = 'engine:redis';\n\n/**\n * Generic Redis wrapper for caching and data storage\n * Provides methods for initialization, connection management, and cleanup\n * \n * @example\n * ```typescript\n * // Initialize Redis connection\n * Redis.init();\n * \n * // Use Redis client\n * await Redis.set('key', 'value');\n * const value = await Redis.get('key');\n * \n * // Get underlying client for advanced operations\n * const client = Redis.getClient();\n * ```\n */\nexport const Redis = {\n  /** Redis client instance */\n  client: undefined as RedisClient | undefined,\n\n  /**\n   * Initialize Redis connection\n   * @param options - Redis configuration options\n   */\n  init(options: RedisCreateOptions = {}): void {\n    // Ignore if already initialized\n    if (this.client) {\n      reportDebug({\n        namespace,\n        message: 'Redis client already initialized'\n      });\n      return;\n    }\n    \n    this.client = this.createRedisClient(options);\n    \n    // Setup event listeners\n    this.client.on('connect', () => {\n      reportDebug({\n        namespace,\n        message: 'Redis client connecting'\n      });\n    });\n    \n    this.client.on('ready', () => {\n      reportDebug({\n        namespace,\n        message: 'Redis client ready'\n      });\n    });\n    \n    this.client.on('error', (err) => {\n      reportError(new EngineError({\n        message: 'Redis client error',\n        data: { error: err.message }\n      }));\n    });\n    \n    this.client.on('close', () => {\n      reportDebug({\n        namespace,\n        message: 'Redis connection closed'\n      });\n    });\n    \n    this.client.on('reconnecting', () => {\n      reportDebug({\n        namespace,\n        message: 'Redis client reconnecting'\n      });\n    });\n    \n    LifecycleController.register({ shutdown: () => this.shutdown() });\n  },\n\n  /**\n   * Shutdown Redis connection and cleanup\n   * @returns Promise that resolves when shutdown is complete\n   */\n  async shutdown(): Promise<void> {\n    if (this.client) {\n      try {\n        await this.client.quit();\n        reportDebug({\n          namespace,\n          message: 'Redis client disconnected'\n        });\n      } catch (error) {\n        reportError(new EngineError({\n          message: 'Error during Redis shutdown',\n          data: { error: (error as Error).message }\n        }));\n      }\n    }\n    this.client = undefined;\n  },\n\n  /**\n   * Get the underlying Redis client\n   * @returns Redis client instance or undefined\n   */\n  getClient(): RedisClient | undefined {\n    return this.client;\n  },\n\n  /**\n   * Create Redis client with configuration\n   * @param options - Redis creation options\n   * @returns Redis client instance\n   * @private\n   */\n  createRedisClient(options: RedisCreateOptions = {}): RedisClient {\n    // Check that environment variables are correctly set\n    validateRedisEnvironment(options);\n    \n    // Throw an error if there is no host\n    if (!process.env.REDIS_HOST) {\n      throw new EngineError({\n        message: 'Host required to initialize Redis connection'\n      });\n    }\n\n    const config: RedisOptions = {\n      port: process.env.REDIS_PORT ? parseInt(process.env.REDIS_PORT) : 6379,\n      host: process.env.REDIS_HOST,\n      username: process.env.REDIS_USERNAME,\n      password: process.env.REDIS_PASSWORD,\n      db: options.db ?? 0,\n      retryStrategy: (times: number) => {\n        const delay = Math.min(times * 50, 2000);\n        return delay;\n      },\n      reconnectOnError: (err: Error) => {\n        const targetErrors = ['READONLY', 'ECONNRESET', 'ETIMEDOUT'];\n        return targetErrors.some(targetError => err.message.includes(targetError));\n      },\n      maxRetriesPerRequest: 3,\n      enableReadyCheck: options.enableReadyCheck ?? true,\n      lazyConnect: options.lazyConnect ?? (process.env.NODE_ENV === 'test'),\n      ...options.redis\n    };\n\n    // Add TLS configuration if TLS_CA is provided\n    if (process.env.TLS_CA) {\n      config.tls = {\n        ca: process.env.TLS_CA,\n        rejectUnauthorized: process.env.NODE_ENV === 'production'\n      };\n    }\n\n    return new RedisClient(config);\n  },\n\n  // Proxy common Redis methods to the client\n  async get(key: string): Promise<string | null> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.get(key);\n  },\n\n  async set(key: string, value: string | number | Buffer, ...args: unknown[]): Promise<'OK' | null> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.set(key, value, ...args as []);\n  },\n\n  async del(...keys: string[]): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.del(...keys);\n  },\n\n  async exists(...keys: string[]): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.exists(...keys);\n  },\n\n  async expire(key: string, seconds: number): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.expire(key, seconds);\n  },\n\n  async ttl(key: string): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.ttl(key);\n  },\n\n  async incr(key: string): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.incr(key);\n  },\n\n  async decr(key: string): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.decr(key);\n  },\n\n  async hget(key: string, field: string): Promise<string | null> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.hget(key, field);\n  },\n\n  async hset(key: string, field: string, value: string | number | Buffer): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.hset(key, field, value);\n  },\n\n  async hgetall(key: string): Promise<Record<string, string>> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.hgetall(key);\n  },\n\n  async lpush(key: string, ...values: (string | Buffer | number)[]): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.lpush(key, ...values);\n  },\n\n  async rpush(key: string, ...values: (string | Buffer | number)[]): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.rpush(key, ...values);\n  },\n\n  async lpop(key: string, count?: number): Promise<string | string[] | null> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    if (count !== undefined) {\n      return this.client.lpop(key, count);\n    }\n    return this.client.lpop(key);\n  },\n\n  async rpop(key: string, count?: number): Promise<string | string[] | null> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    if (count !== undefined) {\n      return this.client.rpop(key, count);\n    }\n    return this.client.rpop(key);\n  },\n\n  async lrange(key: string, start: number, stop: number): Promise<string[]> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.lrange(key, start, stop);\n  },\n\n  async sadd(key: string, ...members: (string | Buffer | number)[]): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.sadd(key, ...members);\n  },\n\n  async smembers(key: string): Promise<string[]> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.smembers(key);\n  },\n\n  async sismember(key: string, member: string | Buffer | number): Promise<number> {\n    if (!this.client) throw new EngineError({ message: 'Redis client was not initialized' });\n    return this.client.sismember(key, member);\n  }\n};\n\n// Export backward compatibility functions\nexport const createRedisClient = Redis.createRedisClient.bind(Redis);\nexport const getClient = Redis.getClient.bind(Redis);\nexport const init = Redis.init.bind(Redis);\nexport const shutdown = Redis.shutdown.bind(Redis);\n\n// For tests that need direct access to the client\nexport let redisClient: RedisClient | undefined;\nObject.defineProperty(Redis, 'client', {\n  get: () => redisClient,\n  set: (value) => { redisClient = value; }\n});\n"],"mappings":"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","ignoreList":[]}

package/dist/entities/Redis/index.d.ts

@@ -1,2 +1,2 @@
-export { Redis, createRedisClient, getClient, init, shutdown } from './Redis';
+export * from './Redis';
 export * from './Redis.types';

package/dist/entities/Redis/index.js

@@ -3,48 +3,20 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _exportNames = {
-  Redis: true,
-  createRedisClient: true,
-  getClient: true,
-  init: true,
-  shutdown: true
-};
-Object.defineProperty(exports, "Redis", {
-  enumerable: true,
-  get: function () {
-    return _Redis.Redis;
-  }
-});
-Object.defineProperty(exports, "createRedisClient", {
-  enumerable: true,
-  get: function () {
-    return _Redis.createRedisClient;
-  }
-});
-Object.defineProperty(exports, "getClient", {
-  enumerable: true,
-  get: function () {
-    return _Redis.getClient;
-  }
-});
-Object.defineProperty(exports, "init", {
-  enumerable: true,
-  get: function () {
-    return _Redis.init;
-  }
-});
-Object.defineProperty(exports, "shutdown", {
-  enumerable: true,
-  get: function () {
-    return _Redis.shutdown;
-  }
-});
 var _Redis = require("./Redis");
+Object.keys(_Redis).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _Redis[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _Redis[key];
+    }
+  });
+});
 var _Redis2 = require("./Redis.types");
 Object.keys(_Redis2).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _Redis2[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,

package/dist/entities/Redis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_Redis","require","_Redis2","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get"],"sources":["../../../src/entities/Redis/index.ts"],"sourcesContent":["export { Redis, createRedisClient, getClient, init, shutdown } from './Redis';\nexport * from './Redis.types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AAAAE,MAAA,CAAAC,IAAA,CAAAF,OAAA,EAAAG,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAJ,OAAA,CAAAI,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAZ,OAAA,CAAAI,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"index.js","names":["_Redis","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_Redis2"],"sources":["../../../src/entities/Redis/index.ts"],"sourcesContent":["export * from './Redis';\nexport * from './Redis.types';\n"],"mappings":";;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,MAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,MAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,MAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,OAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,OAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,OAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,OAAA,CAAAL,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/dist/entities/SecretManager/SecretManager.d.ts

@@ -0,0 +1,87 @@
+import { SecretManagerServiceClient } from '@google-cloud/secret-manager';
+import { SecretManagerOptions, SecretConfig, LoadedSecret, SecretLoadResult } from './SecretManager.types';
+/**
+ * Generic GCP Secret Manager wrapper for managing application secrets
+ * Provides methods for loading secrets at startup, runtime fetching, and cleanup
+ *
+ * @example
+ * ```typescript
+ * // Initialize with configuration
+ * await SecretManager.init({
+ *   enabled: true,
+ *   projectId: 'my-project',
+ *   prefix: 'my-service',
+ *   secrets: ['DB_PASSWORD', { name: 'PRIVATE_KEY', type: 'file' }]
+ * });
+ *
+ * // Get a cached secret
+ * const password = SecretManager.getSecret('DB_PASSWORD');
+ *
+ * // Fetch a secret on-demand
+ * const apiKey = await SecretManager.fetchSecret('API_KEY');
+ * ```
+ */
+export declare const SecretManager: {
+    /** Singleton client instance */
+    client: SecretManagerServiceClient | undefined;
+    /** Configuration options */
+    options: SecretManagerOptions | undefined;
+    /** Cache of loaded secrets */
+    secretCache: Map<string, LoadedSecret>;
+    /** Temporary files created by Secret Manager */
+    tempFiles: string[];
+    /**
+     * Initialize the Secret Manager
+     * @param config - Secret Manager configuration options
+     * @returns Promise with load results
+     */
+    init(config?: SecretManagerOptions): Promise<SecretLoadResult>;
+    /**
+     * Load secrets from Secret Manager
+     * @private
+     */
+    loadSecrets(config: SecretManagerOptions): Promise<SecretLoadResult>;
+    /**
+     * Load a single secret from Secret Manager
+     * @private
+     */
+    loadSecret(config: SecretConfig, globalConfig: SecretManagerOptions): Promise<LoadedSecret | null>;
+    /**
+     * Normalize secret configuration
+     * @private
+     */
+    normalizeSecretConfig(input: SecretConfig | string): SecretConfig;
+    /**
+     * Get a secret value from cache (if caching is enabled)
+     * @param name - Secret name
+     * @returns Secret value or undefined
+     */
+    getSecret(name: string): string | undefined;
+    /**
+     * Get secret from Secret Manager on-demand (useful for runtime secret rotation)
+     * @param name - Secret name
+     * @param version - Secret version (default: 'latest')
+     * @returns Promise with secret value
+     */
+    fetchSecret(name: string, version?: string): Promise<string>;
+    /**
+     * Reload all secrets (useful for secret rotation)
+     * @returns Promise with reload results
+     */
+    reload(): Promise<SecretLoadResult>;
+    /**
+     * Shutdown Secret Manager and cleanup
+     * @returns Promise that resolves when cleanup is complete
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Check if Secret Manager is initialized
+     * @returns True if initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get current configuration (without sensitive data)
+     * @returns Configuration object or undefined
+     */
+    getConfig(): Partial<SecretManagerOptions> | undefined;
+};