@vritti/api-sdk 0.2.9 → 0.3.1

package/dist/cache.cjs

@@ -0,0 +1,252 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cache/index.ts
+var cache_exports = {};
+__export(cache_exports, {
+  CACHE_PROVIDER: () => CACHE_PROVIDER,
+  CacheModule: () => CacheModule,
+  CacheService: () => CacheService,
+  RedisCacheProvider: () => RedisCacheProvider
+});
+module.exports = __toCommonJS(cache_exports);
+
+// src/cache/cache.module.ts
+var import_common3 = require("@nestjs/common");
+var import_config2 = require("@nestjs/config");
+
+// src/cache/cache.service.ts
+var import_common = require("@nestjs/common");
+
+// src/cache/constants.ts
+var CACHE_PROVIDER = Symbol("CACHE_PROVIDER");
+
+// src/cache/cache.service.ts
+function _ts_decorate(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_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+function _ts_param(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param, "_ts_param");
+var CacheService = class _CacheService {
+  static {
+    __name(this, "CacheService");
+  }
+  provider;
+  logger = new import_common.Logger(_CacheService.name);
+  constructor(provider) {
+    this.provider = provider;
+  }
+  // Stores a value with mandatory TTL — errors are logged and swallowed so DB writes still succeed
+  async set(key, value, ttlSeconds) {
+    try {
+      await this.provider.set(key, value, ttlSeconds);
+    } catch (err) {
+      this.logger.error(`Cache set failed for key "${key}"`, err);
+    }
+  }
+  // Returns cached value or null on miss or any Redis error — callers fall back to DB
+  async get(key) {
+    try {
+      return await this.provider.get(key);
+    } catch (err) {
+      this.logger.error(`Cache get failed for key "${key}"`, err);
+      return null;
+    }
+  }
+  // Deletes one or more keys — errors are logged and swallowed
+  async del(...keys) {
+    try {
+      await this.provider.del(...keys);
+    } catch (err) {
+      this.logger.error(`Cache del failed for keys "${keys.join(", ")}"`, err);
+    }
+  }
+  // Returns all keys matching a glob pattern — returns empty array on error
+  async scanKeys(pattern) {
+    try {
+      return await this.provider.scanKeys(pattern);
+    } catch (err) {
+      this.logger.error(`Cache scanKeys failed for pattern "${pattern}"`, err);
+      return [];
+    }
+  }
+  // Returns raw memory info from the provider — returns empty string on error
+  async getMemoryInfo() {
+    try {
+      return await this.provider.getMemoryInfo();
+    } catch (err) {
+      this.logger.error("Cache getMemoryInfo failed", err);
+      return "";
+    }
+  }
+};
+CacheService = _ts_decorate([
+  (0, import_common.Injectable)(),
+  _ts_param(0, (0, import_common.Inject)(CACHE_PROVIDER)),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof ICacheProvider === "undefined" ? Object : ICacheProvider
+  ])
+], CacheService);
+
+// src/cache/providers/redis.provider.ts
+var import_common2 = require("@nestjs/common");
+var import_config = require("@nestjs/config");
+var import_ioredis = __toESM(require("ioredis"), 1);
+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);
+  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_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+var RedisCacheProvider = class _RedisCacheProvider {
+  static {
+    __name(this, "RedisCacheProvider");
+  }
+  configService;
+  logger = new import_common2.Logger(_RedisCacheProvider.name);
+  client;
+  constructor(configService) {
+    this.configService = configService;
+  }
+  // Creates the ioredis client and attaches connection/error listeners
+  onModuleInit() {
+    const url = this.configService.getOrThrow("REDIS_URL");
+    this.client = new import_ioredis.default(url, {
+      lazyConnect: true,
+      maxRetriesPerRequest: 3
+    });
+    this.client.on("connect", () => this.logger.log("Redis connected"));
+    this.client.on("error", (err) => this.logger.error("Redis error", err));
+  }
+  // Gracefully closes the ioredis connection on app shutdown
+  async onModuleDestroy() {
+    await this.client.quit();
+    this.logger.log("Redis disconnected");
+  }
+  // Serializes value to JSON and stores with a mandatory TTL
+  async set(key, value, ttlSeconds) {
+    const json = JSON.stringify(value);
+    await this.client.setex(key, ttlSeconds, json);
+  }
+  // Reads the stored JSON string and parses back to the original type
+  async get(key) {
+    const json = await this.client.get(key);
+    if (!json) return null;
+    return JSON.parse(json);
+  }
+  // Deletes one or more keys in a single command
+  async del(...keys) {
+    if (keys.length > 0) {
+      await this.client.del(...keys);
+    }
+  }
+  // Cursor-iterates all keys matching a glob pattern — never uses KEYS command
+  async scanKeys(pattern) {
+    const keys = [];
+    let cursor = "0";
+    do {
+      const [nextCursor, batch] = await this.client.scan(cursor, "MATCH", pattern, "COUNT", 100);
+      cursor = nextCursor;
+      keys.push(...batch);
+    } while (cursor !== "0");
+    return keys;
+  }
+  // Returns raw INFO memory output for memory monitoring
+  async getMemoryInfo() {
+    return this.client.info("memory");
+  }
+};
+RedisCacheProvider = _ts_decorate2([
+  (0, import_common2.Injectable)(),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    typeof import_config.ConfigService === "undefined" ? Object : import_config.ConfigService
+  ])
+], RedisCacheProvider);
+
+// src/cache/cache.module.ts
+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");
+var CacheModule = class {
+  static {
+    __name(this, "CacheModule");
+  }
+};
+CacheModule = _ts_decorate3([
+  (0, import_common3.Module)({
+    imports: [
+      import_config2.ConfigModule
+    ],
+    providers: [
+      RedisCacheProvider,
+      {
+        provide: CACHE_PROVIDER,
+        useExisting: RedisCacheProvider
+      },
+      CacheService
+    ],
+    exports: [
+      RedisCacheProvider,
+      CACHE_PROVIDER,
+      CacheService
+    ]
+  })
+], CacheModule);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CACHE_PROVIDER,
+  CacheModule,
+  CacheService,
+  RedisCacheProvider
+});
+//# sourceMappingURL=cache.cjs.map

package/dist/cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache/index.ts","../src/cache/cache.module.ts","../src/cache/cache.service.ts","../src/cache/constants.ts","../src/cache/providers/redis.provider.ts"],"sourcesContent":["export { CacheModule } from './cache.module';\nexport { CacheService } from './cache.service';\nexport { CACHE_PROVIDER } from './constants';\nexport type { ICacheProvider } from './interfaces/cache-provider.interface';\nexport { RedisCacheProvider } from './providers/redis.provider';\n","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":"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","names":["import_common","import_config","CACHE_PROVIDER","Symbol","CacheService","logger","Logger","name","provider","set","key","value","ttlSeconds","err","error","get","del","keys","join","scanKeys","pattern","getMemoryInfo","import_common","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"]}

package/dist/cache.d.cts

@@ -0,0 +1,25 @@
+import { I as ICacheProvider } from './cache.service-_SuJIcNA.cjs';
+export { C as CacheService } from './cache.service-_SuJIcNA.cjs';
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+
+declare class CacheModule {
+}
+
+declare const CACHE_PROVIDER: unique symbol;
+
+declare class RedisCacheProvider implements ICacheProvider, OnModuleInit, OnModuleDestroy {
+    private readonly configService;
+    private readonly logger;
+    private client;
+    constructor(configService: ConfigService);
+    onModuleInit(): void;
+    onModuleDestroy(): Promise<void>;
+    set<T>(key: string, value: T, ttlSeconds: number): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    del(...keys: string[]): Promise<void>;
+    scanKeys(pattern: string): Promise<string[]>;
+    getMemoryInfo(): Promise<string>;
+}
+
+export { CACHE_PROVIDER, CacheModule, ICacheProvider, RedisCacheProvider };

package/dist/cache.d.ts

@@ -0,0 +1,25 @@
+import { I as ICacheProvider } from './cache.service-_SuJIcNA.js';
+export { C as CacheService } from './cache.service-_SuJIcNA.js';
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+
+declare class CacheModule {
+}
+
+declare const CACHE_PROVIDER: unique symbol;
+
+declare class RedisCacheProvider implements ICacheProvider, OnModuleInit, OnModuleDestroy {
+    private readonly configService;
+    private readonly logger;
+    private client;
+    constructor(configService: ConfigService);
+    onModuleInit(): void;
+    onModuleDestroy(): Promise<void>;
+    set<T>(key: string, value: T, ttlSeconds: number): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    del(...keys: string[]): Promise<void>;
+    scanKeys(pattern: string): Promise<string[]>;
+    getMemoryInfo(): Promise<string>;
+}
+
+export { CACHE_PROVIDER, CacheModule, ICacheProvider, RedisCacheProvider };

package/dist/cache.js

@@ -0,0 +1,214 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/cache/cache.module.ts
+import { Module } from "@nestjs/common";
+import { ConfigModule } from "@nestjs/config";
+
+// src/cache/cache.service.ts
+import { Inject, Injectable, Logger } from "@nestjs/common";
+
+// src/cache/constants.ts
+var CACHE_PROVIDER = Symbol("CACHE_PROVIDER");
+
+// src/cache/cache.service.ts
+function _ts_decorate(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_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+function _ts_param(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param, "_ts_param");
+var CacheService = class _CacheService {
+  static {
+    __name(this, "CacheService");
+  }
+  provider;
+  logger = new Logger(_CacheService.name);
+  constructor(provider) {
+    this.provider = provider;
+  }
+  // Stores a value with mandatory TTL — errors are logged and swallowed so DB writes still succeed
+  async set(key, value, ttlSeconds) {
+    try {
+      await this.provider.set(key, value, ttlSeconds);
+    } catch (err) {
+      this.logger.error(`Cache set failed for key "${key}"`, err);
+    }
+  }
+  // Returns cached value or null on miss or any Redis error — callers fall back to DB
+  async get(key) {
+    try {
+      return await this.provider.get(key);
+    } catch (err) {
+      this.logger.error(`Cache get failed for key "${key}"`, err);
+      return null;
+    }
+  }
+  // Deletes one or more keys — errors are logged and swallowed
+  async del(...keys) {
+    try {
+      await this.provider.del(...keys);
+    } catch (err) {
+      this.logger.error(`Cache del failed for keys "${keys.join(", ")}"`, err);
+    }
+  }
+  // Returns all keys matching a glob pattern — returns empty array on error
+  async scanKeys(pattern) {
+    try {
+      return await this.provider.scanKeys(pattern);
+    } catch (err) {
+      this.logger.error(`Cache scanKeys failed for pattern "${pattern}"`, err);
+      return [];
+    }
+  }
+  // Returns raw memory info from the provider — returns empty string on error
+  async getMemoryInfo() {
+    try {
+      return await this.provider.getMemoryInfo();
+    } catch (err) {
+      this.logger.error("Cache getMemoryInfo failed", err);
+      return "";
+    }
+  }
+};
+CacheService = _ts_decorate([
+  Injectable(),
+  _ts_param(0, Inject(CACHE_PROVIDER)),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof ICacheProvider === "undefined" ? Object : ICacheProvider
+  ])
+], 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";
+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);
+  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_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+var RedisCacheProvider = class _RedisCacheProvider {
+  static {
+    __name(this, "RedisCacheProvider");
+  }
+  configService;
+  logger = new Logger2(_RedisCacheProvider.name);
+  client;
+  constructor(configService) {
+    this.configService = configService;
+  }
+  // Creates the ioredis client and attaches connection/error listeners
+  onModuleInit() {
+    const url = this.configService.getOrThrow("REDIS_URL");
+    this.client = new Redis(url, {
+      lazyConnect: true,
+      maxRetriesPerRequest: 3
+    });
+    this.client.on("connect", () => this.logger.log("Redis connected"));
+    this.client.on("error", (err) => this.logger.error("Redis error", err));
+  }
+  // Gracefully closes the ioredis connection on app shutdown
+  async onModuleDestroy() {
+    await this.client.quit();
+    this.logger.log("Redis disconnected");
+  }
+  // Serializes value to JSON and stores with a mandatory TTL
+  async set(key, value, ttlSeconds) {
+    const json = JSON.stringify(value);
+    await this.client.setex(key, ttlSeconds, json);
+  }
+  // Reads the stored JSON string and parses back to the original type
+  async get(key) {
+    const json = await this.client.get(key);
+    if (!json) return null;
+    return JSON.parse(json);
+  }
+  // Deletes one or more keys in a single command
+  async del(...keys) {
+    if (keys.length > 0) {
+      await this.client.del(...keys);
+    }
+  }
+  // Cursor-iterates all keys matching a glob pattern — never uses KEYS command
+  async scanKeys(pattern) {
+    const keys = [];
+    let cursor = "0";
+    do {
+      const [nextCursor, batch] = await this.client.scan(cursor, "MATCH", pattern, "COUNT", 100);
+      cursor = nextCursor;
+      keys.push(...batch);
+    } while (cursor !== "0");
+    return keys;
+  }
+  // Returns raw INFO memory output for memory monitoring
+  async getMemoryInfo() {
+    return this.client.info("memory");
+  }
+};
+RedisCacheProvider = _ts_decorate2([
+  Injectable2(),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
+    typeof ConfigService === "undefined" ? Object : ConfigService
+  ])
+], RedisCacheProvider);
+
+// src/cache/cache.module.ts
+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");
+var CacheModule = class {
+  static {
+    __name(this, "CacheModule");
+  }
+};
+CacheModule = _ts_decorate3([
+  Module({
+    imports: [
+      ConfigModule
+    ],
+    providers: [
+      RedisCacheProvider,
+      {
+        provide: CACHE_PROVIDER,
+        useExisting: RedisCacheProvider
+      },
+      CacheService
+    ],
+    exports: [
+      RedisCacheProvider,
+      CACHE_PROVIDER,
+      CacheService
+    ]
+  })
+], CacheModule);
+export {
+  CACHE_PROVIDER,
+  CacheModule,
+  CacheService,
+  RedisCacheProvider
+};
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +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":"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","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"]}

package/dist/cache.service-_SuJIcNA.d.cts

@@ -0,0 +1,20 @@
+interface ICacheProvider {
+    set<T>(key: string, value: T, ttlSeconds: number): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    del(...keys: string[]): Promise<void>;
+    scanKeys(pattern: string): Promise<string[]>;
+    getMemoryInfo(): Promise<string>;
+}
+
+declare class CacheService {
+    private readonly provider;
+    private readonly logger;
+    constructor(provider: ICacheProvider);
+    set<T>(key: string, value: T, ttlSeconds: number): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    del(...keys: string[]): Promise<void>;
+    scanKeys(pattern: string): Promise<string[]>;
+    getMemoryInfo(): Promise<string>;
+}
+
+export { CacheService as C, type ICacheProvider as I };

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

@@ -0,0 +1,20 @@
+interface ICacheProvider {
+    set<T>(key: string, value: T, ttlSeconds: number): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    del(...keys: string[]): Promise<void>;
+    scanKeys(pattern: string): Promise<string[]>;
+    getMemoryInfo(): Promise<string>;
+}
+
+declare class CacheService {
+    private readonly provider;
+    private readonly logger;
+    constructor(provider: ICacheProvider);
+    set<T>(key: string, value: T, ttlSeconds: number): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    del(...keys: string[]): Promise<void>;
+    scanKeys(pattern: string): Promise<string[]>;
+    getMemoryInfo(): Promise<string>;
+}
+
+export { CacheService as C, type ICacheProvider as I };