@vritti/api-sdk 0.3.3 → 0.3.5

package/dist/cache.js

@@ -10,6 +10,9 @@ import { Inject, Injectable, Logger } from "@nestjs/common";
 
 // src/cache/constants.ts
 var CACHE_PROVIDER = Symbol("CACHE_PROVIDER");
+var LRU_CACHE_OPTIONS = Symbol("LRU_CACHE_OPTIONS");
+var CACHE_MODULE_OPTIONS = Symbol("CACHE_MODULE_OPTIONS");
+var DEFAULT_LRU_MAX = 1e4;
 
 // src/cache/cache.service.ts
 function _ts_decorate(decorators, target, key, desc) {
@@ -91,10 +94,9 @@ CacheService = _ts_decorate([
   ])
 ], CacheService);
 
-// src/cache/providers/redis.provider.ts
-import { Injectable as Injectable2, Logger as Logger2 } from "@nestjs/common";
-import { ConfigService } from "@nestjs/config";
-import Redis from "ioredis";
+// src/cache/providers/lru.provider.ts
+import { Inject as Inject2, Injectable as Injectable2, Optional } from "@nestjs/common";
+import { LRUCache } from "lru-cache";
 function _ts_decorate2(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);
@@ -106,6 +108,81 @@ function _ts_metadata2(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 __name(_ts_metadata2, "_ts_metadata");
+function _ts_param2(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param2, "_ts_param");
+function globToRegExp(pattern) {
+  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
+  return new RegExp(`^${escaped}$`);
+}
+__name(globToRegExp, "globToRegExp");
+var LruCacheProvider = class {
+  static {
+    __name(this, "LruCacheProvider");
+  }
+  cache;
+  constructor(options) {
+    this.cache = new LRUCache({
+      max: options?.max ?? DEFAULT_LRU_MAX
+    });
+  }
+  // Stores a value with a per-key TTL (wrapped so primitives survive lru-cache's object value type)
+  async set(key, value, ttlSeconds) {
+    this.cache.set(key, {
+      value
+    }, {
+      ttl: ttlSeconds * 1e3
+    });
+  }
+  // Returns the stored value, or null on miss or expiry
+  async get(key) {
+    const entry = this.cache.get(key);
+    return entry ? entry.value : null;
+  }
+  // Deletes one or more keys
+  async del(...keys) {
+    for (const key of keys) this.cache.delete(key);
+  }
+  // Returns all live keys matching a Redis-style glob pattern
+  async scanKeys(pattern) {
+    const regex = globToRegExp(pattern);
+    return [
+      ...this.cache.keys()
+    ].filter((key) => regex.test(key));
+  }
+  // Reports entry count for monitoring utilities
+  async getMemoryInfo() {
+    return `entries:${this.cache.size} max:${this.cache.max}`;
+  }
+};
+LruCacheProvider = _ts_decorate2([
+  Injectable2(),
+  _ts_param2(0, Optional()),
+  _ts_param2(0, Inject2(LRU_CACHE_OPTIONS)),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    typeof LruCacheOptions === "undefined" ? Object : LruCacheOptions
+  ])
+], LruCacheProvider);
+
+// src/cache/providers/redis.provider.ts
+import { Injectable as Injectable3, Logger as Logger2 } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import Redis from "ioredis";
+function _ts_decorate3(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;
+}
+__name(_ts_decorate3, "_ts_decorate");
+function _ts_metadata3(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata3, "_ts_metadata");
 var RedisCacheProvider = class _RedisCacheProvider {
   static {
     __name(this, "RedisCacheProvider");
@@ -164,28 +241,113 @@ var RedisCacheProvider = class _RedisCacheProvider {
     return this.client.info("memory");
   }
 };
-RedisCacheProvider = _ts_decorate2([
-  Injectable2(),
-  _ts_metadata2("design:type", Function),
-  _ts_metadata2("design:paramtypes", [
+RedisCacheProvider = _ts_decorate3([
+  Injectable3(),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
     typeof ConfigService === "undefined" ? Object : ConfigService
   ])
 ], RedisCacheProvider);
 
 // src/cache/cache.module.ts
-function _ts_decorate3(decorators, target, key, desc) {
+function _ts_decorate4(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;
 }
-__name(_ts_decorate3, "_ts_decorate");
-var CacheModule = class {
+__name(_ts_decorate4, "_ts_decorate");
+var CacheModule = class _CacheModule {
   static {
     __name(this, "CacheModule");
   }
+  // Selects the backing provider; each import gets its own CacheService bound to the chosen driver
+  static forRoot(options = {}) {
+    if (options.driver === "lru") {
+      return {
+        module: _CacheModule,
+        providers: [
+          {
+            provide: LRU_CACHE_OPTIONS,
+            useValue: options.lru ?? {}
+          },
+          LruCacheProvider,
+          {
+            provide: CACHE_PROVIDER,
+            useExisting: LruCacheProvider
+          },
+          CacheService
+        ],
+        exports: [
+          LruCacheProvider,
+          CACHE_PROVIDER,
+          CacheService
+        ]
+      };
+    }
+    return {
+      module: _CacheModule,
+      imports: [
+        ConfigModule
+      ],
+      providers: [
+        RedisCacheProvider,
+        {
+          provide: CACHE_PROVIDER,
+          useExisting: RedisCacheProvider
+        },
+        CacheService
+      ],
+      exports: [
+        RedisCacheProvider,
+        CACHE_PROVIDER,
+        CacheService
+      ]
+    };
+  }
+  // Same driver selection as forRoot, but options (and the driver) resolve via a factory
+  static forRootAsync(options) {
+    const optionsProvider = {
+      provide: CACHE_MODULE_OPTIONS,
+      useFactory: options.useFactory,
+      inject: options.inject ?? []
+    };
+    return {
+      module: _CacheModule,
+      imports: [
+        ConfigModule,
+        ...options.imports ?? []
+      ],
+      providers: [
+        optionsProvider,
+        {
+          provide: LRU_CACHE_OPTIONS,
+          useFactory: /* @__PURE__ */ __name((opts) => opts.lru ?? {}, "useFactory"),
+          inject: [
+            CACHE_MODULE_OPTIONS
+          ]
+        },
+        LruCacheProvider,
+        RedisCacheProvider,
+        {
+          provide: CACHE_PROVIDER,
+          useFactory: /* @__PURE__ */ __name((opts, lru, redis) => opts.driver === "redis" ? redis : lru, "useFactory"),
+          inject: [
+            CACHE_MODULE_OPTIONS,
+            LruCacheProvider,
+            RedisCacheProvider
+          ]
+        },
+        CacheService
+      ],
+      exports: [
+        CACHE_PROVIDER,
+        CacheService
+      ]
+    };
+  }
 };
-CacheModule = _ts_decorate3([
+CacheModule = _ts_decorate4([
   Module({
     imports: [
       ConfigModule
@@ -209,6 +371,9 @@ export {
   CACHE_PROVIDER,
   CacheModule,
   CacheService,
+  DEFAULT_LRU_MAX,
+  LRU_CACHE_OPTIONS,
+  LruCacheProvider,
   RedisCacheProvider
 };
 //# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cache/cache.module.ts","../src/cache/cache.service.ts","../src/cache/constants.ts","../src/cache/providers/redis.provider.ts"],"sourcesContent":["import { Module } from '@nestjs/common';\nimport { ConfigModule } from '@nestjs/config';\nimport { CacheService } from './cache.service';\nimport { CACHE_PROVIDER } from './constants';\nimport { RedisCacheProvider } from './providers/redis.provider';\n\n// To add a new provider in the future:\n//   1. Create providers/memcached.provider.ts implementing ICacheProvider\n//   2. Replace RedisCacheProvider with the new class in useExisting below\n\n@Module({\n  imports: [ConfigModule],\n  providers: [\n    RedisCacheProvider,\n    {\n      provide: CACHE_PROVIDER,\n      useExisting: RedisCacheProvider,\n    },\n    CacheService,\n  ],\n  exports: [RedisCacheProvider, CACHE_PROVIDER, CacheService],\n})\nexport class CacheModule {}\n","import { Inject, Injectable, Logger } from '@nestjs/common';\nimport { CACHE_PROVIDER } from './constants';\nimport type { ICacheProvider } from './interfaces/cache-provider.interface';\n\n@Injectable()\nexport class CacheService {\n  private readonly logger = new Logger(CacheService.name);\n\n  constructor(@Inject(CACHE_PROVIDER) private readonly provider: ICacheProvider) {}\n\n  // Stores a value with mandatory TTL — errors are logged and swallowed so DB writes still succeed\n  async set<T>(key: string, value: T, ttlSeconds: number): Promise<void> {\n    try {\n      await this.provider.set(key, value, ttlSeconds);\n    } catch (err) {\n      this.logger.error(`Cache set failed for key \"${key}\"`, err);\n    }\n  }\n\n  // Returns cached value or null on miss or any Redis error — callers fall back to DB\n  async get<T>(key: string): Promise<T | null> {\n    try {\n      return await this.provider.get<T>(key);\n    } catch (err) {\n      this.logger.error(`Cache get failed for key \"${key}\"`, err);\n      return null;\n    }\n  }\n\n  // Deletes one or more keys — errors are logged and swallowed\n  async del(...keys: string[]): Promise<void> {\n    try {\n      await this.provider.del(...keys);\n    } catch (err) {\n      this.logger.error(`Cache del failed for keys \"${keys.join(', ')}\"`, err);\n    }\n  }\n\n  // Returns all keys matching a glob pattern — returns empty array on error\n  async scanKeys(pattern: string): Promise<string[]> {\n    try {\n      return await this.provider.scanKeys(pattern);\n    } catch (err) {\n      this.logger.error(`Cache scanKeys failed for pattern \"${pattern}\"`, err);\n      return [];\n    }\n  }\n\n  // Returns raw memory info from the provider — returns empty string on error\n  async getMemoryInfo(): Promise<string> {\n    try {\n      return await this.provider.getMemoryInfo();\n    } catch (err) {\n      this.logger.error('Cache getMemoryInfo failed', err);\n      return '';\n    }\n  }\n}\n","// Injection token for the active cache provider — use this to inject ICacheProvider\nexport const CACHE_PROVIDER = Symbol('CACHE_PROVIDER');\n","import { Injectable, Logger, OnModuleDestroy, OnModuleInit } from '@nestjs/common';\nimport { ConfigService } from '@nestjs/config';\nimport Redis from 'ioredis';\nimport type { ICacheProvider } from '../interfaces/cache-provider.interface';\n\n@Injectable()\nexport class RedisCacheProvider implements ICacheProvider, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(RedisCacheProvider.name);\n  private client: Redis;\n\n  constructor(private readonly configService: ConfigService) {}\n\n  // Creates the ioredis client and attaches connection/error listeners\n  onModuleInit(): void {\n    const url = this.configService.getOrThrow<string>('REDIS_URL');\n    this.client = new Redis(url, {\n      lazyConnect: true,\n      maxRetriesPerRequest: 3,\n    });\n    this.client.on('connect', () => this.logger.log('Redis connected'));\n    this.client.on('error', (err) => this.logger.error('Redis error', err));\n  }\n\n  // Gracefully closes the ioredis connection on app shutdown\n  async onModuleDestroy(): Promise<void> {\n    await this.client.quit();\n    this.logger.log('Redis disconnected');\n  }\n\n  // Serializes value to JSON and stores with a mandatory TTL\n  async set<T>(key: string, value: T, ttlSeconds: number): Promise<void> {\n    const json = JSON.stringify(value);\n    await this.client.setex(key, ttlSeconds, json);\n  }\n\n  // Reads the stored JSON string and parses back to the original type\n  async get<T>(key: string): Promise<T | null> {\n    const json = await this.client.get(key);\n    if (!json) return null;\n    return JSON.parse(json) as T;\n  }\n\n  // Deletes one or more keys in a single command\n  async del(...keys: string[]): Promise<void> {\n    if (keys.length > 0) {\n      await this.client.del(...keys);\n    }\n  }\n\n  // Cursor-iterates all keys matching a glob pattern — never uses KEYS command\n  async scanKeys(pattern: string): Promise<string[]> {\n    const keys: string[] = [];\n    let cursor = '0';\n    do {\n      const [nextCursor, batch] = await this.client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);\n      cursor = nextCursor;\n      keys.push(...batch);\n    } while (cursor !== '0');\n    return keys;\n  }\n\n  // Returns raw INFO memory output for memory monitoring\n  async getMemoryInfo(): Promise<string> {\n    return this.client.info('memory');\n  }\n}\n"],"mappings":";;;;AAAA,SAASA,cAAc;AACvB,SAASC,oBAAoB;;;ACD7B,SAASC,QAAQC,YAAYC,cAAc;;;ACCpC,IAAMC,iBAAiBC,OAAO,gBAAA;;;;;;;;;;;;;;;;;;;;ADI9B,IAAMC,eAAN,MAAMA,cAAAA;SAAAA;;;;EACMC,SAAS,IAAIC,OAAOF,cAAaG,IAAI;EAEtD,YAAqDC,UAA0B;SAA1BA,WAAAA;EAA2B;;EAGhF,MAAMC,IAAOC,KAAaC,OAAUC,YAAmC;AACrE,QAAI;AACF,YAAM,KAAKJ,SAASC,IAAIC,KAAKC,OAAOC,UAAAA;IACtC,SAASC,KAAK;AACZ,WAAKR,OAAOS,MAAM,6BAA6BJ,GAAAA,KAAQG,GAAAA;IACzD;EACF;;EAGA,MAAME,IAAOL,KAAgC;AAC3C,QAAI;AACF,aAAO,MAAM,KAAKF,SAASO,IAAOL,GAAAA;IACpC,SAASG,KAAK;AACZ,WAAKR,OAAOS,MAAM,6BAA6BJ,GAAAA,KAAQG,GAAAA;AACvD,aAAO;IACT;EACF;;EAGA,MAAMG,OAAOC,MAA+B;AAC1C,QAAI;AACF,YAAM,KAAKT,SAASQ,IAAG,GAAIC,IAAAA;IAC7B,SAASJ,KAAK;AACZ,WAAKR,OAAOS,MAAM,8BAA8BG,KAAKC,KAAK,IAAA,CAAA,KAAUL,GAAAA;IACtE;EACF;;EAGA,MAAMM,SAASC,SAAoC;AACjD,QAAI;AACF,aAAO,MAAM,KAAKZ,SAASW,SAASC,OAAAA;IACtC,SAASP,KAAK;AACZ,WAAKR,OAAOS,MAAM,sCAAsCM,OAAAA,KAAYP,GAAAA;AACpE,aAAO,CAAA;IACT;EACF;;EAGA,MAAMQ,gBAAiC;AACrC,QAAI;AACF,aAAO,MAAM,KAAKb,SAASa,cAAa;IAC1C,SAASR,KAAK;AACZ,WAAKR,OAAOS,MAAM,8BAA8BD,GAAAA;AAChD,aAAO;IACT;EACF;AACF;;;;;;;;;;;AEzDA,SAASS,cAAAA,aAAYC,UAAAA,eAA6C;AAClE,SAASC,qBAAqB;AAC9B,OAAOC,WAAW;;;;;;;;;;;;AAIX,IAAMC,qBAAN,MAAMA,oBAAAA;SAAAA;;;;EACMC,SAAS,IAAIC,QAAOF,oBAAmBG,IAAI;EACpDC;EAER,YAA6BC,eAA8B;SAA9BA,gBAAAA;EAA+B;;EAG5DC,eAAqB;AACnB,UAAMC,MAAM,KAAKF,cAAcG,WAAmB,WAAA;AAClD,SAAKJ,SAAS,IAAIK,MAAMF,KAAK;MAC3BG,aAAa;MACbC,sBAAsB;IACxB,CAAA;AACA,SAAKP,OAAOQ,GAAG,WAAW,MAAM,KAAKX,OAAOY,IAAI,iBAAA,CAAA;AAChD,SAAKT,OAAOQ,GAAG,SAAS,CAACE,QAAQ,KAAKb,OAAOc,MAAM,eAAeD,GAAAA,CAAAA;EACpE;;EAGA,MAAME,kBAAiC;AACrC,UAAM,KAAKZ,OAAOa,KAAI;AACtB,SAAKhB,OAAOY,IAAI,oBAAA;EAClB;;EAGA,MAAMK,IAAOC,KAAaC,OAAUC,YAAmC;AACrE,UAAMC,OAAOC,KAAKC,UAAUJ,KAAAA;AAC5B,UAAM,KAAKhB,OAAOqB,MAAMN,KAAKE,YAAYC,IAAAA;EAC3C;;EAGA,MAAMI,IAAOP,KAAgC;AAC3C,UAAMG,OAAO,MAAM,KAAKlB,OAAOsB,IAAIP,GAAAA;AACnC,QAAI,CAACG,KAAM,QAAO;AAClB,WAAOC,KAAKI,MAAML,IAAAA;EACpB;;EAGA,MAAMM,OAAOC,MAA+B;AAC1C,QAAIA,KAAKC,SAAS,GAAG;AACnB,YAAM,KAAK1B,OAAOwB,IAAG,GAAIC,IAAAA;IAC3B;EACF;;EAGA,MAAME,SAASC,SAAoC;AACjD,UAAMH,OAAiB,CAAA;AACvB,QAAII,SAAS;AACb,OAAG;AACD,YAAM,CAACC,YAAYC,KAAAA,IAAS,MAAM,KAAK/B,OAAOgC,KAAKH,QAAQ,SAASD,SAAS,SAAS,GAAA;AACtFC,eAASC;AACTL,WAAKQ,KAAI,GAAIF,KAAAA;IACf,SAASF,WAAW;AACpB,WAAOJ;EACT;;EAGA,MAAMS,gBAAiC;AACrC,WAAO,KAAKlC,OAAOmC,KAAK,QAAA;EAC1B;AACF;;;;;;;;;;;;;;;;;AH3CO,IAAMC,cAAN,MAAMA;SAAAA;;;AAAa;;;IAXxBC,SAAS;MAACC;;IACVC,WAAW;MACTC;MACA;QACEC,SAASC;QACTC,aAAaH;MACf;MACAI;;IAEFC,SAAS;MAACL;MAAoBE;MAAgBE;;;;","names":["Module","ConfigModule","Inject","Injectable","Logger","CACHE_PROVIDER","Symbol","CacheService","logger","Logger","name","provider","set","key","value","ttlSeconds","err","error","get","del","keys","join","scanKeys","pattern","getMemoryInfo","Injectable","Logger","ConfigService","Redis","RedisCacheProvider","logger","Logger","name","client","configService","onModuleInit","url","getOrThrow","Redis","lazyConnect","maxRetriesPerRequest","on","log","err","error","onModuleDestroy","quit","set","key","value","ttlSeconds","json","JSON","stringify","setex","get","parse","del","keys","length","scanKeys","pattern","cursor","nextCursor","batch","scan","push","getMemoryInfo","info","CacheModule","imports","ConfigModule","providers","RedisCacheProvider","provide","CACHE_PROVIDER","useExisting","CacheService","exports"]}
+{"version":3,"sources":["../src/cache/cache.module.ts","../src/cache/cache.service.ts","../src/cache/constants.ts","../src/cache/providers/lru.provider.ts","../src/cache/providers/redis.provider.ts"],"sourcesContent":["import { type DynamicModule, Module, type Provider } from '@nestjs/common';\nimport { ConfigModule } from '@nestjs/config';\nimport { CacheService } from './cache.service';\nimport { CACHE_MODULE_OPTIONS, CACHE_PROVIDER, LRU_CACHE_OPTIONS } from './constants';\nimport { type LruCacheOptions, LruCacheProvider } from './providers/lru.provider';\nimport { RedisCacheProvider } from './providers/redis.provider';\n\nexport interface CacheModuleOptions {\n  driver?: 'redis' | 'lru';\n  lru?: LruCacheOptions;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: NestJS async factory injects/imports are heterogeneous\ntype AnyList = any[];\n\nexport interface CacheModuleAsyncOptions {\n  imports?: AnyList;\n  inject?: AnyList;\n  useFactory: (...args: AnyList) => CacheModuleOptions | Promise<CacheModuleOptions>;\n}\n\n@Module({\n  imports: [ConfigModule],\n  providers: [\n    RedisCacheProvider,\n    {\n      provide: CACHE_PROVIDER,\n      useExisting: RedisCacheProvider,\n    },\n    CacheService,\n  ],\n  exports: [RedisCacheProvider, CACHE_PROVIDER, CacheService],\n})\nexport class CacheModule {\n  // Selects the backing provider; each import gets its own CacheService bound to the chosen driver\n  static forRoot(options: CacheModuleOptions = {}): DynamicModule {\n    if (options.driver === 'lru') {\n      return {\n        module: CacheModule,\n        providers: [\n          { provide: LRU_CACHE_OPTIONS, useValue: options.lru ?? {} },\n          LruCacheProvider,\n          { provide: CACHE_PROVIDER, useExisting: LruCacheProvider },\n          CacheService,\n        ],\n        exports: [LruCacheProvider, CACHE_PROVIDER, CacheService],\n      };\n    }\n    return {\n      module: CacheModule,\n      imports: [ConfigModule],\n      providers: [RedisCacheProvider, { provide: CACHE_PROVIDER, useExisting: RedisCacheProvider }, CacheService],\n      exports: [RedisCacheProvider, CACHE_PROVIDER, CacheService],\n    };\n  }\n\n  // Same driver selection as forRoot, but options (and the driver) resolve via a factory\n  static forRootAsync(options: CacheModuleAsyncOptions): DynamicModule {\n    const optionsProvider: Provider = {\n      provide: CACHE_MODULE_OPTIONS,\n      useFactory: options.useFactory,\n      inject: options.inject ?? [],\n    };\n    return {\n      module: CacheModule,\n      imports: [ConfigModule, ...(options.imports ?? [])],\n      providers: [\n        optionsProvider,\n        {\n          provide: LRU_CACHE_OPTIONS,\n          useFactory: (opts: CacheModuleOptions) => opts.lru ?? {},\n          inject: [CACHE_MODULE_OPTIONS],\n        },\n        LruCacheProvider,\n        RedisCacheProvider,\n        {\n          provide: CACHE_PROVIDER,\n          useFactory: (opts: CacheModuleOptions, lru: LruCacheProvider, redis: RedisCacheProvider) =>\n            opts.driver === 'redis' ? redis : lru,\n          inject: [CACHE_MODULE_OPTIONS, LruCacheProvider, RedisCacheProvider],\n        },\n        CacheService,\n      ],\n      exports: [CACHE_PROVIDER, CacheService],\n    };\n  }\n}\n","import { Inject, Injectable, Logger } from '@nestjs/common';\nimport { CACHE_PROVIDER } from './constants';\nimport type { ICacheProvider } from './interfaces/cache-provider.interface';\n\n@Injectable()\nexport class CacheService {\n  private readonly logger = new Logger(CacheService.name);\n\n  constructor(@Inject(CACHE_PROVIDER) private readonly provider: ICacheProvider) {}\n\n  // Stores a value with mandatory TTL — errors are logged and swallowed so DB writes still succeed\n  async set<T>(key: string, value: T, ttlSeconds: number): Promise<void> {\n    try {\n      await this.provider.set(key, value, ttlSeconds);\n    } catch (err) {\n      this.logger.error(`Cache set failed for key \"${key}\"`, err);\n    }\n  }\n\n  // Returns cached value or null on miss or any Redis error — callers fall back to DB\n  async get<T>(key: string): Promise<T | null> {\n    try {\n      return await this.provider.get<T>(key);\n    } catch (err) {\n      this.logger.error(`Cache get failed for key \"${key}\"`, err);\n      return null;\n    }\n  }\n\n  // Deletes one or more keys — errors are logged and swallowed\n  async del(...keys: string[]): Promise<void> {\n    try {\n      await this.provider.del(...keys);\n    } catch (err) {\n      this.logger.error(`Cache del failed for keys \"${keys.join(', ')}\"`, err);\n    }\n  }\n\n  // Returns all keys matching a glob pattern — returns empty array on error\n  async scanKeys(pattern: string): Promise<string[]> {\n    try {\n      return await this.provider.scanKeys(pattern);\n    } catch (err) {\n      this.logger.error(`Cache scanKeys failed for pattern \"${pattern}\"`, err);\n      return [];\n    }\n  }\n\n  // Returns raw memory info from the provider — returns empty string on error\n  async getMemoryInfo(): Promise<string> {\n    try {\n      return await this.provider.getMemoryInfo();\n    } catch (err) {\n      this.logger.error('Cache getMemoryInfo failed', err);\n      return '';\n    }\n  }\n}\n","// Injection token for the active cache provider — use this to inject ICacheProvider\nexport const CACHE_PROVIDER = Symbol('CACHE_PROVIDER');\n\n// Injection token for LruCacheProvider construction options\nexport const LRU_CACHE_OPTIONS = Symbol('LRU_CACHE_OPTIONS');\n\n// Injection token for the resolved CacheModuleOptions (used by forRootAsync)\nexport const CACHE_MODULE_OPTIONS = Symbol('CACHE_MODULE_OPTIONS');\n\n// Default entry cap for the in-memory LRU provider when no max is configured\nexport const DEFAULT_LRU_MAX = 10000;\n","import { Inject, Injectable, Optional } from '@nestjs/common';\nimport { LRUCache } from 'lru-cache';\nimport { DEFAULT_LRU_MAX, LRU_CACHE_OPTIONS } from '../constants';\nimport type { ICacheProvider } from '../interfaces/cache-provider.interface';\n\nexport interface LruCacheOptions {\n  max?: number;\n}\n\n// Escapes a Redis-style glob (only * and ? are special) into an anchored RegExp for key scanning\nfunction globToRegExp(pattern: string): RegExp {\n  const escaped = pattern\n    .replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&')\n    .replace(/\\*/g, '.*')\n    .replace(/\\?/g, '.');\n  return new RegExp(`^${escaped}$`);\n}\n\n@Injectable()\nexport class LruCacheProvider implements ICacheProvider {\n  private readonly cache: LRUCache<string, object>;\n\n  constructor(@Optional() @Inject(LRU_CACHE_OPTIONS) options?: LruCacheOptions) {\n    this.cache = new LRUCache<string, object>({ max: options?.max ?? DEFAULT_LRU_MAX });\n  }\n\n  // Stores a value with a per-key TTL (wrapped so primitives survive lru-cache's object value type)\n  async set<T>(key: string, value: T, ttlSeconds: number): Promise<void> {\n    this.cache.set(key, { value } as object, { ttl: ttlSeconds * 1000 });\n  }\n\n  // Returns the stored value, or null on miss or expiry\n  async get<T>(key: string): Promise<T | null> {\n    const entry = this.cache.get(key) as { value: T } | undefined;\n    return entry ? entry.value : null;\n  }\n\n  // Deletes one or more keys\n  async del(...keys: string[]): Promise<void> {\n    for (const key of keys) this.cache.delete(key);\n  }\n\n  // Returns all live keys matching a Redis-style glob pattern\n  async scanKeys(pattern: string): Promise<string[]> {\n    const regex = globToRegExp(pattern);\n    return [...this.cache.keys()].filter((key) => regex.test(key));\n  }\n\n  // Reports entry count for monitoring utilities\n  async getMemoryInfo(): Promise<string> {\n    return `entries:${this.cache.size} max:${this.cache.max}`;\n  }\n}\n","import { Injectable, Logger, OnModuleDestroy, OnModuleInit } from '@nestjs/common';\nimport { ConfigService } from '@nestjs/config';\nimport Redis from 'ioredis';\nimport type { ICacheProvider } from '../interfaces/cache-provider.interface';\n\n@Injectable()\nexport class RedisCacheProvider implements ICacheProvider, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(RedisCacheProvider.name);\n  private client: Redis;\n\n  constructor(private readonly configService: ConfigService) {}\n\n  // Creates the ioredis client and attaches connection/error listeners\n  onModuleInit(): void {\n    const url = this.configService.getOrThrow<string>('REDIS_URL');\n    this.client = new Redis(url, {\n      lazyConnect: true,\n      maxRetriesPerRequest: 3,\n    });\n    this.client.on('connect', () => this.logger.log('Redis connected'));\n    this.client.on('error', (err) => this.logger.error('Redis error', err));\n  }\n\n  // Gracefully closes the ioredis connection on app shutdown\n  async onModuleDestroy(): Promise<void> {\n    await this.client.quit();\n    this.logger.log('Redis disconnected');\n  }\n\n  // Serializes value to JSON and stores with a mandatory TTL\n  async set<T>(key: string, value: T, ttlSeconds: number): Promise<void> {\n    const json = JSON.stringify(value);\n    await this.client.setex(key, ttlSeconds, json);\n  }\n\n  // Reads the stored JSON string and parses back to the original type\n  async get<T>(key: string): Promise<T | null> {\n    const json = await this.client.get(key);\n    if (!json) return null;\n    return JSON.parse(json) as T;\n  }\n\n  // Deletes one or more keys in a single command\n  async del(...keys: string[]): Promise<void> {\n    if (keys.length > 0) {\n      await this.client.del(...keys);\n    }\n  }\n\n  // Cursor-iterates all keys matching a glob pattern — never uses KEYS command\n  async scanKeys(pattern: string): Promise<string[]> {\n    const keys: string[] = [];\n    let cursor = '0';\n    do {\n      const [nextCursor, batch] = await this.client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);\n      cursor = nextCursor;\n      keys.push(...batch);\n    } while (cursor !== '0');\n    return keys;\n  }\n\n  // Returns raw INFO memory output for memory monitoring\n  async getMemoryInfo(): Promise<string> {\n    return this.client.info('memory');\n  }\n}\n"],"mappings":"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","names":["Module","ConfigModule","Inject","Injectable","Logger","CACHE_PROVIDER","Symbol","LRU_CACHE_OPTIONS","CACHE_MODULE_OPTIONS","DEFAULT_LRU_MAX","CacheService","logger","Logger","name","provider","set","key","value","ttlSeconds","err","error","get","del","keys","join","scanKeys","pattern","getMemoryInfo","Inject","Injectable","Optional","LRUCache","globToRegExp","pattern","escaped","replace","RegExp","LruCacheProvider","cache","options","LRUCache","max","DEFAULT_LRU_MAX","set","key","value","ttlSeconds","ttl","get","entry","del","keys","delete","scanKeys","regex","filter","test","getMemoryInfo","size","Injectable","Logger","ConfigService","Redis","RedisCacheProvider","logger","Logger","name","client","configService","onModuleInit","url","getOrThrow","Redis","lazyConnect","maxRetriesPerRequest","on","log","err","error","onModuleDestroy","quit","set","key","value","ttlSeconds","json","JSON","stringify","setex","get","parse","del","keys","length","scanKeys","pattern","cursor","nextCursor","batch","scan","push","getMemoryInfo","info","CacheModule","forRoot","options","driver","module","providers","provide","LRU_CACHE_OPTIONS","useValue","lru","LruCacheProvider","CACHE_PROVIDER","useExisting","CacheService","exports","imports","ConfigModule","RedisCacheProvider","forRootAsync","optionsProvider","CACHE_MODULE_OPTIONS","useFactory","inject","opts","redis"]}