nestjs-redis-ui 0.1.1

package/README.md

@@ -0,0 +1,256 @@
+# redis-ui
+
+NestJS용 Redis 모듈 + 웹 UI 패키지입니다.  
+Swagger처럼 `main.ts`에서 UI를 붙이고, `RedisModule` / `RedisService`로 Redis에 접근할 수 있습니다.
+
+## 설치
+
+```bash
+npm install redis-ui ioredis
+```
+
+Peer dependency:
+
+- `@nestjs/common` >= 10
+- `@nestjs/core` >= 10
+- `ioredis` >= 5
+
+## 빠른 시작
+
+### 1. 모듈 등록
+
+```ts
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { RedisModule } from 'redis-ui';
+
+@Module({
+  imports: [
+    RedisModule.forRoot({
+      host: '127.0.0.1',
+      port: 6379,
+      // password: 'secret',
+      // db: 0,
+      // tls: true,
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### 2. UI 마운트
+
+```ts
+// main.ts
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+import { RedisService, RedisUi } from 'redis-ui';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  RedisUi.setup(app, {
+    enabled: true,
+    store: app.get(RedisService),
+    path: 'redis-ui',
+    auth: {
+      username: 'admin',
+      password: 'secret',
+    },
+  });
+
+  await app.listen(3000);
+}
+bootstrap();
+```
+
+브라우저에서 `http://localhost:3000/redis-ui` 로 접속합니다.
+
+---
+
+## RedisModule
+
+### `forRoot`
+
+동기 설정입니다.
+
+```ts
+RedisModule.forRoot({
+  host: '127.0.0.1',
+  port: 6379,
+  password: undefined,
+  db: 0,
+  keyPrefix: 'app:',
+  tls: false,
+  // ioredis 추가 옵션
+  redisOptions: {
+    connectTimeout: 10_000,
+  },
+});
+```
+
+| 옵션 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `host` | `string` | `127.0.0.1` | Redis 호스트 |
+| `port` | `number` | `6379` | Redis 포트 |
+| `password` | `string` | - | 비밀번호 |
+| `db` | `number` | `0` | DB index |
+| `keyPrefix` | `string` | - | 키 prefix |
+| `tls` | `boolean \| object` | - | TLS 사용 |
+| `redisOptions` | `RedisOptions` | - | ioredis 추가 옵션 |
+
+### `forRootAsync`
+
+환경변수 / ConfigModule과 같이 쓸 때 사용합니다.
+
+```ts
+RedisModule.forRootAsync({
+  imports: [ConfigModule],
+  inject: [ConfigService],
+  useFactory: (config: ConfigService) => ({
+    host: config.get('REDIS_HOST', '127.0.0.1'),
+    port: config.get<number>('REDIS_PORT', 6379),
+    password: config.get('REDIS_PASSWORD'),
+    tls: config.get('REDIS_TLS') === 'true',
+  }),
+});
+```
+
+---
+
+## RedisService
+
+어디서든 DI로 주입해 사용합니다. `RedisUiStore`도 구현하므로 UI에 그대로 넘길 수 있습니다.
+
+```ts
+import { Injectable } from '@nestjs/common';
+import { RedisService } from 'redis-ui';
+
+@Injectable()
+export class ExampleService {
+  constructor(private readonly redis: RedisService) {}
+
+  async demo() {
+    await this.redis.set('user:1', { name: 'kim' }, 300); // TTL 300초
+    const value = await this.redis.get<{ name: string }>('user:1');
+    const keys = await this.redis.keys('user:*');
+    const ttl = await this.redis.ttl('user:1');
+    const entry = await this.redis.getEntry('user:1');
+    await this.redis.delete('user:1');
+
+    // 필요하면 raw ioredis 클라이언트
+    const client = this.redis.getClient();
+  }
+}
+```
+
+### API
+
+| 메서드 | 설명 |
+|--------|------|
+| `get<T>(key)` | 값 조회 (JSON이면 파싱) |
+| `set(key, value, ttlSeconds?)` | 값 저장 |
+| `delete(key)` | 키 삭제 |
+| `keys(pattern?)` | SCAN 기반 키 목록 (`*` 기본) |
+| `ttl(key)` | TTL(초) |
+| `getEntry(key)` | `{ key, value, ttl, type }` |
+| `getClient()` | ioredis 인스턴스 |
+
+토큰으로 클라이언트만 주입할 수도 있습니다.
+
+```ts
+import { Inject } from '@nestjs/common';
+import { REDIS_CLIENT } from 'redis-ui';
+import type Redis from 'ioredis';
+
+constructor(@Inject(REDIS_CLIENT) private readonly client: Redis) {}
+```
+
+---
+
+## RedisUi
+
+`RedisUi.setup(app, options)` 로 Express 라우트와 정적 UI를 붙입니다.
+
+```ts
+RedisUi.setup(app, {
+  enabled: true,
+  store: app.get(RedisService),
+  path: 'redis-ui',
+  title: 'Redis UI',
+  badge: 'CACHE',
+  defaultPattern: '*',
+  allowDelete: true,
+  auth: false, // 또는 { username, password }
+});
+```
+
+| 옵션 | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| `enabled` | `boolean` | (필수) | UI 활성화 |
+| `store` | `RedisUiStore` | (필수) | 데이터 접근 구현체 |
+| `path` | `string` | `redis-ui` | URL 경로 |
+| `title` | `string` | `Redis UI` | 페이지 타이틀 |
+| `badge` | `string` | `CACHE` | 헤더 뱃지 |
+| `defaultPattern` | `string` | `*` | 초기 키 패턴 |
+| `allowDelete` | `boolean` | `true` | UI에서 삭제 허용 |
+| `auth` | `{ username, password } \| false` | `false` | Basic Auth |
+
+### 엔드포인트
+
+| Method | Path | 설명 |
+|--------|------|------|
+| `GET` | `/{path}` | UI 페이지 |
+| `GET` | `/{path}/api/keys?pattern=*` | 키 목록 |
+| `GET` | `/{path}/api/entry?key=...` | 키 상세 |
+| `DELETE` | `/{path}/api/entry?key=...` | 키 삭제 (`allowDelete: true`) |
+
+### 커스텀 Store
+
+자체 Redis 래퍼를 쓰는 경우 `RedisUiStore`만 맞추면 됩니다.
+
+```ts
+import type { RedisUiEntry, RedisUiStore } from 'redis-ui';
+
+class MyStore implements RedisUiStore {
+  async keys(pattern = '*'): Promise<string[]> { /* ... */ }
+  async getEntry(key: string): Promise<RedisUiEntry> { /* ... */ }
+  async delete(key: string): Promise<void> { /* ... */ }
+}
+
+RedisUi.setup(app, {
+  enabled: true,
+  store: new MyStore(),
+});
+```
+
+---
+
+## 로컬 개발 (이 레포)
+
+```bash
+npm install
+npm run start:dev
+```
+
+기본 접속: `http://localhost:3000/redis-ui`
+
+환경변수 예시:
+
+```env
+PORT=3000
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_PASSWORD=
+REDIS_TLS=false
+REDIS_UI_ENABLED=true
+REDIS_UI_PATH=redis-ui
+REDIS_UI_USER=admin
+REDIS_UI_PASS=secret
+```
+
+---
+
+## License
+
+MIT

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

@@ -0,0 +1,2 @@
+export declare const REDIS_MODULE_OPTIONS: unique symbol;
+export declare const REDIS_CLIENT: unique symbol;

package/dist/redis/constants/redis.constants.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis.constants.js","sourceRoot":"","sources":["../../../src/redis/constants/redis.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AACtD,QAAA,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC"}

package/dist/redis/index.d.ts

@@ -0,0 +1,6 @@
+export { REDIS_CLIENT, REDIS_MODULE_OPTIONS, } from './constants/redis.constants';
+export type { RedisModuleAsyncOptions, RedisModuleOptions, RedisOptionsFactory, RedisUiAuthOptions, RedisUiEntry, RedisUiOptions, RedisUiStore, ResolvedRedisUiOptions, } from './interfaces';
+export { RedisModule } from './redis.module';
+export { RedisService } from './services/redis.service';
+export { RedisUi } from './ui/redis-ui';
+export { REDIS_UI_DEFAULTS } from './ui/resolve-redis-ui-options';

package/dist/redis/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REDIS_UI_DEFAULTS = exports.RedisUi = exports.RedisService = exports.RedisModule = exports.REDIS_MODULE_OPTIONS = exports.REDIS_CLIENT = void 0;
+var redis_constants_1 = require("./constants/redis.constants");
+Object.defineProperty(exports, "REDIS_CLIENT", { enumerable: true, get: function () { return redis_constants_1.REDIS_CLIENT; } });
+Object.defineProperty(exports, "REDIS_MODULE_OPTIONS", { enumerable: true, get: function () { return redis_constants_1.REDIS_MODULE_OPTIONS; } });
+var redis_module_1 = require("./redis.module");
+Object.defineProperty(exports, "RedisModule", { enumerable: true, get: function () { return redis_module_1.RedisModule; } });
+var redis_service_1 = require("./services/redis.service");
+Object.defineProperty(exports, "RedisService", { enumerable: true, get: function () { return redis_service_1.RedisService; } });
+var redis_ui_1 = require("./ui/redis-ui");
+Object.defineProperty(exports, "RedisUi", { enumerable: true, get: function () { return redis_ui_1.RedisUi; } });
+var resolve_redis_ui_options_1 = require("./ui/resolve-redis-ui-options");
+Object.defineProperty(exports, "REDIS_UI_DEFAULTS", { enumerable: true, get: function () { return resolve_redis_ui_options_1.REDIS_UI_DEFAULTS; } });
+//# sourceMappingURL=index.js.map

package/dist/redis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/redis/index.ts"],"names":[],"mappings":";;;AAAA,+DAGqC;AAFnC,+GAAA,YAAY,OAAA;AACZ,uHAAA,oBAAoB,OAAA;AAYtB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,0DAAwD;AAA/C,6GAAA,YAAY,OAAA;AACrB,0CAAwC;AAA/B,mGAAA,OAAO,OAAA;AAChB,0EAAkE;AAAzD,6HAAA,iBAAiB,OAAA"}

package/dist/redis/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export type { RedisModuleAsyncOptions, RedisModuleOptions, RedisOptionsFactory, } from './redis-module-options.interface';
+export type { RedisUiAuthOptions, RedisUiOptions, ResolvedRedisUiOptions, } from './redis-ui-options.interface';
+export type { RedisUiEntry, RedisUiStore } from './redis-ui-store.interface';

package/dist/redis/interfaces/index.js

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

package/dist/redis/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/redis/interfaces/index.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,20 @@
+import type { InjectionToken, ModuleMetadata, OptionalFactoryDependency, Type } from '@nestjs/common';
+import type { ConnectionOptions } from 'tls';
+export interface RedisModuleOptions {
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    keyPrefix?: string;
+    tls?: boolean | ConnectionOptions;
+    redisOptions?: Record<string, any>;
+}
+export interface RedisOptionsFactory {
+    createRedisOptions(): Promise<RedisModuleOptions> | RedisModuleOptions;
+}
+export interface RedisModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useExisting?: Type<RedisOptionsFactory>;
+    useClass?: Type<RedisOptionsFactory>;
+    useFactory?: (...args: any[]) => Promise<RedisModuleOptions> | RedisModuleOptions;
+    inject?: Array<InjectionToken | OptionalFactoryDependency>;
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-module-options.interface.js","sourceRoot":"","sources":["../../../src/redis/interfaces/redis-module-options.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,18 @@
+import type { RedisUiStore } from './redis-ui-store.interface';
+export interface RedisUiAuthOptions {
+    username: string;
+    password: string;
+}
+export interface RedisUiOptions {
+    enabled: boolean;
+    store: RedisUiStore;
+    path?: string;
+    title?: string;
+    badge?: string;
+    defaultPattern?: string;
+    allowDelete?: boolean;
+    auth?: RedisUiAuthOptions | false;
+}
+export type ResolvedRedisUiOptions = Required<Omit<RedisUiOptions, 'auth'>> & {
+    auth: RedisUiAuthOptions | false;
+};

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-ui-options.interface.js","sourceRoot":"","sources":["../../../src/redis/interfaces/redis-ui-options.interface.ts"],"names":[],"mappings":""}

package/dist/redis/interfaces/redis-ui-store.interface.d.ts

@@ -0,0 +1,11 @@
+export type RedisUiEntry = {
+    key: string;
+    value: unknown;
+    ttl: number;
+    type: string;
+};
+export interface RedisUiStore {
+    keys(pattern?: string): Promise<string[]>;
+    getEntry(key: string): Promise<RedisUiEntry>;
+    delete(key: string): Promise<void>;
+}

package/dist/redis/interfaces/redis-ui-store.interface.js

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

package/dist/redis/interfaces/redis-ui-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-ui-store.interface.js","sourceRoot":"","sources":["../../../src/redis/interfaces/redis-ui-store.interface.ts"],"names":[],"mappings":""}

package/dist/redis/providers/redis.providers.d.ts

@@ -0,0 +1,4 @@
+import type { Provider } from '@nestjs/common';
+import type { RedisModuleAsyncOptions } from '../interfaces/redis-module-options.interface';
+export declare function createRedisClientProvider(): Provider;
+export declare function createAsyncProviders(options: RedisModuleAsyncOptions): Provider[];

package/dist/redis/providers/redis.providers.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRedisClientProvider = createRedisClientProvider;
+exports.createAsyncProviders = createAsyncProviders;
+const ioredis_1 = __importDefault(require("ioredis"));
+const redis_constants_1 = require("../constants/redis.constants");
+function createRedisClient(options) {
+    const { host = '127.0.0.1', port = 6379, password, db = 0, keyPrefix, tls, redisOptions, } = options;
+    return new ioredis_1.default({
+        host,
+        port,
+        password,
+        db,
+        keyPrefix,
+        ...(tls ? { tls: tls === true ? {} : tls } : {}),
+        ...redisOptions,
+    });
+}
+function createRedisClientProvider() {
+    return {
+        provide: redis_constants_1.REDIS_CLIENT,
+        inject: [redis_constants_1.REDIS_MODULE_OPTIONS],
+        useFactory: (options) => createRedisClient(options),
+    };
+}
+function createAsyncProviders(options) {
+    if (options.useFactory) {
+        return [
+            {
+                provide: redis_constants_1.REDIS_MODULE_OPTIONS,
+                useFactory: options.useFactory,
+                inject: options.inject ?? [],
+            },
+            createRedisClientProvider(),
+        ];
+    }
+    const injectTarget = options.useExisting ?? options.useClass;
+    if (!injectTarget) {
+        throw new Error('Invalid RedisModuleAsyncOptions: provide useFactory, useClass, or useExisting');
+    }
+    const providers = [
+        {
+            provide: redis_constants_1.REDIS_MODULE_OPTIONS,
+            useFactory: async (factory) => factory.createRedisOptions(),
+            inject: [injectTarget],
+        },
+        createRedisClientProvider(),
+    ];
+    if (options.useClass) {
+        providers.push({
+            provide: options.useClass,
+            useClass: options.useClass,
+        });
+    }
+    return providers;
+}
+//# sourceMappingURL=redis.providers.js.map

package/dist/redis/providers/redis.providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.providers.js","sourceRoot":"","sources":["../../../src/redis/providers/redis.providers.ts"],"names":[],"mappings":";;;;;AAkCA,8DAMC;AAED,oDAuCC;AAhFD,sDAA4B;AAC5B,kEAGsC;AAOtC,SAAS,iBAAiB,CAAC,OAA2B;IACpD,MAAM,EACJ,IAAI,GAAG,WAAW,EAClB,IAAI,GAAG,IAAI,EACX,QAAQ,EACR,EAAE,GAAG,CAAC,EACN,SAAS,EACT,GAAG,EACH,YAAY,GACb,GAAG,OAAO,CAAC;IAEZ,OAAO,IAAI,iBAAK,CAAC;QACf,IAAI;QACJ,IAAI;QACJ,QAAQ;QACR,EAAE;QACF,SAAS;QACT,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,YAAY;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,yBAAyB;IACvC,OAAO;QACL,OAAO,EAAE,8BAAY;QACrB,MAAM,EAAE,CAAC,sCAAoB,CAAC;QAC9B,UAAU,EAAE,CAAC,OAA2B,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAClC,OAAgC;IAEhC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO;YACL;gBACE,OAAO,EAAE,sCAAoB;gBAC7B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;aAC7B;YACD,yBAAyB,EAAE;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAC7D,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAe;QAC5B;YACE,OAAO,EAAE,sCAAoB;YAC7B,UAAU,EAAE,KAAK,EAAE,OAA4B,EAAE,EAAE,CACjD,OAAO,CAAC,kBAAkB,EAAE;YAC9B,MAAM,EAAE,CAAC,YAAY,CAAC;SACvB;QACD,yBAAyB,EAAE;KAC5B,CAAC;IAEF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC;YACb,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,6 @@
+import { DynamicModule } from '@nestjs/common';
+import type { RedisModuleAsyncOptions, RedisModuleOptions } from './interfaces';
+export declare class RedisModule {
+    static forRoot(options?: RedisModuleOptions): DynamicModule;
+    static forRootAsync(options: RedisModuleAsyncOptions): DynamicModule;
+}

package/dist/redis/redis.module.js

@@ -0,0 +1,49 @@
+"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 RedisModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisModule = void 0;
+const common_1 = require("@nestjs/common");
+const redis_constants_1 = require("./constants/redis.constants");
+const redis_providers_1 = require("./providers/redis.providers");
+const redis_service_1 = require("./services/redis.service");
+let RedisModule = RedisModule_1 = class RedisModule {
+    static forRoot(options = {}) {
+        const providers = [
+            {
+                provide: redis_constants_1.REDIS_MODULE_OPTIONS,
+                useValue: options,
+            },
+            (0, redis_providers_1.createRedisClientProvider)(),
+            redis_service_1.RedisService,
+        ];
+        return {
+            module: RedisModule_1,
+            providers,
+            exports: [redis_service_1.RedisService, redis_constants_1.REDIS_CLIENT],
+        };
+    }
+    static forRootAsync(options) {
+        const providers = [
+            ...(0, redis_providers_1.createAsyncProviders)(options),
+            redis_service_1.RedisService,
+        ];
+        return {
+            module: RedisModule_1,
+            imports: options.imports ?? [],
+            providers,
+            exports: [redis_service_1.RedisService, redis_constants_1.REDIS_CLIENT],
+        };
+    }
+};
+exports.RedisModule = RedisModule;
+exports.RedisModule = RedisModule = RedisModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], RedisModule);
+//# sourceMappingURL=redis.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis.module.js","sourceRoot":"","sources":["../../src/redis/redis.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AACzE,iEAGqC;AAErC,iEAGqC;AACrC,4DAAwD;AAIjD,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB,MAAM,CAAC,OAAO,CAAC,UAA8B,EAAE;QAC7C,MAAM,SAAS,GAAe;YAC5B;gBACE,OAAO,EAAE,sCAAoB;gBAC7B,QAAQ,EAAE,OAAO;aAClB;YACD,IAAA,2CAAyB,GAAE;YAC3B,4BAAY;SACb,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,SAAS;YACT,OAAO,EAAE,CAAC,4BAAY,EAAE,8BAAY,CAAC;SACtC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAgC;QAClD,MAAM,SAAS,GAAe;YAC5B,GAAG,IAAA,sCAAoB,EAAC,OAAO,CAAC;YAChC,4BAAY;SACb,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS;YACT,OAAO,EAAE,CAAC,4BAAY,EAAE,8BAAY,CAAC;SACtC,CAAC;IACJ,CAAC;CACF,CAAA;AA/BY,kCAAW;sBAAX,WAAW;IAFvB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,WAAW,CA+BvB"}

package/dist/redis/services/redis.service.d.ts

@@ -0,0 +1,15 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import Redis from 'ioredis';
+import type { RedisUiEntry, RedisUiStore } from '../interfaces';
+export declare class RedisService implements RedisUiStore, OnModuleDestroy {
+    private readonly client;
+    constructor(client: Redis);
+    onModuleDestroy(): Promise<void>;
+    getClient(): Redis;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(pattern?: string): Promise<string[]>;
+    ttl(key: string): Promise<number>;
+    getEntry(key: string): Promise<RedisUiEntry>;
+}

package/dist/redis/services/redis.service.js

@@ -0,0 +1,83 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisService = void 0;
+const common_1 = require("@nestjs/common");
+const ioredis_1 = __importDefault(require("ioredis"));
+const redis_constants_1 = require("../constants/redis.constants");
+let RedisService = class RedisService {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async onModuleDestroy() {
+        await this.client.quit();
+    }
+    getClient() {
+        return this.client;
+    }
+    async get(key) {
+        const value = await this.client.get(key);
+        if (value === null)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    async set(key, value, ttlSeconds) {
+        const payload = typeof value === 'string' ? value : JSON.stringify(value);
+        if (ttlSeconds && ttlSeconds > 0) {
+            await this.client.set(key, payload, 'EX', ttlSeconds);
+            return;
+        }
+        await this.client.set(key, payload);
+    }
+    async delete(key) {
+        await this.client.del(key);
+    }
+    async keys(pattern = '*') {
+        const result = [];
+        let cursor = '0';
+        do {
+            const [nextCursor, batch] = await this.client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+            cursor = nextCursor;
+            result.push(...batch);
+        } while (cursor !== '0');
+        return result;
+    }
+    ttl(key) {
+        return this.client.ttl(key);
+    }
+    async getEntry(key) {
+        const [value, ttl, type] = await Promise.all([
+            this.get(key),
+            this.ttl(key),
+            this.client.type(key),
+        ]);
+        return { key, value, ttl, type };
+    }
+};
+exports.RedisService = RedisService;
+exports.RedisService = RedisService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(redis_constants_1.REDIS_CLIENT)),
+    __metadata("design:paramtypes", [ioredis_1.default])
+], RedisService);
+//# sourceMappingURL=redis.service.js.map

package/dist/redis/services/redis.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.service.js","sourceRoot":"","sources":["../../../src/redis/services/redis.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,2CAAqE;AACrE,sDAA4B;AAC5B,kEAA4D;AAIrD,IAAM,YAAY,GAAlB,MAAM,YAAY;IAC4B;IAAnD,YAAmD,MAAa;QAAb,WAAM,GAAN,MAAM,CAAO;IAAG,CAAC;IAEpE,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAG,CAAc,GAAW;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAEhC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,UAAmB;QACxD,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE1E,IAAI,UAAU,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG;QACtB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,GAAG,CAAC;QAEjB,GAAG,CAAC;YACF,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAChD,MAAM,EACN,OAAO,EACP,OAAO,EACP,OAAO,EACP,GAAG,CACJ,CAAC;YACF,MAAM,GAAG,UAAU,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACxB,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;QAEzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;SACtB,CAAC,CAAC;QAEH,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;CACF,CAAA;AArEY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,mBAAU,GAAE;IAEE,WAAA,IAAA,eAAM,EAAC,8BAAY,CAAC,CAAA;qCAA0B,iBAAK;GADrD,YAAY,CAqExB"}