@fluojs/cache-manager 1.0.0-beta.1 → 1.0.0-beta.3

package/README.ko.md

@@ -14,6 +14,7 @@
 - [공통 패턴](#공통-패턴)
   - [Redis 저장소 사용](#redis-저장소-사용)
   - [쿼리 매개변수 기반 캐싱](#쿼리-매개변수-기반-캐싱)
+  - [캐시 소유권과 reset 범위](#캐시-소유권과-reset-범위)
   - [수동 모듈 조합](#수동-모듈-조합)
 - [공개 API 개요](#공개-api-개요)
 - [관련 패키지](#관련-패키지)
@@ -120,6 +121,8 @@ CacheModule.forRoot({
 
 내장 `RedisStore`는 엔트리를 `JSON.stringify(...)`로 저장합니다. 따라서 캐시 값은 JSON 호환 형태여야 합니다. 일반 객체, 배열, 문자열, 숫자, 불리언, `null`은 안정적으로 round-trip 되지만, `Date`는 JSON 결과(예: ISO 문자열)로 돌아오고, 함수/`undefined`/`symbol`은 유지되지 않으며, `bigint`나 순환 그래프처럼 직렬화 불가능한 값은 캐싱 전에 정규화해야 합니다.
 
+Redis reset 소유권은 기본값이 `fluo:cache:`인 `keyPrefix`로 제한됩니다. Redis 기반 저장소에서 `CacheService.reset()`은 해당 prefix 아래의 키만 삭제하므로, cache prefix 밖의 애플리케이션 소유 Redis 데이터는 유지됩니다. 의도적으로 빈 `keyPrefix`를 설정하면 reset은 `*`를 scan하지 않고 현재 `RedisStore` 인스턴스가 쓴 키로만 제한됩니다. 재시작 이후나 여러 프로세스에 걸친 캐시 엔트리까지 reset해야 한다면 비어 있지 않은 애플리케이션 전용 prefix를 사용하세요.
+
 ### 쿼리 매개변수 기반 캐싱
 
 기본적으로 캐시 키는 쿼리 매개변수를 무시합니다. 검색 조건 등에 따라 다른 응답을 캐싱하려면 `httpKeyStrategy: 'route+query'`를 활성화하세요.
@@ -131,6 +134,19 @@ CacheModule.forRoot({
 })
 ```
 
+### 캐시 소유권과 reset 범위
+
+`CacheService.reset()`은 관련 없는 애플리케이션 상태가 아니라 설정된 store가 소유한 엔트리만 삭제합니다. 내장 메모리 저장소에서는 해당 store 인스턴스가 보유한 in-process 엔트리를 의미합니다. Redis에서는 설정된 `keyPrefix` namespace가 소유권 경계입니다. 공유 Redis 배포에서는 기본 `fluo:cache:`를 유지하거나 `myapp:cache:`처럼 전용 prefix를 선택하세요.
+
+```typescript
+CacheModule.forRoot({
+  store: 'redis',
+  keyPrefix: 'myapp:cache:',
+})
+```
+
+Redis cache prefix를 cache가 아닌 데이터와 공유하지 마세요. `del(key)`은 이 패키지가 해석한 정확한 캐시 키를 삭제하고, `reset()`은 위에서 설명한 store 소유 캐시 namespace만 삭제합니다.
+
 ### 수동 모듈 조합
 
 일반적인 애플리케이션 설정과 커스텀 `defineModule(...)` 조합에서는 `CacheModule.forRoot(...)`를 사용합니다.

package/README.md

@@ -14,6 +14,7 @@ General-purpose cache manager for fluo with pluggable memory and Redis stores. P
 - [Common Patterns](#common-patterns)
   - [Redis Storage](#redis-storage)
   - [Query-Sensitive Caching](#query-sensitive-caching)
+  - [Cache Ownership and Reset Scope](#cache-ownership-and-reset-scope)
   - [Manual Module Composition](#manual-module-composition)
 - [Public API Overview](#public-api-overview)
 - [Related Packages](#related-packages)
@@ -120,6 +121,8 @@ CacheModule.forRoot({
 
 The built-in `RedisStore` persists entries with `JSON.stringify(...)`. Cache values therefore need to be JSON-compatible: plain objects, arrays, strings, numbers, booleans, and `null` round-trip cleanly, while values such as `Date` come back as JSON output (for example ISO strings), functions/`undefined`/symbols do not survive, and non-serializable values like `bigint` or cyclic graphs should be normalized before caching.
 
+Redis reset ownership is scoped by `keyPrefix`, which defaults to `fluo:cache:`. `CacheService.reset()` deletes only keys under that prefix for Redis-backed stores, so application-owned Redis data outside the cache prefix is preserved. If you intentionally configure an empty `keyPrefix`, reset is limited to keys written by the current `RedisStore` instance instead of scanning `*`; use a non-empty, application-specific prefix when you need reset to cover cache entries across restarts or multiple processes.
+
 ### Query-Sensitive Caching
 
 By default, the cache key ignores query parameters. Enable `httpKeyStrategy: 'route+query'` to cache different responses for different search parameters.
@@ -131,6 +134,19 @@ CacheModule.forRoot({
 })
 ```
 
+### Cache Ownership and Reset Scope
+
+`CacheService.reset()` clears entries owned by the configured store, not unrelated application state. For the built-in memory store that means the in-process entries held by that store instance. For Redis, ownership is the configured `keyPrefix` namespace; keep the default `fluo:cache:` or choose a dedicated prefix such as `myapp:cache:` for shared Redis deployments.
+
+```typescript
+CacheModule.forRoot({
+  store: 'redis',
+  keyPrefix: 'myapp:cache:',
+})
+```
+
+Avoid sharing a Redis cache prefix with non-cache data. `del(key)` removes the exact cache key resolved by this package, while `reset()` removes only the store-owned cache namespace described above.
+
 ### Manual Module Composition
 
 Use `CacheModule.forRoot(...)` for normal application setup, including custom `defineModule(...)` composition.

package/dist/interceptor.js

@@ -5,7 +5,7 @@ function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e =
 function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
 function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
 import { Inject } from '@fluojs/core';
-import { metadataSymbol } from '@fluojs/core/internal';
+import { getStandardMetadataBag } from '@fluojs/core/internal';
 import { SseResponse } from '@fluojs/http';
 import { cacheRouteMetadataKey, getCacheEvictMetadata, getCacheKeyMetadata, getCacheTtlMetadata } from './decorators.js';
 import { CacheService } from './service.js';
@@ -14,7 +14,7 @@ function isMetadataBag(value) {
   return typeof value === 'object' && value !== null;
 }
 function getMethodMetadataBag(controllerToken, methodName) {
-  const classBag = Reflect.get(controllerToken, metadataSymbol);
+  const classBag = getStandardMetadataBag(controllerToken);
   if (!isMetadataBag(classBag)) {
     return undefined;
   }

package/dist/stores/redis-store.d.ts

@@ -1,16 +1,30 @@
 import type { CacheStore, RedisCompatibleClient } from '../types.js';
+/**
+ * Redis store configuration for key ownership and reset scanning.
+ */
 export interface RedisStoreOptions {
+    /**
+     * Prefix used to scope keys owned by this cache store when deleting entries or resetting the store.
+     */
     keyPrefix?: string;
+    /**
+     * Maximum number of keys requested per Redis SCAN iteration during reset.
+     */
     scanCount?: number;
 }
+/**
+ * Cache store implementation backed by a Redis-compatible client.
+ */
 export declare class RedisStore implements CacheStore {
     private readonly client;
+    private readonly ownedKeys;
     private readonly keyPrefix;
     private readonly scanCount;
     constructor(client: RedisCompatibleClient, options?: RedisStoreOptions);
     private toRedisKey;
     get<T = unknown>(key: string): Promise<T | undefined>;
     set<T = unknown>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    private trackOwnedKey;
     del(key: string): Promise<void>;
     reset(): Promise<void>;
 }

package/dist/stores/redis-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-store.d.ts","sourceRoot":"","sources":["../../src/stores/redis-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwCD,qBAAa,UAAW,YAAW,UAAU;IAKzC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,MAAM,EAAE,qBAAqB,EAC9C,OAAO,GAAE,iBAAsB;IAMjC,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiBrD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB7B"}
+{"version":3,"file":"redis-store.d.ts","sourceRoot":"","sources":["../../src/stores/redis-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwCD;;GAEG;AACH,qBAAa,UAAW,YAAW,UAAU;IAMzC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,MAAM,EAAE,qBAAqB,EAC9C,OAAO,GAAE,iBAAsB;IAMjC,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiBrD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5E,OAAO,CAAC,aAAa;IAMf,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC7B"}

package/dist/stores/redis-store.js

@@ -1,3 +1,7 @@
+/**
+ * Redis store configuration for key ownership and reset scanning.
+ */
+
 const DEFAULT_KEY_PREFIX = 'fluo:cache:';
 const DEFAULT_SCAN_COUNT = 100;
 function parseEntry(raw) {
@@ -24,7 +28,12 @@ function normalizeScanResponse(result) {
     keys
   };
 }
+
+/**
+ * Cache store implementation backed by a Redis-compatible client.
+ */
 export class RedisStore {
+  ownedKeys = new Set();
   keyPrefix;
   scanCount;
   constructor(client, options = {}) {
@@ -49,6 +58,7 @@ export class RedisStore {
   }
   async set(key, value, ttlSeconds = 0) {
     const now = Date.now();
+    const redisKey = this.toRedisKey(key);
     const entry = {
       value
     };
@@ -56,15 +66,35 @@ export class RedisStore {
       const ttlMilliseconds = Math.max(1, Math.floor(ttlSeconds * 1000));
       entry.expiresAt = now + ttlMilliseconds;
       const ttlSecondsRounded = Math.max(1, Math.ceil(ttlMilliseconds / 1000));
-      await this.client.set(this.toRedisKey(key), JSON.stringify(entry), 'EX', ttlSecondsRounded);
+      await this.client.set(redisKey, JSON.stringify(entry), 'EX', ttlSecondsRounded);
+      this.trackOwnedKey(redisKey);
       return;
     }
-    await this.client.set(this.toRedisKey(key), JSON.stringify(entry));
+    await this.client.set(redisKey, JSON.stringify(entry));
+    this.trackOwnedKey(redisKey);
+  }
+  trackOwnedKey(redisKey) {
+    if (this.keyPrefix.length === 0) {
+      this.ownedKeys.add(redisKey);
+    }
   }
   async del(key) {
-    await this.client.del(this.toRedisKey(key));
+    const redisKey = this.toRedisKey(key);
+    await this.client.del(redisKey);
+    this.ownedKeys.delete(redisKey);
   }
   async reset() {
+    if (this.keyPrefix.length === 0) {
+      const keys = Array.from(this.ownedKeys);
+      if (keys.length > 0) {
+        const [firstKey, ...restKeys] = keys;
+        if (firstKey !== undefined) {
+          await this.client.del(firstKey, ...restKeys);
+        }
+      }
+      this.ownedKeys.clear();
+      return;
+    }
     let cursor = '0';
     const pattern = `${this.keyPrefix}*`;
     do {
@@ -77,5 +107,6 @@ export class RedisStore {
         }
       }
     } while (cursor !== '0');
+    this.ownedKeys.clear();
   }
 }

package/package.json

@@ -10,7 +10,7 @@
     "memory-store",
     "decorator"
   ],
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -37,14 +37,14 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/http": "^1.0.0-beta.1",
-    "@fluojs/core": "^1.0.0-beta.1",
-    "@fluojs/di": "^1.0.0-beta.1",
-    "@fluojs/runtime": "^1.0.0-beta.1"
+    "@fluojs/core": "^1.0.0-beta.2",
+    "@fluojs/di": "^1.0.0-beta.3",
+    "@fluojs/http": "^1.0.0-beta.2",
+    "@fluojs/runtime": "^1.0.0-beta.3"
   },
   "peerDependencies": {
     "ioredis": "^5.0.0",
-    "@fluojs/redis": "^1.0.0-beta.1"
+    "@fluojs/redis": "^1.0.0-beta.2"
   },
   "peerDependenciesMeta": {
     "@fluojs/redis": {