koatty_cacheable 3.0.4 → 3.0.6

package/dist/index.mjs

@@ -1,377 +1,269 @@
+import { Helper } from 'koatty_lib';
+import { DefaultLogger } from 'koatty_logger';
+import { CacheStore } from 'koatty_store';
+import { IOCContainer } from 'koatty_container';
+
 /*!
 * @Author: richen
-* @Date: 2026-02-04 10:58:15
+* @Date: 2026-02-11 03:41:57
 * @License: BSD (3-Clause)
 * @Copyright (c) - <richenlin(at)gmail.com>
 * @HomePage: https://koatty.org/
 */
-import { Helper } from 'koatty_lib';
-import { DefaultLogger } from 'koatty_logger';
-import { CacheStore } from 'koatty_store';
-import { IOCContainer } from 'koatty_container';
-
-/*
- * @Description:
- * @Usage:
- * @Author: richen
- * @Date: 2024-11-07 16:00:02
- * @LastEditTime: 2024-11-07 16:00:05
- * @License: BSD (3-Clause)
- * @Copyright (c): <richenlin(at)gmail.com>
- */
-// storeCache
-const storeCache = {
-    store: null
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var storeCache = {
+  store: null
 };
-// Promise to track initialization in progress
-let initPromise = null;
-/**
- * get instances of storeCache
- *
- * @export
- * @param {StoreOptions} options
- * @returns {*}  {CacheStore}
- */
+var initPromise = null;
 async function GetCacheStore(options) {
-    // Return existing store if available
-    if (storeCache.store && storeCache.store.getConnection) {
-        return storeCache.store;
-    }
-    // If initialization is in progress, wait for it
-    if (initPromise) {
-        return initPromise;
-    }
-    if (Helper.isEmpty(options)) {
-        if (!storeCache.store) {
-            DefaultLogger.Warn(`CacheStore not initialized. Please call KoattyCached() first with proper options in your application startup.`);
-        }
-        return storeCache.store || null;
-    }
-    // Start initialization and track it
-    initPromise = (async () => {
-        try {
-            storeCache.store = CacheStore.getInstance(options);
-            if (!Helper.isFunction(storeCache.store.getConnection)) {
-                throw Error(`CacheStore connection failed. `);
-            }
-            await storeCache.store.client.getConnection();
-            return storeCache.store;
-        }
-        finally {
-            // Clear init promise after completion
-            initPromise = null;
-        }
-    })();
+  if (storeCache.store && storeCache.store.getConnection) {
+    return storeCache.store;
+  }
+  if (initPromise) {
     return initPromise;
-}
-/**
- * Close cache store connection for cleanup (mainly for testing)
- */
-async function CloseCacheStore() {
-    if (storeCache.store) {
-        try {
-            if (storeCache.store.client) {
-                const client = storeCache.store.client;
-                if (typeof client.quit === 'function') {
-                    await client.quit();
-                }
-                else if (typeof client.close === 'function') {
-                    await client.close();
-                }
-            }
-        }
-        catch {
-            // Ignore cleanup errors
-        }
+  }
+  if (Helper.isEmpty(options)) {
+    if (!storeCache.store) {
+      DefaultLogger.Warn(`CacheStore not initialized. Please call KoattyCached() first with proper options in your application startup.`);
     }
-    // Clear the CacheStore singleton instance
+    return storeCache.store || null;
+  }
+  initPromise = (async () => {
     try {
-        await CacheStore.clearAllInstances();
-    }
-    catch {
-        // Ignore cleanup errors
+      storeCache.store = CacheStore.getInstance(options);
+      if (!Helper.isFunction(storeCache.store.getConnection)) {
+        throw Error(`CacheStore connection failed. `);
+      }
+      await storeCache.store.client.getConnection();
+      return storeCache.store;
+    } finally {
+      initPromise = null;
     }
-    // Always clear the cache
-    storeCache.store = null;
-    initPromise = null;
+  })();
+  return initPromise;
 }
-
-/* eslint-disable @typescript-eslint/no-unused-vars */
-/*
- * @Description:
- * @Usage:
- * @Author: richen
- * @Date: 2024-11-07 13:54:24
- * @LastEditTime: 2024-11-07 15:25:36
- * @License: BSD (3-Clause)
- * @Copyright (c): <richenlin(at)gmail.com>
- */
-const longKey = 128;
-/**
- * Extract parameter names from function signature
- * @param func The function to extract parameters from
- * @returns Array of parameter names
- */
-function getArgs(func) {
+__name(GetCacheStore, "GetCacheStore");
+async function CloseCacheStore() {
+  if (storeCache.store) {
     try {
-        // Match function parameters in parentheses
-        const args = func.toString().match(/.*?\(([^)]*)\)/);
-        if (args && args.length > 1) {
-            // Split parameters into array and clean them
-            return args[1].split(",").map(function (a) {
-                // Remove multi-line comments /* ... */ and single-line comments //
-                const param = a.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "").trim();
-                // Extract parameter name (before : or = or end of string)
-                const match = param.match(/^(\w+)/);
-                return match ? match[1] : "";
-            }).filter(function (ae) {
-                // Filter out empty strings
-                return ae;
-            });
+      if (storeCache.store.client) {
+        const client = storeCache.store.client;
+        if (typeof client.quit === "function") {
+          await client.quit();
+        } else if (typeof client.close === "function") {
+          await client.close();
         }
-        return [];
+      }
+    } catch {
     }
-    catch (error) {
-        // Return empty array if parsing fails
-        return [];
+  }
+  try {
+    await CacheStore.clearAllInstances();
+  } catch {
+  }
+  storeCache.store = null;
+  initPromise = null;
+}
+__name(CloseCacheStore, "CloseCacheStore");
+var longKey = 128;
+function getArgs(func) {
+  try {
+    const args = func.toString().match(/.*?\(([^)]*)\)/);
+    if (args && args.length > 1) {
+      return args[1].split(",").map(function(a) {
+        const param = a.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "").trim();
+        const match = param.match(/^(\w+)/);
+        return match ? match[1] : "";
+      }).filter(function(ae) {
+        return ae;
+      });
     }
+    return [];
+  } catch (error) {
+    return [];
+  }
 }
-/**
- * Get parameter indexes based on parameter names
- * @param funcParams Function parameter names
- * @param params Target parameter names to find indexes for
- * @returns Array of parameter indexes (-1 if not found)
- */
+__name(getArgs, "getArgs");
 function getParamIndex(funcParams, params) {
-    return params.map(param => funcParams.indexOf(param));
+  return params.map((param) => funcParams.indexOf(param));
 }
-/**
- * Generate cache key based on cache name and parameters
- * @param cacheName base cache name
- * @param paramIndexes parameter indexes
- * @param paramNames parameter names
- * @param props method arguments
- * @returns generated cache key
- */
+__name(getParamIndex, "getParamIndex");
 function generateCacheKey(cacheName, paramIndexes, paramNames, props) {
-    let key = cacheName;
-    for (let i = 0; i < paramIndexes.length; i++) {
-        const paramIndex = paramIndexes[i];
-        if (paramIndex >= 0 && props[paramIndex] !== undefined) {
-            key += `:${paramNames[i]}:${Helper.toString(props[paramIndex])}`;
-        }
+  let key = cacheName;
+  for (let i = 0; i < paramIndexes.length; i++) {
+    const paramIndex = paramIndexes[i];
+    if (paramIndex >= 0 && props[paramIndex] !== void 0) {
+      key += `:${paramNames[i]}:${Helper.toString(props[paramIndex])}`;
     }
-    return key.length > longKey ? Helper.murmurHash(key) : key;
+  }
+  return key.length > longKey ? Helper.murmurHash(key) : key;
 }
-/**
- * Create a delay promise
- * @param ms Delay time in milliseconds
- * @returns Promise that resolves after the specified delay
- */
+__name(generateCacheKey, "generateCacheKey");
 function delay(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
+  return new Promise((resolve) => setTimeout(resolve, ms));
 }
-/**
- * Execute a function after a specified delay
- * @param fn Function to execute
- * @param ms Delay time in milliseconds
- * @returns Promise that resolves with the function result
- */
+__name(delay, "delay");
 async function asyncDelayedExecution(fn, ms) {
-    await delay(ms);
-    return fn();
+  await delay(ms);
+  return fn();
 }
+__name(asyncDelayedExecution, "asyncDelayedExecution");
 
-/*
- * @Author: richen
- * @Date: 2020-07-06 19:53:43
- * @LastEditTime: 2024-11-07 15:53:46
- * @Description:
- * @Copyright (c) - <richenlin(at)gmail.com>
- */
-/**
- * Decorate this method to support caching.
- * The cache method returns a value to ensure that the next time
- * the method is executed with the same parameters, the results can be obtained
- * directly from the cache without the need to execute the method again.
- * CacheStore server config defined in db.ts.
- *
- * @export
- * @param {string} cacheName cache name
- * @param {CacheAbleOpt} [opt] cache options
- * e.g:
- * {
- *  params: ["id"],
- *  timeout: 30
- * }
- * Use the 'id' parameters of the method as cache subkeys, the cache expiration time 30s
- * @returns {MethodDecorator}
- */
+// src/cache.ts
 function CacheAble(cacheName, opt = {
-    params: [],
-    timeout: 300,
+  params: [],
+  timeout: 300
 }) {
-    return (target, methodName, descriptor) => {
-        const componentType = IOCContainer.getType(target);
-        if (!["SERVICE", "COMPONENT"].includes(componentType)) {
-            throw Error("This decorator only used in the service、component class.");
-        }
-        const { value, configurable, enumerable } = descriptor;
-        const mergedOpt = { ...{ params: [], timeout: 300 }, ...opt };
-        // Get the parameter list of the method
-        const funcParams = getArgs(target[methodName]);
-        // Get the defined parameter location
-        const paramIndexes = getParamIndex(funcParams, mergedOpt.params || []);
-        // Validate parameters
-        const invalidParams = [];
-        (mergedOpt.params || []).forEach((param, index) => {
-            if (paramIndexes[index] === -1) {
-                invalidParams.push(param);
-            }
+  return (target, methodName, descriptor) => {
+    const componentType = IOCContainer.getType(target);
+    if (![
+      "SERVICE",
+      "COMPONENT"
+    ].includes(componentType)) {
+      throw Error("This decorator only used in the service\u3001component class.");
+    }
+    const { value, configurable, enumerable } = descriptor;
+    const mergedOpt = {
+      ...{
+        params: [],
+        timeout: 300
+      },
+      ...opt
+    };
+    const funcParams = getArgs(target[methodName]);
+    const paramIndexes = getParamIndex(funcParams, mergedOpt.params || []);
+    const invalidParams = [];
+    (mergedOpt.params || []).forEach((param, index) => {
+      if (paramIndexes[index] === -1) {
+        invalidParams.push(param);
+      }
+    });
+    if (invalidParams.length > 0) {
+      DefaultLogger.Warn(`CacheAble: Parameter(s) [${invalidParams.join(", ")}] not found in method ${String(methodName)}. These parameters will be ignored.`);
+    }
+    descriptor = {
+      configurable,
+      enumerable,
+      writable: true,
+      async value(...props) {
+        const store = await GetCacheStore().catch((e) => {
+          DefaultLogger.error("Get cache store instance failed." + e.message);
+          return null;
         });
-        if (invalidParams.length > 0) {
-            DefaultLogger.Warn(`CacheAble: Parameter(s) [${invalidParams.join(", ")}] not found in method ${String(methodName)}. These parameters will be ignored.`);
-        }
-        descriptor = {
-            configurable,
-            enumerable,
-            writable: true,
-            async value(...props) {
-                const store = await GetCacheStore().catch((e) => {
-                    DefaultLogger.error("Get cache store instance failed." + e.message);
-                    return null;
-                });
-                if (store) {
-                    const key = generateCacheKey(cacheName, paramIndexes, mergedOpt.params, props);
-                    const res = await store.get(key).catch((e) => {
-                        DefaultLogger.error("Cache get error:" + e.message);
-                    });
-                    if (!Helper.isEmpty(res)) {
-                        try {
-                            return JSON.parse(res);
-                        }
-                        catch (e) {
-                            const error = e;
-                            DefaultLogger.error("Cache JSON parse error:" + error.message);
-                            // 如果解析失败，删除损坏的缓存，重新执行方法
-                            store.del(key).catch((err) => {
-                                DefaultLogger.error("Cache del error after parse failure:" + err.message);
-                            });
-                        }
-                    }
-                    const result = await value.apply(this, props);
-                    // async refresh store
-                    store.set(key, Helper.isJSONObj(result) ? JSON.stringify(result) : result, mergedOpt.timeout).catch((e) => {
-                        DefaultLogger.error("Cache set error:" + e.message);
-                    });
-                    return result;
-                }
-                else {
-                    // tslint:disable-next-line: no-invalid-this
-                    return value.apply(this, props);
-                }
+        if (store) {
+          const key = generateCacheKey(cacheName, paramIndexes, mergedOpt.params, props);
+          const res = await store.get(key).catch((e) => {
+            DefaultLogger.error("Cache get error:" + e.message);
+          });
+          if (!Helper.isEmpty(res)) {
+            try {
+              return JSON.parse(res);
+            } catch (e) {
+              const error = e;
+              DefaultLogger.error("Cache JSON parse error:" + error.message);
+              store.del(key).catch((err) => {
+                DefaultLogger.error("Cache del error after parse failure:" + err.message);
+              });
             }
-        };
-        return descriptor;
+          }
+          const result = await value.apply(this, props);
+          store.set(key, Helper.isJSONObj(result) ? JSON.stringify(result) : result, mergedOpt.timeout).catch((e) => {
+            DefaultLogger.error("Cache set error:" + e.message);
+          });
+          return result;
+        } else {
+          return value.apply(this, props);
+        }
+      }
     };
+    return descriptor;
+  };
 }
-/**
- * Decorating the execution of this method will trigger a cache clear operation.
- * CacheStore server config defined in db.ts.
- *
- * @export
- * @param {string} cacheName cacheName cache name
- * @param {CacheEvictOpt} [opt] cache options
- * e.g:
- * {
- *  params: ["id"],
- *  delayedDoubleDeletion: true
- * }
- * Use the 'id' parameters of the method as cache subkeys,
- *  and clear the cache after the method executed
- * @returns
- */
+__name(CacheAble, "CacheAble");
 function CacheEvict(cacheName, opt = {
-    delayedDoubleDeletion: true,
+  delayedDoubleDeletion: true
 }) {
-    return (target, methodName, descriptor) => {
-        const componentType = IOCContainer.getType(target);
-        if (!["SERVICE", "COMPONENT"].includes(componentType)) {
-            throw Error("This decorator only used in the service、component class.");
-        }
-        const { value, configurable, enumerable } = descriptor;
-        opt = { ...{ delayedDoubleDeletion: true, }, ...opt };
-        // Get the parameter list of the method
-        const funcParams = getArgs(target[methodName]);
-        // Get the defined parameter location
-        const paramIndexes = getParamIndex(funcParams, opt.params || []);
-        // Validate parameters
-        const invalidParams = [];
-        (opt.params || []).forEach((param, index) => {
-            if (paramIndexes[index] === -1) {
-                invalidParams.push(param);
-            }
+  return (target, methodName, descriptor) => {
+    const componentType = IOCContainer.getType(target);
+    if (![
+      "SERVICE",
+      "COMPONENT"
+    ].includes(componentType)) {
+      throw Error("This decorator only used in the service\u3001component class.");
+    }
+    const { value, configurable, enumerable } = descriptor;
+    opt = {
+      ...{
+        delayedDoubleDeletion: true
+      },
+      ...opt
+    };
+    const funcParams = getArgs(target[methodName]);
+    const paramIndexes = getParamIndex(funcParams, opt.params || []);
+    const invalidParams = [];
+    (opt.params || []).forEach((param, index) => {
+      if (paramIndexes[index] === -1) {
+        invalidParams.push(param);
+      }
+    });
+    if (invalidParams.length > 0) {
+      DefaultLogger.Warn(`CacheEvict: Parameter(s) [${invalidParams.join(", ")}] not found in method ${String(methodName)}. These parameters will be ignored.`);
+    }
+    descriptor = {
+      configurable,
+      enumerable,
+      writable: true,
+      async value(...props) {
+        const store = await GetCacheStore().catch((e) => {
+          DefaultLogger.error("Get cache store instance failed." + e.message);
+          return null;
         });
-        if (invalidParams.length > 0) {
-            DefaultLogger.Warn(`CacheEvict: Parameter(s) [${invalidParams.join(", ")}] not found in method ${String(methodName)}. These parameters will be ignored.`);
+        if (store) {
+          const key = generateCacheKey(cacheName, paramIndexes, opt.params || [], props);
+          const result = await value.apply(this, props);
+          store.del(key).catch((e) => {
+            DefaultLogger.error("Cache delete error:" + e.message);
+          });
+          if (opt.delayedDoubleDeletion) {
+            const delayTime = opt.delayTime || 5e3;
+            asyncDelayedExecution(() => {
+              store.del(key).catch((e) => {
+                DefaultLogger.error("Cache double delete error:" + e.message);
+              });
+            }, delayTime);
+          }
+          return result;
+        } else {
+          return value.apply(this, props);
         }
-        descriptor = {
-            configurable,
-            enumerable,
-            writable: true,
-            async value(...props) {
-                const store = await GetCacheStore().catch((e) => {
-                    DefaultLogger.error("Get cache store instance failed." + e.message);
-                    return null;
-                });
-                if (store) {
-                    const key = generateCacheKey(cacheName, paramIndexes, opt.params || [], props);
-                    const result = await value.apply(this, props);
-                    store.del(key).catch((e) => {
-                        DefaultLogger.error("Cache delete error:" + e.message);
-                    });
-                    if (opt.delayedDoubleDeletion) {
-                        const delayTime = opt.delayTime || 5000;
-                        asyncDelayedExecution(() => {
-                            store.del(key).catch((e) => {
-                                DefaultLogger.error("Cache double delete error:" + e.message);
-                            });
-                        }, delayTime);
-                    }
-                    return result;
-                }
-                else {
-                    // If store is not available, execute method directly
-                    return value.apply(this, props);
-                }
-            }
-        };
-        return descriptor;
+      }
     };
+    return descriptor;
+  };
 }
+__name(CacheEvict, "CacheEvict");
 
-/**
- * defaultOptions
- */
-const defaultOptions = {
-    type: "memory",
-    db: 0,
-    timeout: 30
+// src/index.ts
+var defaultOptions = {
+  type: "memory",
+  db: 0,
+  timeout: 30
 };
-/**
- * @param options - The options for the cached options
- * @param app - The Koatty application instance
- */
 async function KoattyCached(options, app) {
-    options = { ...defaultOptions, ...options };
-    app.once("appReady", async function () {
-        // 初始化缓存存储
-        await GetCacheStore(options);
-    });
-    app.on("appStop", async function () {
-        // 关闭缓存存储
-        await CloseCacheStore();
-    });
+  options = {
+    ...defaultOptions,
+    ...options
+  };
+  app.once("appReady", async function() {
+    await GetCacheStore(options);
+  });
+  app.on("appStop", async function() {
+    await CloseCacheStore();
+  });
 }
+__name(KoattyCached, "KoattyCached");
 
 export { CacheAble, CacheEvict, CloseCacheStore, GetCacheStore, KoattyCached };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store.ts","../src/utils.ts","../src/cache.ts","../src/index.ts"],"names":["storeCache","store","initPromise","GetCacheStore","options","getConnection","Helper","isEmpty","logger","Warn","CacheStore","getInstance","isFunction","Error","client","CloseCacheStore","quit","close","clearAllInstances","longKey","getArgs","func","args","toString","match","length","split","map","a","param","replace","trim","filter","ae","error","getParamIndex","funcParams","params","indexOf","generateCacheKey","cacheName","paramIndexes","paramNames","props","key","i","paramIndex","undefined","murmurHash","delay","ms","Promise","resolve","setTimeout","asyncDelayedExecution","fn","CacheAble","opt","timeout","target","methodName","descriptor","componentType","IOCContainer","getType","includes","value","configurable","enumerable","mergedOpt","invalidParams","forEach","index","push","join","String","writable","catch","e","message","res","get","JSON","parse","del","err","result","apply","set","isJSONObj","stringify","CacheEvict","delayedDoubleDeletion","delayTime","defaultOptions","type","db","KoattyCached","app","once","on"],"mappings":"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","file":"index.mjs","sourcesContent":["/*\n * @Description: \n * @Usage: \n * @Author: richen\n * @Date: 2024-11-07 16:00:02\n * @LastEditTime: 2024-11-07 16:00:05\n * @License: BSD (3-Clause)\n * @Copyright (c): <richenlin(at)gmail.com>\n */\nimport { Helper } from \"koatty_lib\";\nimport { DefaultLogger as logger } from \"koatty_logger\";\nimport { CacheStore, StoreOptions } from \"koatty_store\";\n\n/**\n * \n *\n * @interface CacheStoreInterface\n */\ninterface CacheStoreInterface {\n  store?: CacheStore;\n}\n\n// storeCache\nconst storeCache: CacheStoreInterface = {\n  store: null\n};\n\n// Promise to track initialization in progress\nlet initPromise: Promise<CacheStore> | null = null;\n\n/**\n * get instances of storeCache\n *\n * @export\n * @param {StoreOptions} options\n * @returns {*}  {CacheStore}\n */\nexport async function GetCacheStore(options?: StoreOptions): Promise<CacheStore> {\n  // Return existing store if available\n  if (storeCache.store && storeCache.store.getConnection) {\n    return storeCache.store;\n  }\n\n  // If initialization is in progress, wait for it\n  if (initPromise) {\n    return initPromise;\n  }\n\n  if (Helper.isEmpty(options)) {\n    if (!storeCache.store) {\n      logger.Warn(`CacheStore not initialized. Please call KoattyCached() first with proper options in your application startup.`);\n    }\n    return storeCache.store || null;\n  }\n\n  // Start initialization and track it\n  initPromise = (async () => {\n    try {\n      storeCache.store = CacheStore.getInstance(options);\n      if (!Helper.isFunction(storeCache.store.getConnection)) {\n        throw Error(`CacheStore connection failed. `);\n      }\n      await storeCache.store.client.getConnection();\n      return storeCache.store;\n    } finally {\n      // Clear init promise after completion\n      initPromise = null;\n    }\n  })();\n\n  return initPromise;\n}\n\n/**\n * Close cache store connection for cleanup (mainly for testing)\n */\nexport async function CloseCacheStore(): Promise<void> {\n  if (storeCache.store) {\n    try {\n      if (storeCache.store.client) {\n        const client = storeCache.store.client as any;\n        if (typeof client.quit === 'function') {\n          await client.quit();\n        } else if (typeof client.close === 'function') {\n          await client.close();\n        }\n      }\n    } catch {\n      // Ignore cleanup errors\n    }\n  }\n  \n  // Clear the CacheStore singleton instance\n  try {\n    await CacheStore.clearAllInstances();\n  } catch {\n    // Ignore cleanup errors\n  }\n  \n  // Always clear the cache\n  storeCache.store = null;\n  initPromise = null;\n}","/* eslint-disable @typescript-eslint/no-unused-vars */\n/*\n * @Description: \n * @Usage: \n * @Author: richen\n * @Date: 2024-11-07 13:54:24\n * @LastEditTime: 2024-11-07 15:25:36\n * @License: BSD (3-Clause)\n * @Copyright (c): <richenlin(at)gmail.com>\n */\n\nimport { Helper } from \"koatty_lib\";\n\nconst longKey = 128;\n\n/**\n * Extract parameter names from function signature\n * @param func The function to extract parameters from\n * @returns Array of parameter names\n */\nexport function getArgs(func: (...args: any[]) => any): string[] {\n  try {\n    // Match function parameters in parentheses\n    const args = func.toString().match(/.*?\\(([^)]*)\\)/);\n    if (args && args.length > 1) {\n      // Split parameters into array and clean them\n      return args[1].split(\",\").map(function (a) {\n        // Remove multi-line comments /* ... */ and single-line comments //\n        const param = a.replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\").replace(/\\/\\/.*$/gm, \"\").trim();\n        // Extract parameter name (before : or = or end of string)\n        const match = param.match(/^(\\w+)/);\n        return match ? match[1] : \"\";\n      }).filter(function (ae) {\n        // Filter out empty strings\n        return ae;\n      });\n    }\n    return [];\n  } catch (error) {\n    // Return empty array if parsing fails\n    return [];\n  }\n}\n\n/**\n * Get parameter indexes based on parameter names\n * @param funcParams Function parameter names\n * @param params Target parameter names to find indexes for\n * @returns Array of parameter indexes (-1 if not found)\n */\nexport function getParamIndex(funcParams: string[], params: string[]): number[] {\n  return params.map(param => funcParams.indexOf(param));\n}\n\n/**\n * Generate cache key based on cache name and parameters\n * @param cacheName base cache name\n * @param paramIndexes parameter indexes\n * @param paramNames parameter names\n * @param props method arguments\n * @returns generated cache key\n */\nexport function generateCacheKey(cacheName: string, paramIndexes: number[], paramNames: string[], props: any[]): string {\n  let key = cacheName;\n  for (let i = 0; i < paramIndexes.length; i++) {\n    const paramIndex = paramIndexes[i];\n    if (paramIndex >= 0 && props[paramIndex] !== undefined) {\n      key += `:${paramNames[i]}:${Helper.toString(props[paramIndex])}`;\n    }\n  }\n  return key.length > longKey ? Helper.murmurHash(key) : key;\n}\n\n/**\n * Create a delay promise\n * @param ms Delay time in milliseconds\n * @returns Promise that resolves after the specified delay\n */\nfunction delay(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Execute a function after a specified delay\n * @param fn Function to execute\n * @param ms Delay time in milliseconds\n * @returns Promise that resolves with the function result\n */\nexport async function asyncDelayedExecution(fn: () => any, ms: number): Promise<any> {\n  await delay(ms);\n  return fn();\n}","/*\n * @Author: richen\n * @Date: 2020-07-06 19:53:43\n * @LastEditTime: 2024-11-07 15:53:46\n * @Description:\n * @Copyright (c) - <richenlin(at)gmail.com>\n */\nimport { IOCContainer } from 'koatty_container';\nimport { Helper } from \"koatty_lib\";\nimport { DefaultLogger as logger } from \"koatty_logger\";\nimport { CacheStore } from \"koatty_store\";\nimport { asyncDelayedExecution, generateCacheKey, getArgs, getParamIndex } from './utils';\nimport { GetCacheStore } from './store';\n\n/**\n * @description: \n * @return {*}\n */\nexport interface CacheAbleOpt {\n  // parameter name array\n  params?: string[];\n  // cache validity period, seconds\n  timeout?: number;\n}\n\n/**\n * @description: \n * @return {*}\n */\nexport interface CacheEvictOpt {\n  // parameter name array\n  params?: string[];\n  // enable the delayed double deletion strategy\n  delayedDoubleDeletion?: boolean;\n  // delay time for double deletion in milliseconds, default 5000\n  delayTime?: number;\n}\n\n/**\n * Decorate this method to support caching. \n * The cache method returns a value to ensure that the next time \n * the method is executed with the same parameters, the results can be obtained\n * directly from the cache without the need to execute the method again.\n * CacheStore server config defined in db.ts.\n * \n * @export\n * @param {string} cacheName cache name\n * @param {CacheAbleOpt} [opt] cache options\n * e.g: \n * {\n *  params: [\"id\"],\n *  timeout: 30\n * }\n * Use the 'id' parameters of the method as cache subkeys, the cache expiration time 30s\n * @returns {MethodDecorator}\n */\nexport function CacheAble(cacheName: string, opt: CacheAbleOpt = {\n  params: [],\n  timeout: 300,\n}): MethodDecorator {\n  return (target: any, methodName: string, descriptor: PropertyDescriptor) => {\n    const componentType = IOCContainer.getType(target);\n    if (![\"SERVICE\", \"COMPONENT\"].includes(componentType)) {\n      throw Error(\"This decorator only used in the service、component class.\");\n    }\n\n    const { value, configurable, enumerable } = descriptor;\n    const mergedOpt = { ...{ params: [], timeout: 300 }, ...opt };\n\n    // Get the parameter list of the method\n    const funcParams = getArgs((<any>target)[methodName]);\n    // Get the defined parameter location\n    const paramIndexes = getParamIndex(funcParams, mergedOpt.params || []);\n    \n    // Validate parameters\n    const invalidParams: string[] = [];\n    (mergedOpt.params || []).forEach((param, index) => {\n      if (paramIndexes[index] === -1) {\n        invalidParams.push(param);\n      }\n    });\n    if (invalidParams.length > 0) {\n      logger.Warn(`CacheAble: Parameter(s) [${invalidParams.join(\", \")}] not found in method ${String(methodName)}. These parameters will be ignored.`);\n    }\n    \n    descriptor = {\n      configurable,\n      enumerable,\n      writable: true,\n      async value(...props: any[]) {\n        const store: CacheStore = await GetCacheStore().catch((e: Error): null => {\n          logger.error(\"Get cache store instance failed.\" + e.message);\n          return null;\n        });\n        if (store) {\n          const key = generateCacheKey(cacheName, paramIndexes, mergedOpt.params, props);\n          const res = await store.get(key).catch((e: Error) => {\n            logger.error(\"Cache get error:\" + e.message);\n          });\n          if (!Helper.isEmpty(res)) {\n            try {\n              return JSON.parse(res as string);\n            } catch (e) {\n              const error = e as Error;\n              logger.error(\"Cache JSON parse error:\" + error.message);\n              // 如果解析失败，删除损坏的缓存，重新执行方法\n              store.del(key).catch((err: Error) => {\n                logger.error(\"Cache del error after parse failure:\" + err.message);\n              });\n            }\n          }\n          const result = await value.apply(this, props);\n          // async refresh store\n          store.set(key, Helper.isJSONObj(result) ? JSON.stringify(result) : result,\n            mergedOpt.timeout).catch((e: Error) => {\n              logger.error(\"Cache set error:\" + e.message);\n            });\n          return result;\n        } else {\n          // tslint:disable-next-line: no-invalid-this\n          return value.apply(this, props);\n        }\n      }\n    };\n    return descriptor;\n  };\n}\n\n/**\n * Decorating the execution of this method will trigger a cache clear operation. \n * CacheStore server config defined in db.ts.\n *\n * @export\n * @param {string} cacheName cacheName cache name\n * @param {CacheEvictOpt} [opt] cache options\n * e.g: \n * {\n *  params: [\"id\"],\n *  delayedDoubleDeletion: true\n * }\n * Use the 'id' parameters of the method as cache subkeys,\n *  and clear the cache after the method executed\n * @returns\n */\nexport function CacheEvict(cacheName: string, opt: CacheEvictOpt = {\n  delayedDoubleDeletion: true,\n}) {\n  return (target: any, methodName: string, descriptor: PropertyDescriptor) => {\n    const componentType = IOCContainer.getType(target);\n    if (![\"SERVICE\", \"COMPONENT\"].includes(componentType)) {\n      throw Error(\"This decorator only used in the service、component class.\");\n    }\n    const { value, configurable, enumerable } = descriptor;\n    opt = { ...{ delayedDoubleDeletion: true, }, ...opt }\n    // Get the parameter list of the method\n    const funcParams = getArgs((<any>target)[methodName]);\n    // Get the defined parameter location\n    const paramIndexes = getParamIndex(funcParams, opt.params || []);\n    \n    // Validate parameters\n    const invalidParams: string[] = [];\n    (opt.params || []).forEach((param, index) => {\n      if (paramIndexes[index] === -1) {\n        invalidParams.push(param);\n      }\n    });\n    if (invalidParams.length > 0) {\n      logger.Warn(`CacheEvict: Parameter(s) [${invalidParams.join(\", \")}] not found in method ${String(methodName)}. These parameters will be ignored.`);\n    }\n\n    descriptor = {\n      configurable,\n      enumerable,\n      writable: true,\n      async value(...props: any[]) {\n        const store: CacheStore = await GetCacheStore().catch((e: Error): null => {\n          logger.error(\"Get cache store instance failed.\" + e.message);\n          return null;\n        });\n\n        if (store) {\n          const key = generateCacheKey(cacheName, paramIndexes, opt.params || [], props);\n\n          const result = await value.apply(this, props);\n          store.del(key).catch((e: Error) => {\n            logger.error(\"Cache delete error:\" + e.message);\n          });\n\n          if (opt.delayedDoubleDeletion) {\n            const delayTime = opt.delayTime || 5000;\n            asyncDelayedExecution(() => {\n              store.del(key).catch((e: Error) => {\n                logger.error(\"Cache double delete error:\" + e.message);\n              });\n            }, delayTime);\n          }\n          return result;\n        } else {\n          // If store is not available, execute method directly\n          return value.apply(this, props);\n        }\n      }\n    };\n    return descriptor;\n  }\n}\n","/*\n * @Description: \n * @Usage: \n * @Author: richen\n * @Date: 2024-11-07 16:00:02\n * @LastEditTime: 2024-11-07 16:00:05\n * @License: BSD (3-Clause)\n * @Copyright (c): <richenlin(at)gmail.com>\n */\nimport { Koatty } from \"koatty_core\";\nimport { StoreOptions } from \"koatty_store\";\nimport { CloseCacheStore, GetCacheStore } from \"./store\";\n\nexport * from \"./cache\";\nexport * from \"./store\";\n\n/** \n * defaultOptions\n */\n\nconst defaultOptions: StoreOptions = {\n  type: \"memory\",\n  db: 0,\n  timeout: 30\n}\n\n/**\n * @param options - The options for the cached options\n * @param app - The Koatty application instance\n */\nexport async function KoattyCached(options: StoreOptions, app: Koatty) {\n  options = { ...defaultOptions, ...options };\n\n  app.once(\"appReady\", async function () {\n    // 初始化缓存存储\n    await GetCacheStore(options);\n  });\n\n  app.on(\"appStop\", async function () {\n    // 关闭缓存存储\n    await CloseCacheStore();\n  });\n}"]}