@jintianxiayu/cache-decorator 0.1.2 → 1.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"redis-cache.js","sourceRoot":"","sources":["../../src/core/redis-cache.ts"],"names":[],"mappings":";;;;;;AACA,sDAA4B;AAE5B;;;GAGG;AACH,MAAa,kBAAkB;IAG7B,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,iBAAK,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAqB,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,GAAY;QAC9C,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7E,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACF,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAC9C,MAAM,EACN,OAAO,EACP,OAAO,EACP,OAAO,EACP,GAAG,CACJ,CAAC;YACF,MAAM,GAAG,UAAU,CAAC;YACpB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAC3B,CAAC;CACF;AAtDD,gDAsDC"}
+{"version":3,"file":"redis-cache.js","sourceRoot":"","sources":["../../src/core/redis-cache.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACH,MAAa,kBAAkB;IAG3B;;;OAGG;IACH,YAAY,MAAwB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAI,GAAW;QACpB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACL,8BAA8B;YAC9B,OAAO,KAAqB,CAAC;QACjC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,GAAY;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7E,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;YAClD,OAAO;QACX,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACP,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe;QACjC,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACA,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACrE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACrB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAC7B,CAAC;IAEO,YAAY,CAAC,GAAuB;QACxC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,UAAU,CAAC,2DAA2D,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;CACJ;AAhGD,gDAgGC"}

package/dist/decorators/cache-evict.d.ts

@@ -1,4 +1,4 @@
-import { CacheOptions } from './cache';
+import type { CacheOptions } from './cache';
 /**
  * @CacheEvict 装饰器配置项
  */

package/dist/decorators/cache-evict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-evict.d.ts","sourceRoot":"","sources":["../../src/decorators/cache-evict.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAoB,MAAM,SAAS,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC;IAClE;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAuBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,IAErE,SAAS,MAAM,EACf,cAAc,MAAM,EACpB,YAAY,kBAAkB,UAoBjC;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"cache-evict.d.ts","sourceRoot":"","sources":["../../src/decorators/cache-evict.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC;IAChE;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AA8DD;;;;;GAKG;AACH,wBAAgB,UAAU,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC5B,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAAI,CAoCjF;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/decorators/cache-evict.js

@@ -2,28 +2,64 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CacheProviderRegistry = void 0;
 exports.CacheEvict = CacheEvict;
+const cache_logger_1 = require("../core/cache-logger");
 const cache_provider_registry_1 = require("../core/cache-provider-registry");
 const key_builder_1 = require("../core/key-builder");
 /**
  * 解析缓存 key
- * @param cacheName 缓存名称
  * @param keyResolver key 解析器
  * @param args 方法参数数组
+ * @param logContext 不包含业务参数和值的日志上下文
  * @returns 解析后的缓存 key
  */
-function resolveCacheKey(cacheName, keyResolver, args) {
+function resolveCacheKey(keyResolver, args, logContext) {
     if (keyResolver === undefined || keyResolver === null) {
-        return key_builder_1.KeyBuilder.build(cacheName, args);
+        return key_builder_1.KeyBuilder.build(logContext.cacheName, args);
     }
     if (typeof keyResolver === 'string') {
-        return key_builder_1.KeyBuilder.build(cacheName, [keyResolver]);
+        return key_builder_1.KeyBuilder.build(logContext.cacheName, [keyResolver]);
+    }
+    try {
+        return key_builder_1.KeyBuilder.build(logContext.cacheName, [keyResolver(...args)]);
+    }
+    catch (_error) {
+        (0, cache_logger_1.logCacheEvent)('cache.key_fallback', { ...logContext, reason: 'resolver_error' });
+        return key_builder_1.KeyBuilder.build(logContext.cacheName, args);
+    }
+}
+/**
+ * 获取淘汰操作使用的 Provider，并在解析失败时记录原始注册表错误。
+ * @param providerName decorator 配置中的 Provider 名称。
+ * @param logContext 当前方法的稳定日志上下文。
+ * @returns 已注册的缓存 Provider。
+ * @throws Provider 注册表抛出的原始错误。
+ */
+function resolveCacheProvider(providerName, logContext) {
+    try {
+        return cache_provider_registry_1.CacheProviderRegistry.get(providerName);
+    }
+    catch (error) {
+        (0, cache_logger_1.logCacheEvent)('cache.operation_failed', { ...logContext, operation: 'provider_resolution', error });
+        throw error;
     }
+}
+/**
+ * 保持 fire-and-forget 语义发起单 key 删除，只处理调用当下可观察的同步失败。
+ * @param provider 当前淘汰使用的 Provider。
+ * @param cacheKey 待删除的完整 key；不会进入日志元数据。
+ * @param logContext 当前方法的稳定日志上下文。
+ * @returns 无返回值；异步删除 Promise 不会被等待或消费。
+ * @throws Provider delete 同步抛出的原始错误。
+ */
+function dispatchCacheDelete(provider, cacheKey, logContext) {
     try {
-        return key_builder_1.KeyBuilder.build(cacheName, [keyResolver(...args)]);
+        provider.delete(cacheKey);
     }
-    catch {
-        return key_builder_1.KeyBuilder.build(cacheName, args);
+    catch (error) {
+        (0, cache_logger_1.logCacheEvent)('cache.operation_failed', { ...logContext, operation: 'evict', error });
+        throw error;
     }
+    (0, cache_logger_1.logCacheEvent)('cache.evict_dispatched', { ...logContext, scope: 'key' });
 }
 /**
  * 缓存清除装饰器
@@ -32,18 +68,36 @@ function resolveCacheKey(cacheName, keyResolver, args) {
  * @param options 配置项
  */
 function CacheEvict(cacheName, options) {
-    return function (_target, _propertyKey, descriptor) {
+    return function (_target, propertyKey, descriptor) {
         const originalMethod = descriptor.value;
+        const logContext = {
+            cacheName,
+            methodName: propertyKey,
+            providerName: (0, cache_logger_1.cacheProviderLabel)(options?.providerName),
+        };
         descriptor.value = async function (...args) {
-            const result = await originalMethod.apply(this, args);
-            const providerName = options?.providerName;
-            const provider = cache_provider_registry_1.CacheProviderRegistry.get(providerName);
+            let result;
+            try {
+                result = await originalMethod.apply(this, args);
+            }
+            catch (error) {
+                (0, cache_logger_1.logCacheEvent)('cache.evict_skipped', { ...logContext, reason: 'business_error' });
+                throw error;
+            }
+            const provider = resolveCacheProvider(options?.providerName, logContext);
             if (options?.allEntries) {
-                await provider.deleteByPattern(cacheName + '*');
+                try {
+                    await provider.deleteByPattern(cacheName + '*');
+                }
+                catch (error) {
+                    (0, cache_logger_1.logCacheEvent)('cache.operation_failed', { ...logContext, operation: 'evict', error });
+                    throw error;
+                }
+                (0, cache_logger_1.logCacheEvent)('cache.evict_completed', { ...logContext, scope: 'allEntries' });
             }
             else {
-                const cacheKey = resolveCacheKey(cacheName, options?.key, args);
-                provider.delete(cacheKey);
+                const cacheKey = resolveCacheKey(options?.key, args, logContext);
+                dispatchCacheDelete(provider, cacheKey, logContext);
             }
             return result;
         };

package/dist/decorators/cache-evict.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-evict.js","sourceRoot":"","sources":["../../src/decorators/cache-evict.ts"],"names":[],"mappings":";;;AA8CA,gCAwBC;AAtED,6EAAwE;AACxE,qDAAiD;AAkBjD;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,SAAiB,EAAE,WAAyC,EAAE,IAAe;IACpG,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,wBAAU,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,wBAAU,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC;QACH,OAAO,wBAAU,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,wBAAU,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,SAAiB,EAAE,OAA2B;IACvE,OAAO,UACL,OAAe,EACf,YAAoB,EACpB,UAA8B;QAE9B,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAe;YACnD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAEtD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;YAC3C,MAAM,QAAQ,GAAG,+CAAqB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAEzD,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;gBACxB,MAAM,QAAQ,CAAC,eAAe,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBAChE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,2EAAwE;AAA/D,gIAAA,qBAAqB,OAAA"}
+{"version":3,"file":"cache-evict.js","sourceRoot":"","sources":["../../src/decorators/cache-evict.ts"],"names":[],"mappings":"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"}

package/dist/decorators/cache.d.ts

@@ -32,6 +32,6 @@ export interface CacheOptions {
  * @param cacheName 缓存名称
  * @param options 配置项
  */
-export declare function Cache(cacheName: string, options?: CacheOptions): <T>(_target: object, _propertyKey: string, descriptor: PropertyDescriptor) => void;
+export declare function Cache(cacheName: string, options?: CacheOptions): (_target: object, _propertyKey: string, descriptor: PropertyDescriptor) => void;
 export { CacheProviderRegistry } from '../core/cache-provider-registry';
 //# sourceMappingURL=cache.d.ts.map

package/dist/decorators/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/decorators/cache.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAK1B;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AA4CD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,IAC5C,CAAC,EAChB,SAAS,MAAM,EACf,cAAc,MAAM,EACpB,YAAY,kBAAkB,UAsCjC;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/decorators/cache.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAO1B;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AA0FD;;;;;GAKG;AACH,wBAAgB,KAAK,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,GACvB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAAI,CAiEjF;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/decorators/cache.js

@@ -3,29 +3,63 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CacheProviderRegistry = void 0;
 exports.Cache = Cache;
 require("reflect-metadata");
+const cache_logger_1 = require("../core/cache-logger");
 const cache_provider_registry_1 = require("../core/cache-provider-registry");
 const key_builder_1 = require("../core/key-builder");
 const pending_cache_1 = require("../core/pending-cache");
 const pendingCache = new pending_cache_1.PendingCache();
+/**
+ * 获取配置指向的缓存 Provider，并在解析失败时记录原始错误。
+ * @param providerName decorator 配置中的 Provider 名称。
+ * @param logContext 当前方法的稳定日志上下文。
+ * @returns 已注册的缓存 Provider。
+ * @throws Provider 注册表抛出的原始错误。
+ */
+function resolveCacheProvider(providerName, logContext) {
+    try {
+        return cache_provider_registry_1.CacheProviderRegistry.get(providerName);
+    }
+    catch (error) {
+        (0, cache_logger_1.logCacheEvent)('cache.operation_failed', { ...logContext, operation: 'provider_resolution', error });
+        throw error;
+    }
+}
+/**
+ * 保持 fire-and-forget 语义提交缓存写入，仅捕获调用当下可观察的同步失败。
+ * @param request 写入所需 Provider、entry 和无业务数据日志上下文。
+ * @returns 无返回值；异步写入 Promise 不会被等待或消费。
+ * @throws Provider set 同步抛出的原始错误。
+ */
+function dispatchCacheWrite(request) {
+    try {
+        request.provider.set(request.cacheKey, request.entry, request.ttl);
+    }
+    catch (error) {
+        (0, cache_logger_1.logCacheEvent)('cache.operation_failed', { ...request.logContext, operation: 'write', error });
+        throw error;
+    }
+    (0, cache_logger_1.logCacheEvent)('cache.write_dispatched', { ...request.logContext, entryType: request.entryType });
+}
 /**
  * 解析缓存 key
- * @param cacheName 缓存名称
  * @param keyResolver key 解析器
  * @param args 方法参数数组
+ * @param logContext 不包含业务参数和值的日志上下文
  * @returns 解析后的缓存 key
  */
-function resolveCacheKey(cacheName, keyResolver, args) {
+function resolveCacheKey(keyResolver, args, logContext) {
     if (keyResolver === undefined || keyResolver === null) {
-        return key_builder_1.KeyBuilder.build(cacheName, args);
+        return key_builder_1.KeyBuilder.build(logContext.cacheName, args);
     }
     if (typeof keyResolver === 'string') {
-        return key_builder_1.KeyBuilder.build(cacheName, [keyResolver]);
+        return key_builder_1.KeyBuilder.build(logContext.cacheName, [keyResolver]);
     }
     try {
-        return key_builder_1.KeyBuilder.build(cacheName, [keyResolver(...args)]);
+        return key_builder_1.KeyBuilder.build(logContext.cacheName, [keyResolver(...args)]);
     }
-    catch {
-        return key_builder_1.KeyBuilder.build(cacheName, args);
+    catch (_error) {
+        (0, cache_logger_1.logCacheEvent)('cache.key_fallback', { ...logContext, reason: 'resolver_error' });
+        return key_builder_1.KeyBuilder.build(logContext.cacheName, args);
     }
 }
 /**
@@ -35,32 +69,60 @@ function resolveCacheKey(cacheName, keyResolver, args) {
  * @param options 配置项
  */
 function Cache(cacheName, options) {
-    return function (_target, _propertyKey, descriptor) {
+    return function (_target, propertyKey, descriptor) {
         const originalMethod = descriptor.value;
-        descriptor.value = async function (...args) {
-            const cacheKey = resolveCacheKey(cacheName, options?.key, args);
-            const providerName = options?.providerName;
-            const provider = cache_provider_registry_1.CacheProviderRegistry.get(providerName);
-            const cached = await provider.get(cacheKey);
-            if (cached !== undefined) {
-                const entry = cached;
-                if ('error' in entry) {
-                    throw entry.error;
-                }
-                return entry.value;
-            }
+        const logContext = {
+            cacheName,
+            methodName: propertyKey,
+            providerName: (0, cache_logger_1.cacheProviderLabel)(options?.providerName),
+        };
+        descriptor.value = function (...args) {
+            const cacheKey = resolveCacheKey(options?.key, args, logContext);
             const pending = pendingCache.get(cacheKey);
             if (pending) {
+                (0, cache_logger_1.logCacheEvent)('cache.pending_hit', logContext);
                 return pending;
             }
             const promise = (async () => {
+                const provider = resolveCacheProvider(options?.providerName, logContext);
+                let cached;
+                try {
+                    cached = await provider.get(cacheKey);
+                }
+                catch (error) {
+                    (0, cache_logger_1.logCacheEvent)('cache.operation_failed', { ...logContext, operation: 'read', error });
+                    throw error;
+                }
+                if (cached !== undefined) {
+                    if ('error' in cached) {
+                        (0, cache_logger_1.logCacheEvent)('cache.hit', { ...logContext, entryType: 'error' });
+                        throw cached.error;
+                    }
+                    (0, cache_logger_1.logCacheEvent)('cache.hit', { ...logContext, entryType: 'value' });
+                    return cached.value;
+                }
+                (0, cache_logger_1.logCacheEvent)('cache.miss', logContext);
                 try {
-                    const result = await originalMethod.apply(this, args);
-                    provider.set(cacheKey, { value: result }, options?.ttl);
+                    const result = (await originalMethod.apply(this, args));
+                    dispatchCacheWrite({
+                        provider,
+                        cacheKey,
+                        entry: { value: result },
+                        entryType: 'value',
+                        ttl: options?.ttl,
+                        logContext,
+                    });
                     return result;
                 }
                 catch (error) {
-                    provider.set(cacheKey, { error }, options?.ttl);
+                    dispatchCacheWrite({
+                        provider,
+                        cacheKey,
+                        entry: { error },
+                        entryType: 'error',
+                        ttl: options?.ttl,
+                        logContext,
+                    });
                     throw error;
                 }
             })();

package/dist/decorators/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/decorators/cache.ts"],"names":[],"mappings":";;;AAoFA,sBA0CC;AA9HD,4BAA0B;AAC1B,6EAAwE;AACxE,qDAAiD;AACjD,yDAAqD;AAoDrD,MAAM,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC;AAExC;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,SAAiB,EAAE,WAAyC,EAAE,IAAe;IACpG,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,wBAAU,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,wBAAU,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC;QACH,OAAO,wBAAU,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,wBAAU,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,KAAK,CAAC,SAAiB,EAAE,OAAsB;IAC7D,OAAO,UACL,OAAe,EACf,YAAoB,EACpB,UAA8B;QAE9B,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAe;YACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAChE,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;YAC3C,MAAM,QAAQ,GAAG,+CAAqB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAEzD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,MAAuB,CAAC;gBACtC,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;oBACrB,MAAM,KAAK,CAAC,KAAK,CAAC;gBACpB,CAAC;gBACD,OAAO,KAAK,CAAC,KAAK,CAAC;YACrB,CAAC;YAED,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAI,QAAQ,CAAC,CAAC;YAC9C,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC1B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACtD,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAmB,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;oBACzE,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAmB,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;oBACjE,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YAEL,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpC,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,2EAAwE;AAA/D,gIAAA,qBAAqB,OAAA"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/decorators/cache.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,8 +1,11 @@
+export { createIoredisCacheClient } from './adapters/ioredis-cache-client';
+export { createNodeRedisCacheClient } from './adapters/node-redis-cache-client';
 export * from './core/cache-provider';
 export * from './core/cache-provider-registry';
 export * from './core/key-builder';
 export * from './core/native-cache';
 export * from './core/pending-cache';
+export * from './core/redis-cache-client';
 export * from './core/redis-cache';
 export * from './decorators/cache';
 export * from './decorators/cache-evict';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -14,11 +14,17 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodeRedisCacheClient = exports.createIoredisCacheClient = void 0;
+var ioredis_cache_client_1 = require("./adapters/ioredis-cache-client");
+Object.defineProperty(exports, "createIoredisCacheClient", { enumerable: true, get: function () { return ioredis_cache_client_1.createIoredisCacheClient; } });
+var node_redis_cache_client_1 = require("./adapters/node-redis-cache-client");
+Object.defineProperty(exports, "createNodeRedisCacheClient", { enumerable: true, get: function () { return node_redis_cache_client_1.createNodeRedisCacheClient; } });
 __exportStar(require("./core/cache-provider"), exports);
 __exportStar(require("./core/cache-provider-registry"), exports);
 __exportStar(require("./core/key-builder"), exports);
 __exportStar(require("./core/native-cache"), exports);
 __exportStar(require("./core/pending-cache"), exports);
+__exportStar(require("./core/redis-cache-client"), exports);
 __exportStar(require("./core/redis-cache"), exports);
 __exportStar(require("./decorators/cache"), exports);
 __exportStar(require("./decorators/cache-evict"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,wDAAsC;AACtC,iEAA+C;AAC/C,qDAAmC;AACnC,sDAAoC;AACpC,uDAAqC;AACrC,qDAAmC;AACnC,qDAAmC;AACnC,2DAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wEAA2E;AAAlE,gIAAA,wBAAwB,OAAA;AACjC,8EAAgF;AAAvE,qIAAA,0BAA0B,OAAA;AACnC,wDAAsC;AACtC,iEAA+C;AAC/C,qDAAmC;AACnC,sDAAoC;AACpC,uDAAqC;AACrC,4DAA0C;AAC1C,qDAAmC;AACnC,qDAAmC;AACnC,2DAAyC"}

package/jest.config.js

@@ -1,14 +1,11 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  roots: ['<rootDir>'],
-  testMatch: ['**/test/**/*.test.ts'],
-  moduleFileExtensions: ['ts', 'js', 'json'],
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/**/*.d.ts'
-  ],
-  transform: {
-    '^.+\\.ts$': 'ts-jest'
-  }
-};
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
+    roots: ['<rootDir>'],
+    testMatch: ['**/test/**/*.test.ts'],
+    moduleFileExtensions: ['ts', 'js', 'json'],
+    collectCoverageFrom: ['src/**/*.ts', '!src/**/*.d.ts'],
+    transform: {
+        '^.+\\.ts$': ['ts-jest', { tsconfig: '<rootDir>/../../tsconfig.test.json' }],
+    },
+};

package/package.json

@@ -1,30 +1,27 @@
 {
-    "name": "@jintianxiayu/cache-decorator",
-    "version": "0.1.2",
-    "description": "Method caching decorators for TypeScript",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "scripts": {
-        "build": "tsc",
-        "test": "jest",
-        "typecheck": "tsc --noEmit"
-    },
-    "dependencies": {
-        "reflect-metadata": "^0.2.2"
-    },
-    "devDependencies": {
-        "@types/ioredis": "^4.28.10",
-        "@types/node": "^22.10.0",
-        "ioredis": "^5.10.1",
-        "jest": "^29.7.0",
-        "ts-jest": "^29.2.0",
-        "typescript": "^5.7.0"
-    },
-    "peerDependencies": {
-        "reflect-metadata": "^0.2.2"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "gitHead": "357e736abbe6b25a707663c1b9e027b2e8b532a6"
-}
+  "name": "@jintianxiayu/cache-decorator",
+  "version": "1.0.0",
+  "description": "Method caching decorators for TypeScript",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "reflect-metadata": "^0.2.2"
+  },
+  "peerDependencies": {
+    "@jintianxiayu/logger": "^1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "ioredis": "^5.10.1",
+    "redis": "^5.12.1",
+    "@jintianxiayu/logger": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/adapters/ioredis-cache-client.ts

@@ -0,0 +1,89 @@
+import { IoredisCacheClientSource, RedisCacheClient } from '../core/redis-cache-client';
+import { createRedisScanPattern, stripRedisKeyPrefix } from './redis-key-prefix';
+
+function normalizeGetResponse(response: unknown): string | null {
+    if (typeof response === 'string' || response === null) {
+        return response;
+    }
+    throw new TypeError('Expected Redis GET to return a string or null');
+}
+
+function validateOkResponse(command: string, response: unknown): void {
+    if (response !== 'OK') {
+        throw new TypeError(`Expected Redis ${command} to return "OK"`);
+    }
+}
+
+function validateDeleteResponse(response: unknown): void {
+    if (typeof response !== 'number' || !Number.isInteger(response) || response < 0) {
+        throw new TypeError('Expected Redis DEL to return a non-negative integer');
+    }
+}
+
+function normalizeScanResponse(
+    response: unknown,
+    keyPrefix: string
+): { readonly cursor: string; readonly keys: readonly string[] } {
+    if (
+        !Array.isArray(response) ||
+        response.length !== 2 ||
+        typeof response[0] !== 'string' ||
+        !Array.isArray(response[1]) ||
+        !response[1].every((key: unknown) => typeof key === 'string')
+    ) {
+        throw new TypeError('Expected ioredis SCAN to return a [cursor, keys] tuple');
+    }
+    return {
+        cursor: response[0],
+        keys: response[1].map((key: string) => stripRedisKeyPrefix(keyPrefix, key)),
+    };
+}
+
+/**
+ * 将调用方的 ioredis 连接适配为客户端无关的缓存命令，不创建或关闭连接。
+ * @param client 使用默认字符串响应映射的 ioredis 普通客户端。
+ * @returns 复用该连接并恢复逻辑 key 的 Redis 缓存客户端。
+ * @throws 返回对象的命令方法传播客户端错误；非标准响应拒绝为 TypeError。
+ */
+export function createIoredisCacheClient(client: IoredisCacheClientSource): RedisCacheClient {
+    const keyPrefix = client.options.keyPrefix ?? '';
+    return {
+        /** @inheritdoc */
+        async get(key: string): Promise<string | null> {
+            return normalizeGetResponse(await client.get(key));
+        },
+        /** @inheritdoc */
+        async set({ key, value, ttlSeconds }): Promise<void> {
+            if (ttlSeconds === undefined) {
+                validateOkResponse('SET', await client.set(key, value));
+                return;
+            }
+            validateOkResponse('SETEX', await client.setex(key, ttlSeconds, value));
+        },
+        /** @inheritdoc */
+        async deleteMany(keys: readonly string[]): Promise<void> {
+            if (keys.length === 0) {
+                return;
+            }
+            validateDeleteResponse(await client.del(...keys));
+        },
+        /** @inheritdoc */
+        async scan({ cursor, pattern, count }): Promise<{
+            readonly cursor: string;
+            readonly keys: readonly string[];
+        }> {
+            const response = await client.scan(
+                cursor,
+                'MATCH',
+                createRedisScanPattern(keyPrefix, pattern),
+                'COUNT',
+                count
+            );
+            return normalizeScanResponse(response, keyPrefix);
+        },
+        /** @inheritdoc */
+        async flushDatabase(): Promise<void> {
+            validateOkResponse('FLUSHDB', await client.flushdb());
+        },
+    };
+}