clhq-cache-module 1.1.0-alpha.100

package/README.md

@@ -0,0 +1,47 @@
+# Clippy Cache Module
+
+Reusable NestJS module that wires Redis backed caching (via `cache-manager`) for all Clippy API services.
+
+## Features
+
+- Async Redis store bootstrap with automatic fallback to in-memory cache for local development.
+- Helper service with `get`, `set`, `del`, `delMany`, and `wrap` helpers.
+- Configurable through environment variables or module options.
+
+## Environment Variables
+
+| Variable | Description | Default |
+| --- | --- | --- |
+| `REDIS_HOST` | Redis endpoint hostname | `undefined` |
+| `REDIS_PORT` | Redis endpoint port | `6379` |
+| `REDIS_URL` | Full connection URL. Takes precedence over host/port | `undefined` |
+| `REDIS_USERNAME` | ACL user | `undefined` |
+| `REDIS_PASSWORD` | Auth token | `undefined` |
+| `REDIS_DB` | Database index | `0` |
+| `REDIS_TLS_ENABLED` | Enable TLS | `true` |
+| `REDIS_CACHE_TTL_SECONDS` | Default TTL for cache entries | `300` |
+| `REDIS_CACHE_MAX_ITEMS` | Max number of cache entries | `1000` |
+
+## Usage
+
+```ts
+import { RedisCacheModule, RedisCacheService } from 'clhq-cache-module';
+
+@Module({
+  imports: [RedisCacheModule.register()],
+  providers: [SampleService],
+})
+export class SampleModule {}
+
+@Injectable()
+export class SampleService {
+  constructor(private readonly cache: RedisCacheService) {}
+
+  async getValue(id: string) {
+    return this.cache.wrap(`sample:${id}`, async () => {
+      return this.repository.findById(id);
+    }, 600);
+  }
+}
+```
+

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './interfaces/redis-cache-options.interface';
+export * from './redis-cache.module';
+export * from './redis-cache.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC;AAC3D,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./interfaces/redis-cache-options.interface"), exports);
+__exportStar(require("./redis-cache.module"), exports);
+__exportStar(require("./redis-cache.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6EAA2D;AAC3D,uDAAqC;AACrC,wDAAsC","sourcesContent":["export * from './interfaces/redis-cache-options.interface';\nexport * from './redis-cache.module';\nexport * from './redis-cache.service';\n// ValkeyProxyClient removed - using in-memory cache only\n// To re-enable: uncomment and recreate valkey-proxy-client.ts\n// export * from './valkey-proxy-client';\n"]}

package/dist/interfaces/redis-cache-options.interface.d.ts

@@ -0,0 +1,33 @@
+export interface RedisCacheModuleOptions {
+    host?: string;
+    port?: number;
+    url?: string;
+    username?: string;
+    password?: string;
+    db?: number;
+    ttlMs?: number;
+    max?: number;
+    clusterNodes?: Array<{
+        host: string;
+        port?: number;
+    }>;
+    tlsEnabled?: boolean;
+    isGlobal?: boolean;
+}
+export interface InternalRedisCacheOptions extends RedisCacheModuleOptions {
+    resolvedHost?: string;
+    resolvedPort?: number;
+    resolvedUrl?: string;
+    resolvedUsername?: string;
+    resolvedPassword?: string;
+    resolvedDb?: number;
+    resolvedTtlMs?: number;
+    resolvedMax?: number;
+    resolvedTlsEnabled?: boolean;
+    resolvedIsGlobal?: boolean;
+    resolvedClusterNodes?: Array<{
+        host: string;
+        port?: number;
+    }>;
+}
+//# sourceMappingURL=redis-cache-options.interface.d.ts.map

package/dist/interfaces/redis-cache-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache-options.interface.d.ts","sourceRoot":"/","sources":["interfaces/redis-cache-options.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IAKtC,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,IAAI,CAAC,EAAE,MAAM,CAAC;IAId,GAAG,CAAC,EAAE,MAAM,CAAC;IAIb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,EAAE,CAAC,EAAE,MAAM,CAAC;IAIZ,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,GAAG,CAAC,EAAE,MAAM,CAAC;IAKb,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IAIH,UAAU,CAAC,EAAE,OAAO,CAAC;IAIrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,KAAK,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ"}

package/dist/interfaces/redis-cache-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=redis-cache-options.interface.js.map

package/dist/interfaces/redis-cache-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache-options.interface.js","sourceRoot":"/","sources":["interfaces/redis-cache-options.interface.ts"],"names":[],"mappings":"","sourcesContent":["export interface RedisCacheModuleOptions {\n  /**\n   * Hostname for the Redis endpoint.\n   * When omitted the module falls back to REDIS_HOST env variable.\n   */\n  host?: string;\n  /**\n   * Port for the Redis endpoint.\n   * Defaults to REDIS_PORT env variable or 6379.\n   */\n  port?: number;\n  /**\n   * Full connection url. Takes precedence over host/port when provided.\n   */\n  url?: string;\n  /**\n   * Optional username for Redis ACL based auth.\n   */\n  username?: string;\n  /**\n   * Optional password/token for Redis auth.\n   */\n  password?: string;\n  /**\n   * Database index to use. Defaults to 0.\n   */\n  db?: number;\n  /**\n   * TTL for cached entries in milliseconds. Defaults to 300_000 (5 minutes).\n   */\n  ttlMs?: number;\n  /**\n   * Max number of items to keep in local memory cache.\n   */\n  max?: number;\n  /**\n   * Optional Valkey/Redis cluster nodes in host[:port] format.\n   * Takes precedence over single host/port when provided.\n   */\n  clusterNodes?: Array<{\n    host: string;\n    port?: number;\n  }>;\n  /**\n   * Enable TLS when connecting to Redis.\n   */\n  tlsEnabled?: boolean;\n  /**\n   * Whether to register the CacheModule globally.\n   */\n  isGlobal?: boolean;\n}\n\nexport interface InternalRedisCacheOptions extends RedisCacheModuleOptions {\n  resolvedHost?: string;\n  resolvedPort?: number;\n  resolvedUrl?: string;\n  resolvedUsername?: string;\n  resolvedPassword?: string;\n  resolvedDb?: number;\n  resolvedTtlMs?: number;\n  resolvedMax?: number;\n  resolvedTlsEnabled?: boolean;\n  resolvedIsGlobal?: boolean;\n  resolvedClusterNodes?: Array<{\n    host: string;\n    port?: number;\n  }>;\n}\n"]}

package/dist/redis-cache.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const REDIS_CACHE_OPTIONS: unique symbol;
+//# sourceMappingURL=redis-cache.constants.d.ts.map

package/dist/redis-cache.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache.constants.d.ts","sourceRoot":"/","sources":["redis-cache.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,eAAgC,CAAC"}

package/dist/redis-cache.constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REDIS_CACHE_OPTIONS = void 0;
+exports.REDIS_CACHE_OPTIONS = Symbol('REDIS_CACHE_OPTIONS');
+//# sourceMappingURL=redis-cache.constants.js.map

package/dist/redis-cache.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache.constants.js","sourceRoot":"/","sources":["redis-cache.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC","sourcesContent":["export const REDIS_CACHE_OPTIONS = Symbol('REDIS_CACHE_OPTIONS');\n\n"]}

package/dist/redis-cache.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule } from '@nestjs/common';
+import { RedisCacheModuleOptions } from './interfaces/redis-cache-options.interface';
+export declare class RedisCacheModule {
+    static register(options?: RedisCacheModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=redis-cache.module.d.ts.map

package/dist/redis-cache.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache.module.d.ts","sourceRoot":"/","sources":["redis-cache.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAE/D,OAAO,EAEL,uBAAuB,EACxB,MAAM,4CAA4C,CAAC;AAGpD,qBAEa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAE,uBAA4B,GAAG,aAAa;CAatE"}

package/dist/redis-cache.module.js

@@ -0,0 +1,79 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var RedisCacheModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisCacheModule = void 0;
+const common_1 = require("@nestjs/common");
+const redis_cache_service_1 = require("./redis-cache.service");
+const redis_cache_constants_1 = require("./redis-cache.constants");
+let RedisCacheModule = RedisCacheModule_1 = class RedisCacheModule {
+    static register(options = {}) {
+        const resolvedOptions = resolveOptions(options);
+        const cacheOptionsProvider = {
+            provide: redis_cache_constants_1.REDIS_CACHE_OPTIONS,
+            useValue: resolvedOptions,
+        };
+        return {
+            module: RedisCacheModule_1,
+            providers: [cacheOptionsProvider, redis_cache_service_1.RedisCacheService],
+            exports: [redis_cache_service_1.RedisCacheService],
+        };
+    }
+};
+exports.RedisCacheModule = RedisCacheModule;
+exports.RedisCacheModule = RedisCacheModule = RedisCacheModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], RedisCacheModule);
+function resolveOptions(options) {
+    return {
+        ...options,
+        resolvedClusterNodes: options.clusterNodes ??
+            parseClusterNodes(process.env.VALKEY_CLUSTER_ENDPOINTS ??
+                process.env.REDIS_CLUSTER_ENDPOINTS ??
+                ''),
+        resolvedHost: options.host,
+        resolvedPort: options.port ?? 6379,
+        resolvedUrl: options.url,
+        resolvedUsername: options.username,
+        resolvedPassword: options.password,
+        resolvedDb: options.db ?? 0,
+        resolvedTtlMs: Number(options.ttlMs ?? process.env.REDIS_CACHE_TTL_MS ?? 300000),
+        resolvedMax: Number(options.max ?? process.env.REDIS_CACHE_MAX_ITEMS ?? 1000),
+        resolvedTlsEnabled: parseBoolean(options.tlsEnabled ?? process.env.REDIS_TLS_ENABLED ?? 'true'),
+        resolvedIsGlobal: options.isGlobal ?? true,
+    };
+}
+function parseBoolean(value) {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return ['true', '1', 'yes'].includes(value.toLowerCase());
+    }
+    return Boolean(value);
+}
+function parseClusterNodes(value) {
+    if (!value) {
+        return undefined;
+    }
+    const nodes = value
+        .split(',')
+        .map((token) => token.trim())
+        .filter(Boolean)
+        .map((token) => {
+        const [host, port] = token.split(':');
+        return {
+            host,
+            port: port ? Number(port) : undefined,
+        };
+    })
+        .filter((node) => node.host);
+    return nodes.length ? nodes : undefined;
+}
+//# sourceMappingURL=redis-cache.module.js.map

package/dist/redis-cache.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache.module.js","sourceRoot":"/","sources":["redis-cache.module.ts"],"names":[],"mappings":"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","sourcesContent":["import { DynamicModule, Global, Module } from '@nestjs/common';\nimport { RedisCacheService } from './redis-cache.service';\nimport {\n  InternalRedisCacheOptions,\n  RedisCacheModuleOptions,\n} from './interfaces/redis-cache-options.interface';\nimport { REDIS_CACHE_OPTIONS } from './redis-cache.constants';\n\n@Global()\n@Module({})\nexport class RedisCacheModule {\n  static register(options: RedisCacheModuleOptions = {}): DynamicModule {\n    const resolvedOptions = resolveOptions(options);\n    const cacheOptionsProvider = {\n      provide: REDIS_CACHE_OPTIONS,\n      useValue: resolvedOptions,\n    };\n\n    return {\n      module: RedisCacheModule,\n      providers: [cacheOptionsProvider, RedisCacheService],\n      exports: [RedisCacheService],\n    };\n  }\n}\n\nfunction resolveOptions(\n  options: RedisCacheModuleOptions,\n): InternalRedisCacheOptions {\n  return {\n    ...options,\n    resolvedClusterNodes:\n      options.clusterNodes ??\n      parseClusterNodes(\n        process.env.VALKEY_CLUSTER_ENDPOINTS ??\n          process.env.REDIS_CLUSTER_ENDPOINTS ??\n          '',\n      ),\n    resolvedHost: options.host,\n    resolvedPort: options.port ?? 6379,\n    resolvedUrl: options.url,\n    resolvedUsername: options.username,\n    resolvedPassword: options.password,\n    resolvedDb: options.db ?? 0,\n    resolvedTtlMs: Number(\n      options.ttlMs ?? process.env.REDIS_CACHE_TTL_MS ?? 300000,\n    ),\n    resolvedMax: Number(\n      options.max ?? process.env.REDIS_CACHE_MAX_ITEMS ?? 1000,\n    ),\n    resolvedTlsEnabled: parseBoolean(\n      options.tlsEnabled ?? process.env.REDIS_TLS_ENABLED ?? 'true',\n    ),\n    resolvedIsGlobal: options.isGlobal ?? true,\n  };\n}\n\nfunction parseBoolean(value: unknown): boolean {\n  if (typeof value === 'boolean') {\n    return value;\n  }\n  if (typeof value === 'string') {\n    return ['true', '1', 'yes'].includes(value.toLowerCase());\n  }\n  return Boolean(value);\n}\n\nfunction parseClusterNodes(\n  value?: string,\n): Array<{ host: string; port?: number }> | undefined {\n  if (!value) {\n    return undefined;\n  }\n  const nodes = value\n    .split(',')\n    .map((token) => token.trim())\n    .filter(Boolean)\n    .map((token) => {\n      const [host, port] = token.split(':');\n      return {\n        host,\n        port: port ? Number(port) : undefined,\n      };\n    })\n    .filter((node) => node.host);\n  return nodes.length ? nodes : undefined;\n}\n"]}

package/dist/redis-cache.service.d.ts

@@ -0,0 +1,28 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { InternalRedisCacheOptions } from './interfaces/redis-cache-options.interface';
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    maxSize: number;
+    hitRate: number;
+}
+export declare class RedisCacheService implements OnModuleDestroy {
+    private readonly options;
+    private readonly logger;
+    private readonly memoryCache;
+    private hits;
+    private misses;
+    constructor(options: InternalRedisCacheOptions);
+    onModuleDestroy(): Promise<void>;
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    delMany(keys: string[]): Promise<void>;
+    wrap<T>(key: string, fn: () => Promise<T>, ttlMs?: number): Promise<T>;
+    getStats(): CacheStats;
+    resetStats(): void;
+    clear(): void;
+    private enforceMemoryLimit;
+}
+//# sourceMappingURL=redis-cache.service.d.ts.map

package/dist/redis-cache.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache.service.d.ts","sourceRoot":"/","sources":["redis-cache.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAwBvF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBACa,iBAAkB,YAAW,eAAe;IAUrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAGnE,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAIA,OAAO,EAAE,yBAAyB;IAO/C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAyB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAkB5E,QAAQ,IAAI,UAAU;IActB,UAAU,IAAI,IAAI;IAQlB,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,kBAAkB;CAgC3B"}

package/dist/redis-cache.service.js

@@ -0,0 +1,123 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var RedisCacheService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisCacheService = void 0;
+const common_1 = require("@nestjs/common");
+const redis_cache_constants_1 = require("./redis-cache.constants");
+let RedisCacheService = RedisCacheService_1 = class RedisCacheService {
+    constructor(options) {
+        this.options = options;
+        this.logger = new common_1.Logger(RedisCacheService_1.name);
+        this.memoryCache = new Map();
+        this.hits = 0;
+        this.misses = 0;
+        this.logger.log(`In-memory cache initialized (max items: ${this.options.resolvedMax}, default TTL: ${this.options.resolvedTtlMs}ms)`);
+    }
+    async onModuleDestroy() {
+        this.memoryCache.clear();
+        this.logger.log('In-memory cache cleared on module destroy');
+    }
+    async get(key) {
+        const entry = this.memoryCache.get(key);
+        if (!entry) {
+            this.misses++;
+            return undefined;
+        }
+        if (entry.expiresAt && entry.expiresAt <= Date.now()) {
+            this.memoryCache.delete(key);
+            this.misses++;
+            return undefined;
+        }
+        entry.lastAccessed = Date.now();
+        this.hits++;
+        return entry.value;
+    }
+    async set(key, value, ttlMs) {
+        const ttl = ttlMs ?? this.options.resolvedTtlMs;
+        const expiresAt = ttl ? Date.now() + ttl : undefined;
+        this.memoryCache.set(key, {
+            value,
+            expiresAt,
+            lastAccessed: Date.now(),
+        });
+        this.enforceMemoryLimit();
+    }
+    async del(key) {
+        this.memoryCache.delete(key);
+    }
+    async delMany(keys) {
+        keys.forEach((key) => this.memoryCache.delete(key));
+    }
+    async wrap(key, fn, ttlMs) {
+        const cached = await this.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const value = await fn();
+        if (value !== undefined) {
+            await this.set(key, value, ttlMs);
+        }
+        else {
+            this.logger.warn(`Computed cache value for key ${key} is undefined`);
+        }
+        return value;
+    }
+    getStats() {
+        const total = this.hits + this.misses;
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            size: this.memoryCache.size,
+            maxSize: this.options.resolvedMax ?? 1000,
+            hitRate: total > 0 ? this.hits / total : 0,
+        };
+    }
+    resetStats() {
+        this.hits = 0;
+        this.misses = 0;
+    }
+    clear() {
+        this.memoryCache.clear();
+        this.logger.log('In-memory cache cleared');
+    }
+    enforceMemoryLimit() {
+        const maxSize = this.options.resolvedMax ?? 1000;
+        if (this.memoryCache.size <= maxSize) {
+            return;
+        }
+        const now = Date.now();
+        for (const [key, entry] of this.memoryCache.entries()) {
+            if (entry.expiresAt && entry.expiresAt <= now) {
+                this.memoryCache.delete(key);
+            }
+        }
+        if (this.memoryCache.size <= maxSize) {
+            return;
+        }
+        const entries = Array.from(this.memoryCache.entries());
+        entries.sort((a, b) => a[1].lastAccessed - b[1].lastAccessed);
+        const entriesToRemove = entries.slice(0, this.memoryCache.size - maxSize + 1);
+        for (const [key] of entriesToRemove) {
+            this.memoryCache.delete(key);
+        }
+    }
+};
+exports.RedisCacheService = RedisCacheService;
+exports.RedisCacheService = RedisCacheService = RedisCacheService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(redis_cache_constants_1.REDIS_CACHE_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], RedisCacheService);
+//# sourceMappingURL=redis-cache.service.js.map

package/dist/redis-cache.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache.service.js","sourceRoot":"/","sources":["redis-cache.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Inject, Injectable, Logger, OnModuleDestroy } from '@nestjs/common';\nimport { REDIS_CACHE_OPTIONS } from './redis-cache.constants';\nimport { InternalRedisCacheOptions } from './interfaces/redis-cache-options.interface';\n\n// NOTE: ioredis is kept as a dependency for potential future Redis/Valkey re-enablement\n// To re-enable Redis support:\n// 1. Uncomment the Redis imports and client code below\n// 2. Set REDIS_ENABLED=true environment variable\n// 3. Configure REDIS_HOST/VALKEY_CLUSTER_ENDPOINTS as needed\n\n// import Redis, { Cluster } from 'ioredis';\n// import { ValkeyProxyClient } from './valkey-proxy-client';\n// type RedisLikeClient = Redis | Cluster;\n\n/**\n * Cache entry with value, expiration time, and last access time for LRU eviction\n */\ntype MemoryCacheEntry = {\n  value: unknown;\n  expiresAt?: number;\n  lastAccessed: number;\n};\n\n/**\n * Cache statistics for monitoring\n */\nexport interface CacheStats {\n  hits: number;\n  misses: number;\n  size: number;\n  maxSize: number;\n  hitRate: number;\n}\n\n@Injectable()\nexport class RedisCacheService implements OnModuleDestroy {\n  private readonly logger = new Logger(RedisCacheService.name);\n  private readonly memoryCache = new Map<string, MemoryCacheEntry>();\n\n  // Cache statistics\n  private hits = 0;\n  private misses = 0;\n\n  constructor(\n    @Inject(REDIS_CACHE_OPTIONS)\n    private readonly options: InternalRedisCacheOptions,\n  ) {\n    this.logger.log(\n      `In-memory cache initialized (max items: ${this.options.resolvedMax}, default TTL: ${this.options.resolvedTtlMs}ms)`,\n    );\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    // Clear in-memory cache on module destroy\n    this.memoryCache.clear();\n    this.logger.log('In-memory cache cleared on module destroy');\n  }\n\n  /**\n   * Get a cached value by key\n   */\n  async get<T>(key: string): Promise<T | undefined> {\n    const entry = this.memoryCache.get(key);\n\n    if (!entry) {\n      this.misses++;\n      return undefined;\n    }\n\n    // Check if entry has expired\n    if (entry.expiresAt && entry.expiresAt <= Date.now()) {\n      this.memoryCache.delete(key);\n      this.misses++;\n      return undefined;\n    }\n\n    // Update last accessed time for LRU tracking\n    entry.lastAccessed = Date.now();\n    this.hits++;\n\n    return entry.value as T;\n  }\n\n  /**\n   * Set a cached value with optional TTL\n   */\n  async set<T>(key: string, value: T, ttlMs?: number): Promise<void> {\n    const ttl = ttlMs ?? this.options.resolvedTtlMs;\n    const expiresAt = ttl ? Date.now() + ttl : undefined;\n\n    this.memoryCache.set(key, {\n      value,\n      expiresAt,\n      lastAccessed: Date.now(),\n    });\n\n    this.enforceMemoryLimit();\n  }\n\n  /**\n   * Delete a cached value by key\n   */\n  async del(key: string): Promise<void> {\n    this.memoryCache.delete(key);\n  }\n\n  /**\n   * Delete multiple cached values by keys\n   */\n  async delMany(keys: string[]): Promise<void> {\n    keys.forEach((key) => this.memoryCache.delete(key));\n  }\n\n  /**\n   * Cache-aside pattern: get from cache or compute and store\n   */\n  async wrap<T>(key: string, fn: () => Promise<T>, ttlMs?: number): Promise<T> {\n    const cached = await this.get<T>(key);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const value = await fn();\n    if (value !== undefined) {\n      await this.set(key, value, ttlMs);\n    } else {\n      this.logger.warn(`Computed cache value for key ${key} is undefined`);\n    }\n    return value;\n  }\n\n  /**\n   * Get cache statistics for monitoring\n   */\n  getStats(): CacheStats {\n    const total = this.hits + this.misses;\n    return {\n      hits: this.hits,\n      misses: this.misses,\n      size: this.memoryCache.size,\n      maxSize: this.options.resolvedMax ?? 1000,\n      hitRate: total > 0 ? this.hits / total : 0,\n    };\n  }\n\n  /**\n   * Reset cache statistics\n   */\n  resetStats(): void {\n    this.hits = 0;\n    this.misses = 0;\n  }\n\n  /**\n   * Clear all cached entries\n   */\n  clear(): void {\n    this.memoryCache.clear();\n    this.logger.log('In-memory cache cleared');\n  }\n\n  /**\n   * Enforce memory limit using LRU eviction policy\n   * Removes least recently accessed entries when cache exceeds max size\n   */\n  private enforceMemoryLimit(): void {\n    const maxSize = this.options.resolvedMax ?? 1000;\n\n    if (this.memoryCache.size <= maxSize) {\n      return;\n    }\n\n    // First, remove expired entries\n    const now = Date.now();\n    for (const [key, entry] of this.memoryCache.entries()) {\n      if (entry.expiresAt && entry.expiresAt <= now) {\n        this.memoryCache.delete(key);\n      }\n    }\n\n    // If still over limit, apply LRU eviction\n    if (this.memoryCache.size <= maxSize) {\n      return;\n    }\n\n    // Find and remove least recently accessed entries\n    const entries = Array.from(this.memoryCache.entries());\n    entries.sort((a, b) => a[1].lastAccessed - b[1].lastAccessed);\n\n    const entriesToRemove = entries.slice(\n      0,\n      this.memoryCache.size - maxSize + 1,\n    );\n    for (const [key] of entriesToRemove) {\n      this.memoryCache.delete(key);\n    }\n  }\n}\n\n// =============================================================================\n// DISABLED: Redis/Valkey direct connection code\n// =============================================================================\n// To re-enable Redis support in the future:\n//\n// 1. Uncomment the imports at the top of this file:\n//    import Redis, { Cluster } from 'ioredis';\n//    import { ValkeyProxyClient } from './valkey-proxy-client';\n//\n// 2. Add these private fields to the class:\n//    private readonly redisClient?: RedisLikeClient;\n//    private readonly proxyClient?: ValkeyProxyClient;\n//\n// 3. Add Redis initialization to the constructor:\n//    if (process.env.REDIS_ENABLED === 'true') {\n//      if (process.env.VALKEY_PROXY_FUNCTION_NAME) {\n//        this.proxyClient = new ValkeyProxyClient();\n//        this.logger.log('Using Valkey Lambda Proxy');\n//      } else if (options.resolvedUrl || options.resolvedHost || options.resolvedClusterNodes?.length) {\n//        this.redisClient = this.createRedisClient(options);\n//      }\n//    }\n//\n// 4. Add Redis checks to get/set/del/delMany methods before in-memory fallback\n//\n// 5. Re-create the valkey-proxy-client.ts file if Lambda proxy is needed\n// =============================================================================\n"]}

package/dist/valkey-proxy-client.d.ts

@@ -0,0 +1,10 @@
+export declare class ValkeyProxyClient {
+    private functionName;
+    constructor();
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    delMany(keys: string[]): Promise<void>;
+    private invoke;
+}
+//# sourceMappingURL=valkey-proxy-client.d.ts.map

package/dist/valkey-proxy-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valkey-proxy-client.d.ts","sourceRoot":"/","sources":["valkey-proxy-client.ts"],"names":[],"mappings":"AAoBA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAS;;IASvB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAK3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAI9B,MAAM;CAsBrB"}

package/dist/valkey-proxy-client.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValkeyProxyClient = void 0;
+const client_lambda_1 = require("@aws-sdk/client-lambda");
+const lambdaClient = new client_lambda_1.Lambda({
+    region: process.env.CLIPPY_AWS_DEFAULT_REGION || 'ap-southeast-2',
+});
+class ValkeyProxyClient {
+    constructor() {
+        this.functionName = process.env.VALKEY_PROXY_FUNCTION_NAME;
+        if (!this.functionName) {
+            throw new Error('VALKEY_PROXY_FUNCTION_NAME environment variable not set');
+        }
+    }
+    async get(key) {
+        const response = await this.invoke({ operation: 'get', key });
+        return response.value;
+    }
+    async set(key, value, ttlMs) {
+        await this.invoke({ operation: 'set', key, value, ttlMs });
+    }
+    async del(key) {
+        await this.invoke({ operation: 'del', key });
+    }
+    async delMany(keys) {
+        await this.invoke({ operation: 'delMany', keys });
+    }
+    async invoke(payload) {
+        try {
+            const result = await lambdaClient.invoke({
+                FunctionName: this.functionName,
+                InvocationType: 'RequestResponse',
+                Payload: Buffer.from(JSON.stringify(payload)),
+            });
+            const responsePayload = JSON.parse(new TextDecoder().decode(result.Payload));
+            if (!responsePayload.success) {
+                throw new Error(`Valkey proxy error: ${responsePayload.error}`);
+            }
+            return responsePayload;
+        }
+        catch (error) {
+            console.error('Failed to invoke valkey-proxy:', error);
+            throw error;
+        }
+    }
+}
+exports.ValkeyProxyClient = ValkeyProxyClient;
+//# sourceMappingURL=valkey-proxy-client.js.map

package/dist/valkey-proxy-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valkey-proxy-client.js","sourceRoot":"/","sources":["valkey-proxy-client.ts"],"names":[],"mappings":";;;AAAA,0DAAgD;AAEhD,MAAM,YAAY,GAAG,IAAI,sBAAM,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,gBAAgB;CAClE,CAAC,CAAC;AAgBH,MAAa,iBAAiB;IAG5B;QACE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9D,OAAO,QAAQ,CAAC,KAAU,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAqB;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC;gBACvC,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,cAAc,EAAE,iBAAiB;gBACjC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;aAC9C,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAChC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CACxB,CAAC;YAEnB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,uBAAuB,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC;YAClE,CAAC;YAED,OAAO,eAAe,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAjDD,8CAiDC","sourcesContent":["import { Lambda } from '@aws-sdk/client-lambda';\n\nconst lambdaClient = new Lambda({\n  region: process.env.CLIPPY_AWS_DEFAULT_REGION || 'ap-southeast-2',\n});\n\ninterface CacheRequest {\n  operation: 'get' | 'set' | 'del' | 'delMany';\n  key?: string;\n  keys?: string[];\n  value?: unknown;\n  ttlMs?: number;\n}\n\ninterface CacheResponse {\n  success: boolean;\n  value?: unknown;\n  error?: string;\n}\n\nexport class ValkeyProxyClient {\n  private functionName: string;\n\n  constructor() {\n    this.functionName = process.env.VALKEY_PROXY_FUNCTION_NAME;\n    if (!this.functionName) {\n      throw new Error('VALKEY_PROXY_FUNCTION_NAME environment variable not set');\n    }\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const response = await this.invoke({ operation: 'get', key });\n    return response.value as T;\n  }\n\n  async set<T>(key: string, value: T, ttlMs?: number): Promise<void> {\n    await this.invoke({ operation: 'set', key, value, ttlMs });\n  }\n\n  async del(key: string): Promise<void> {\n    await this.invoke({ operation: 'del', key });\n  }\n\n  async delMany(keys: string[]): Promise<void> {\n    await this.invoke({ operation: 'delMany', keys });\n  }\n\n  private async invoke(payload: CacheRequest): Promise<CacheResponse> {\n    try {\n      const result = await lambdaClient.invoke({\n        FunctionName: this.functionName,\n        InvocationType: 'RequestResponse',\n        Payload: Buffer.from(JSON.stringify(payload)),\n      });\n\n      const responsePayload = JSON.parse(\n        new TextDecoder().decode(result.Payload),\n      ) as CacheResponse;\n\n      if (!responsePayload.success) {\n        throw new Error(`Valkey proxy error: ${responsePayload.error}`);\n      }\n\n      return responsePayload;\n    } catch (error) {\n      console.error('Failed to invoke valkey-proxy:', error);\n      throw error;\n    }\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "clhq-cache-module",
+  "version": "1.1.0-alpha.100",
+  "description": "Reusable Redis cache module for NestJS services in the Clippy stack.",
+  "author": "clhq",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/reacthub-pricematch/clhq-api-monorepo"
+  },
+  "registry": "https://registry.npmjs.org/",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/reacthub-pricematch/clhq-api-monorepo/issues"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "yarn exec tsc -p tsconfig.json",
+    "clean:dist": "rimraf dist",
+    "clean:all": "yarn run clean:dist",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint \"src/**/*.ts\" --fix",
+    "version:upgrade:alpha": "standard-version --prerelease alpha",
+    "release": "npm publish --tag alpha",
+    "release:alpha": "npm publish --tag alpha",
+    "release:prealpha": "",
+    "clean:build": "rimraf .build",
+    "clean:webpack": "rimraf .webpack",
+    "clean:serverless": "rimraf .serverless",
+    "sls:deploy": "sls deploy",
+    "sls:deploy:dev": "env-cmd -f ../../.env.dev sls deploy --stage dev",
+    "sls:remove:dev": "env-cmd -f ../../.env.dev sls remove --stage dev",
+    "sls:offline": "sls offline",
+    "sls:package": "sls package",
+    "sls:package2": "npm run clean:all&& npm run sls:package",
+    "sls:remove": "sls remove"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=11.0.0"
+  },
+  "dependencies": {
+    "ioredis": "^5.4.1"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.1.5",
+    "@nestjs/platform-express": "^11.1.5",
+    "class-transformer": "0.5.1",
+    "class-validator": "0.14.2",
+    "prettier": "^3.6.1",
+    "rimraf": "^6.0.1",
+    "standard-version": "^9.5.0",
+    "typescript": "^5.8.3"
+  }
+}