@lark-apaas/cache-service 0.1.1-alpha.0

package/dist/core/index.cjs

@@ -0,0 +1,348 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/index.ts
+var core_exports = {};
+__export(core_exports, {
+  CACHE_ERROR_CODE_UNAVAILABLE: () => CACHE_ERROR_CODE_UNAVAILABLE,
+  DEFAULT_CONNECT_TIMEOUT_MS: () => DEFAULT_CONNECT_TIMEOUT_MS,
+  DEFAULT_SOCKET_TIMEOUT_MS: () => DEFAULT_SOCKET_TIMEOUT_MS,
+  TOKEN_WATCH_DEBOUNCE_MS: () => TOKEN_WATCH_DEBOUNCE_MS,
+  TOKEN_WATCH_INTERVAL_MS: () => TOKEN_WATCH_INTERVAL_MS,
+  createCacheStore: () => createCacheStore,
+  registerHooks: () => registerHooks
+});
+module.exports = __toCommonJS(core_exports);
+
+// src/core/cache-store.ts
+var import_keyv2 = __toESM(require("keyv"), 1);
+var import_redis = __toESM(require("@keyv/redis"), 1);
+var import_promises = require("fs/promises");
+var import_node_fs = require("fs");
+
+// src/core/const.ts
+var DEFAULT_CONNECT_TIMEOUT_MS = 1e4;
+var DEFAULT_SOCKET_TIMEOUT_MS = 5e3;
+var TOKEN_WATCH_INTERVAL_MS = 6e5;
+var TOKEN_WATCH_DEBOUNCE_MS = 300;
+var CACHE_ERROR_CODE_UNAVAILABLE = "CACHE_SERVICE_UNAVAILABLE";
+
+// src/core/hooks.ts
+var import_keyv = require("keyv");
+function registerHooks(keyv, observable) {
+  const getStart = /* @__PURE__ */ new WeakMap();
+  const setStart = /* @__PURE__ */ new WeakMap();
+  const delStart = /* @__PURE__ */ new WeakMap();
+  keyv.hooks.addHandler(import_keyv.KeyvHooks.PRE_GET, (data) => {
+    getStart.set(data, Date.now());
+  });
+  keyv.hooks.addHandler(import_keyv.KeyvHooks.POST_GET, (data) => {
+    const started = getStart.get(data) ?? Date.now();
+    const result = data.value === void 0 ? "miss" : "hit";
+    observable.log("debug", "cache.read", {
+      event: "cache.read",
+      cache_key: data.key,
+      result,
+      duration_ms: Date.now() - started
+    });
+    getStart.delete(data);
+  });
+  keyv.hooks.addHandler(import_keyv.KeyvHooks.PRE_SET, (data) => {
+    setStart.set(data, Date.now());
+  });
+  keyv.hooks.addHandler(import_keyv.KeyvHooks.POST_SET, (data) => {
+    const started = setStart.get(data) ?? Date.now();
+    observable.log("debug", "cache.write", {
+      event: "cache.write",
+      cache_key: data.key,
+      duration_ms: Date.now() - started
+    });
+    setStart.delete(data);
+  });
+  keyv.hooks.addHandler(import_keyv.KeyvHooks.PRE_DELETE, (data) => {
+    delStart.set(data, Date.now());
+  });
+  keyv.hooks.addHandler(import_keyv.KeyvHooks.POST_DELETE, (data) => {
+    const started = delStart.get(data) ?? Date.now();
+    observable.log("debug", "cache.delete", {
+      event: "cache.delete",
+      cache_key: data.key,
+      duration_ms: Date.now() - started
+    });
+    delStart.delete(data);
+  });
+  keyv.on("error", (err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    observable.log("error", "cache.error", {
+      event: "cache.error",
+      error_code: CACHE_ERROR_CODE_UNAVAILABLE,
+      message
+    });
+  });
+}
+__name(registerHooks, "registerHooks");
+
+// src/core/cache-store.ts
+function createCacheStore(options) {
+  const { connectionString, connectionTokenFilePath, connectTimeoutMs = DEFAULT_CONNECT_TIMEOUT_MS, socketTimeoutMs = DEFAULT_SOCKET_TIMEOUT_MS, observable, logger } = options;
+  const manager = new StoreManager({
+    connectionString,
+    connectionTokenFilePath,
+    connectTimeoutMs,
+    socketTimeoutMs,
+    observable,
+    logger
+  });
+  const initialStore = manager.buildStore(null);
+  manager.setInitialStore(initialStore);
+  const keyv = new import_keyv2.default({
+    store: initialStore,
+    useKeyPrefix: false,
+    throwOnErrors: false
+  });
+  registerHooks(keyv, observable);
+  manager.attach(keyv);
+  manager.startTokenWatcher();
+  return {
+    keyv,
+    dispose: /* @__PURE__ */ __name(async () => {
+      manager.stopTokenWatcher();
+      await manager.disposeCurrentStore();
+    }, "dispose")
+  };
+}
+__name(createCacheStore, "createCacheStore");
+var StoreManager = class StoreManager2 {
+  static {
+    __name(this, "StoreManager");
+  }
+  config;
+  keyv = null;
+  currentStore = null;
+  currentToken = null;
+  currentResolvedConnectionString = null;
+  connectionOpPromise = null;
+  refreshing = false;
+  tokenWatchFilePath = null;
+  tokenWatchDebounceTimer = null;
+  constructor(config) {
+    this.config = config;
+  }
+  attach(keyv) {
+    this.keyv = keyv;
+  }
+  setInitialStore(store) {
+    this.currentStore = store;
+  }
+  /**
+  * 基于 connectionString + token 构造新 KeyvRedis
+  * 显式列出 socket 超时配置，保持默认值可读
+  */
+  buildStore(token) {
+    const resolvedConnectionString = this.appendTokenToConnectionString(this.config.connectionString, token);
+    const store = new import_redis.default({
+      url: resolvedConnectionString,
+      socket: {
+        connectTimeout: this.config.connectTimeoutMs,
+        // node-redis SocketOptions.socketTimeout：读写空闲超时
+        socketTimeout: this.config.socketTimeoutMs
+      }
+    }, {
+      // @keyv/redis 层的 connect 超时（覆盖 keyv 侧兜底）
+      connectionTimeout: this.config.connectTimeoutMs
+    });
+    this.currentToken = token;
+    this.currentResolvedConnectionString = resolvedConnectionString;
+    return store;
+  }
+  startTokenWatcher() {
+    const tokenPath = this.config.connectionTokenFilePath;
+    if (!tokenPath) {
+      return;
+    }
+    if (this.tokenWatchFilePath === tokenPath) {
+      return;
+    }
+    if (this.tokenWatchFilePath) {
+      (0, import_node_fs.unwatchFile)(this.tokenWatchFilePath);
+      this.tokenWatchFilePath = null;
+    }
+    (0, import_node_fs.watchFile)(tokenPath, {
+      interval: TOKEN_WATCH_INTERVAL_MS
+    }, () => {
+      this.scheduleTokenRefresh();
+    });
+    this.tokenWatchFilePath = tokenPath;
+  }
+  stopTokenWatcher() {
+    if (this.tokenWatchDebounceTimer) {
+      clearTimeout(this.tokenWatchDebounceTimer);
+      this.tokenWatchDebounceTimer = null;
+    }
+    if (this.tokenWatchFilePath) {
+      (0, import_node_fs.unwatchFile)(this.tokenWatchFilePath);
+      this.tokenWatchFilePath = null;
+    }
+  }
+  async disposeCurrentStore() {
+    await this.shutdownStoreSafely(this.currentStore);
+    this.currentStore = null;
+  }
+  scheduleTokenRefresh() {
+    if (this.tokenWatchDebounceTimer) {
+      clearTimeout(this.tokenWatchDebounceTimer);
+    }
+    this.tokenWatchDebounceTimer = setTimeout(() => {
+      void this.refreshIfTokenChanged();
+    }, TOKEN_WATCH_DEBOUNCE_MS);
+  }
+  async refreshIfTokenChanged() {
+    if (this.refreshing) {
+      return;
+    }
+    this.refreshing = true;
+    try {
+      await this.runWithLock(async () => {
+        const nextToken = await this.readTokenFromFile();
+        const nextResolvedConnectionString = this.appendTokenToConnectionString(this.config.connectionString, nextToken);
+        const sameToken = nextToken === this.currentToken;
+        const sameConnStr = nextResolvedConnectionString === this.currentResolvedConnectionString;
+        if (sameToken && sameConnStr) {
+          return;
+        }
+        const previousStore = this.currentStore;
+        const nextStore = this.buildStore(nextToken);
+        this.currentStore = nextStore;
+        if (this.keyv) {
+          this.keyv.store = nextStore;
+        }
+        await this.shutdownStoreSafely(previousStore);
+      });
+    } catch (err) {
+      this.config.logger?.error("Failed to refresh cache store from token file", err);
+      this.config.observable.log("error", "cache.error", {
+        event: "cache.error",
+        error_code: CACHE_ERROR_CODE_UNAVAILABLE,
+        message: err instanceof Error ? err.message : String(err)
+      });
+    } finally {
+      this.refreshing = false;
+    }
+  }
+  /**
+  * 单例锁：并发 refresh 只跑一次
+  */
+  runWithLock(operation) {
+    if (this.connectionOpPromise) {
+      return this.connectionOpPromise;
+    }
+    this.connectionOpPromise = (async () => {
+      try {
+        await operation();
+      } finally {
+        this.connectionOpPromise = null;
+      }
+    })();
+    return this.connectionOpPromise;
+  }
+  async readTokenFromFile() {
+    const tokenPath = this.config.connectionTokenFilePath;
+    if (!tokenPath) {
+      return null;
+    }
+    try {
+      const raw = await (0, import_promises.readFile)(tokenPath, "utf-8");
+      const trimmed = raw.trim();
+      return trimmed.length > 0 ? trimmed : null;
+    } catch (err) {
+      this.config.logger?.warn("cache-service: failed to read token file, falling back to previous token", {
+        tokenPath,
+        err
+      });
+      return null;
+    }
+  }
+  /**
+  * 追加 -c miaoda.zti_token=<token> 到 URL 的 options 参数
+  * 与 nestjs-datapaas 对齐
+  */
+  appendTokenToConnectionString(connectionString, token) {
+    if (!token) {
+      return connectionString;
+    }
+    let url;
+    try {
+      url = new URL(connectionString);
+    } catch (err) {
+      this.config.logger?.warn("cache-service: failed to parse connectionString, skipping token append", {
+        connectionString: redactConnectionString(connectionString),
+        err
+      });
+      return connectionString;
+    }
+    const currentOptions = url.searchParams.get("options") || "";
+    const optionsWithoutToken = currentOptions.replace(/(?:^|\s)-c\s+miaoda\.zti_token=[^\s]*/g, " ").replace(/\s+/g, " ").trim();
+    const tokenOption = `-c miaoda.zti_token=${token}`;
+    const nextOptions = [
+      optionsWithoutToken,
+      tokenOption
+    ].filter(Boolean).join(" ").trim();
+    url.searchParams.set("options", nextOptions);
+    return url.toString();
+  }
+  async shutdownStoreSafely(store) {
+    if (!store) {
+      return;
+    }
+    try {
+      const disconnectable = store;
+      if (typeof disconnectable.disconnect === "function") {
+        await disconnectable.disconnect();
+      }
+    } catch (err) {
+      this.config.logger?.error("Error shutting down previous KeyvRedis store", err);
+    }
+  }
+};
+function redactConnectionString(input) {
+  return input.replace(/(:\/\/[^:@/]*:)[^@/]*(@)/, "$1***$2");
+}
+__name(redactConnectionString, "redactConnectionString");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CACHE_ERROR_CODE_UNAVAILABLE,
+  DEFAULT_CONNECT_TIMEOUT_MS,
+  DEFAULT_SOCKET_TIMEOUT_MS,
+  TOKEN_WATCH_DEBOUNCE_MS,
+  TOKEN_WATCH_INTERVAL_MS,
+  createCacheStore,
+  registerHooks
+});
+//# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/index.ts","../../src/core/cache-store.ts","../../src/core/const.ts","../../src/core/hooks.ts"],"sourcesContent":["export { createCacheStore } from './cache-store';\nexport { registerHooks } from './hooks';\nexport {\n  CACHE_ERROR_CODE_UNAVAILABLE,\n  DEFAULT_CONNECT_TIMEOUT_MS,\n  DEFAULT_SOCKET_TIMEOUT_MS,\n  TOKEN_WATCH_DEBOUNCE_MS,\n  TOKEN_WATCH_INTERVAL_MS,\n} from './const';\nexport type {\n  CacheReadResult,\n  CacheStoreHandle,\n  CacheStoreOptions,\n  CacheTraceEvent,\n  LoggerAdapter,\n  ObservableAdapter,\n} from './types';\n","import Keyv from 'keyv';\nimport KeyvRedis from '@keyv/redis';\nimport { readFile } from 'node:fs/promises';\nimport { watchFile, unwatchFile } from 'node:fs';\n\nimport type {\n  CacheStoreHandle,\n  CacheStoreOptions,\n  LoggerAdapter,\n  ObservableAdapter,\n} from './types';\nimport {\n  CACHE_ERROR_CODE_UNAVAILABLE,\n  DEFAULT_CONNECT_TIMEOUT_MS,\n  DEFAULT_SOCKET_TIMEOUT_MS,\n  TOKEN_WATCH_DEBOUNCE_MS,\n  TOKEN_WATCH_INTERVAL_MS,\n} from './const';\nimport { registerHooks } from './hooks';\n\ntype AnyKeyvRedis = KeyvRedis<unknown>;\n\n/**\n * 构造一个带 hooks 上报与 token 热刷新能力的 Keyv 实例\n *\n * 关键设计：\n * - `forRoot` 只构造不握手，KeyvRedis 首次读写时才实际连接 Redis\n * - `connectionTokenFilePath` 存在时启动 watchFile 轮询 + 防抖 + 单例锁重建 store\n * - store 替换通过 `keyv.store = newStore` 完成，业务侧 DI 引用保持稳定\n */\nexport function createCacheStore(options: CacheStoreOptions): CacheStoreHandle {\n  const {\n    connectionString,\n    connectionTokenFilePath,\n    connectTimeoutMs = DEFAULT_CONNECT_TIMEOUT_MS,\n    socketTimeoutMs = DEFAULT_SOCKET_TIMEOUT_MS,\n    observable,\n    logger,\n  } = options;\n\n  const manager = new StoreManager({\n    connectionString,\n    connectionTokenFilePath,\n    connectTimeoutMs,\n    socketTimeoutMs,\n    observable,\n    logger,\n  });\n\n  const initialStore = manager.buildStore(null);\n  manager.setInitialStore(initialStore);\n  const keyv = new Keyv({\n    store: initialStore,\n    useKeyPrefix: false,\n    throwOnErrors: false,\n  });\n\n  registerHooks(keyv, observable);\n  manager.attach(keyv);\n  manager.startTokenWatcher();\n\n  return {\n    keyv,\n    dispose: async () => {\n      manager.stopTokenWatcher();\n      await manager.disposeCurrentStore();\n    },\n  };\n}\n\ninterface StoreManagerConfig {\n  connectionString: string;\n  connectionTokenFilePath?: string;\n  connectTimeoutMs: number;\n  socketTimeoutMs: number;\n  observable: ObservableAdapter;\n  logger?: LoggerAdapter;\n}\n\n/**\n * StoreManager\n *\n * 负责底层 KeyvRedis 的构造、token 热刷新、并发保护。\n * 骨架照搬 @lark-apaas/nestjs-datapaas 的 DrizzleDatabaseManager：\n * - watchFile 轮询 600 s 兜底\n * - 300 ms 防抖\n * - connectionOpPromise 单例锁\n */\nclass StoreManager {\n  private keyv: Keyv | null = null;\n  private currentStore: AnyKeyvRedis | null = null;\n  private currentToken: string | null = null;\n  private currentResolvedConnectionString: string | null = null;\n  private connectionOpPromise: Promise<void> | null = null;\n  private refreshing = false;\n\n  private tokenWatchFilePath: string | null = null;\n  private tokenWatchDebounceTimer: NodeJS.Timeout | null = null;\n\n  constructor(private readonly config: StoreManagerConfig) {}\n\n  attach(keyv: Keyv): void {\n    this.keyv = keyv;\n  }\n\n  setInitialStore(store: AnyKeyvRedis): void {\n    this.currentStore = store;\n  }\n\n  /**\n   * 基于 connectionString + token 构造新 KeyvRedis\n   * 显式列出 socket 超时配置，保持默认值可读\n   */\n  buildStore(token: string | null): AnyKeyvRedis {\n    const resolvedConnectionString = this.appendTokenToConnectionString(\n      this.config.connectionString,\n      token,\n    );\n\n    // @keyv/redis v5 直接接 RedisClientOptions；socket 层配置需要下沉到 clientOptions.socket\n    const store = new KeyvRedis(\n      {\n        url: resolvedConnectionString,\n        socket: {\n          connectTimeout: this.config.connectTimeoutMs,\n          // node-redis SocketOptions.socketTimeout：读写空闲超时\n          socketTimeout: this.config.socketTimeoutMs,\n        },\n      },\n      {\n        // @keyv/redis 层的 connect 超时（覆盖 keyv 侧兜底）\n        connectionTimeout: this.config.connectTimeoutMs,\n      },\n    );\n\n    this.currentToken = token;\n    this.currentResolvedConnectionString = resolvedConnectionString;\n    return store;\n  }\n\n  startTokenWatcher(): void {\n    const tokenPath = this.config.connectionTokenFilePath;\n    if (!tokenPath) {\n      return;\n    }\n    if (this.tokenWatchFilePath === tokenPath) {\n      return;\n    }\n    if (this.tokenWatchFilePath) {\n      unwatchFile(this.tokenWatchFilePath);\n      this.tokenWatchFilePath = null;\n    }\n\n    watchFile(tokenPath, { interval: TOKEN_WATCH_INTERVAL_MS }, () => {\n      this.scheduleTokenRefresh();\n    });\n    this.tokenWatchFilePath = tokenPath;\n  }\n\n  stopTokenWatcher(): void {\n    if (this.tokenWatchDebounceTimer) {\n      clearTimeout(this.tokenWatchDebounceTimer);\n      this.tokenWatchDebounceTimer = null;\n    }\n    if (this.tokenWatchFilePath) {\n      unwatchFile(this.tokenWatchFilePath);\n      this.tokenWatchFilePath = null;\n    }\n  }\n\n  async disposeCurrentStore(): Promise<void> {\n    await this.shutdownStoreSafely(this.currentStore);\n    this.currentStore = null;\n  }\n\n  private scheduleTokenRefresh(): void {\n    if (this.tokenWatchDebounceTimer) {\n      clearTimeout(this.tokenWatchDebounceTimer);\n    }\n    this.tokenWatchDebounceTimer = setTimeout(() => {\n      void this.refreshIfTokenChanged();\n    }, TOKEN_WATCH_DEBOUNCE_MS);\n  }\n\n  private async refreshIfTokenChanged(): Promise<void> {\n    if (this.refreshing) {\n      return;\n    }\n    this.refreshing = true;\n    try {\n      await this.runWithLock(async () => {\n        const nextToken = await this.readTokenFromFile();\n        const nextResolvedConnectionString = this.appendTokenToConnectionString(\n          this.config.connectionString,\n          nextToken,\n        );\n\n        const sameToken = nextToken === this.currentToken;\n        const sameConnStr =\n          nextResolvedConnectionString === this.currentResolvedConnectionString;\n        if (sameToken && sameConnStr) {\n          return;\n        }\n\n        const previousStore = this.currentStore;\n        const nextStore = this.buildStore(nextToken);\n        this.currentStore = nextStore;\n\n        if (this.keyv) {\n          this.keyv.store = nextStore;\n        }\n\n        await this.shutdownStoreSafely(previousStore);\n      });\n    } catch (err) {\n      this.config.logger?.error(\n        'Failed to refresh cache store from token file',\n        err,\n      );\n      this.config.observable.log('error', 'cache.error', {\n        event: 'cache.error',\n        error_code: CACHE_ERROR_CODE_UNAVAILABLE,\n        message: err instanceof Error ? err.message : String(err),\n      });\n    } finally {\n      this.refreshing = false;\n    }\n  }\n\n  /**\n   * 单例锁：并发 refresh 只跑一次\n   */\n  private runWithLock(operation: () => Promise<void>): Promise<void> {\n    if (this.connectionOpPromise) {\n      return this.connectionOpPromise;\n    }\n    this.connectionOpPromise = (async () => {\n      try {\n        await operation();\n      } finally {\n        this.connectionOpPromise = null;\n      }\n    })();\n    return this.connectionOpPromise;\n  }\n\n  private async readTokenFromFile(): Promise<string | null> {\n    const tokenPath = this.config.connectionTokenFilePath;\n    if (!tokenPath) {\n      return null;\n    }\n    try {\n      const raw = await readFile(tokenPath, 'utf-8');\n      const trimmed = raw.trim();\n      return trimmed.length > 0 ? trimmed : null;\n    } catch (err) {\n      this.config.logger?.warn(\n        'cache-service: failed to read token file, falling back to previous token',\n        { tokenPath, err },\n      );\n      return null;\n    }\n  }\n\n  /**\n   * 追加 -c miaoda.zti_token=<token> 到 URL 的 options 参数\n   * 与 nestjs-datapaas 对齐\n   */\n  private appendTokenToConnectionString(\n    connectionString: string,\n    token: string | null,\n  ): string {\n    if (!token) {\n      return connectionString;\n    }\n    let url: URL;\n    try {\n      url = new URL(connectionString);\n    } catch (err) {\n      this.config.logger?.warn(\n        'cache-service: failed to parse connectionString, skipping token append',\n        {\n          connectionString: redactConnectionString(connectionString),\n          err,\n        },\n      );\n      return connectionString;\n    }\n\n    const currentOptions = url.searchParams.get('options') || '';\n    const optionsWithoutToken = currentOptions\n      .replace(/(?:^|\\s)-c\\s+miaoda\\.zti_token=[^\\s]*/g, ' ')\n      .replace(/\\s+/g, ' ')\n      .trim();\n    const tokenOption = `-c miaoda.zti_token=${token}`;\n    const nextOptions = [optionsWithoutToken, tokenOption]\n      .filter(Boolean)\n      .join(' ')\n      .trim();\n\n    url.searchParams.set('options', nextOptions);\n    return url.toString();\n  }\n\n  private async shutdownStoreSafely(store: AnyKeyvRedis | null): Promise<void> {\n    if (!store) {\n      return;\n    }\n    try {\n      const disconnectable = store as unknown as { disconnect?: () => Promise<void> };\n      if (typeof disconnectable.disconnect === 'function') {\n        await disconnectable.disconnect();\n      }\n    } catch (err) {\n      this.config.logger?.error(\n        'Error shutting down previous KeyvRedis store',\n        err,\n      );\n    }\n  }\n}\n\n/**\n * 屏蔽 URL 中的 password 段，避免打 log 时泄漏凭据\n * redis://user:secret@host:6379 → redis://user:***@host:6379\n * 非法 URL 或无凭据时原样返回\n */\nfunction redactConnectionString(input: string): string {\n  return input.replace(/(:\\/\\/[^:@/]*:)[^@/]*(@)/, '$1***$2');\n}\n","export const DEFAULT_CONNECT_TIMEOUT_MS = 10_000;\nexport const DEFAULT_SOCKET_TIMEOUT_MS = 5_000;\n\nexport const TOKEN_WATCH_INTERVAL_MS = 600_000;\nexport const TOKEN_WATCH_DEBOUNCE_MS = 300;\n\nexport const CACHE_ERROR_CODE_UNAVAILABLE = 'CACHE_SERVICE_UNAVAILABLE';\n","import Keyv, { KeyvHooks } from 'keyv';\nimport type { CacheReadResult, ObservableAdapter } from './types';\nimport { CACHE_ERROR_CODE_UNAVAILABLE } from './const';\n\n/**\n * 给 keyv 实例挂 hooks + error 监听，将缓存事件桥接到 Observable\n *\n * 事件契约：\n * - cache.read: cache_key / result(hit|miss) / duration_ms\n * - cache.write: cache_key / duration_ms\n * - cache.delete: cache_key / duration_ms\n * - cache.error: error_code / message\n */\nexport function registerHooks(keyv: Keyv, observable: ObservableAdapter): void {\n  const getStart = new WeakMap<object, number>();\n  const setStart = new WeakMap<object, number>();\n  const delStart = new WeakMap<object, number>();\n\n  keyv.hooks.addHandler(KeyvHooks.PRE_GET, (data: { key: string }) => {\n    getStart.set(data, Date.now());\n  });\n\n  keyv.hooks.addHandler(KeyvHooks.POST_GET, (data: { key: string; value: unknown }) => {\n    const started = getStart.get(data) ?? Date.now();\n    const result: CacheReadResult = data.value === undefined ? 'miss' : 'hit';\n    observable.log('debug', 'cache.read', {\n      event: 'cache.read',\n      cache_key: data.key,\n      result,\n      duration_ms: Date.now() - started,\n    });\n    getStart.delete(data);\n  });\n\n  keyv.hooks.addHandler(KeyvHooks.PRE_SET, (data: { key: string; value: unknown; ttl?: number }) => {\n    setStart.set(data, Date.now());\n  });\n\n  keyv.hooks.addHandler(KeyvHooks.POST_SET, (data: { key: string; value: unknown; ttl?: number }) => {\n    const started = setStart.get(data) ?? Date.now();\n    observable.log('debug', 'cache.write', {\n      event: 'cache.write',\n      cache_key: data.key,\n      duration_ms: Date.now() - started,\n    });\n    setStart.delete(data);\n  });\n\n  keyv.hooks.addHandler(KeyvHooks.PRE_DELETE, (data: { key: string }) => {\n    delStart.set(data, Date.now());\n  });\n\n  keyv.hooks.addHandler(KeyvHooks.POST_DELETE, (data: { key: string; value: unknown }) => {\n    const started = delStart.get(data) ?? Date.now();\n    observable.log('debug', 'cache.delete', {\n      event: 'cache.delete',\n      cache_key: data.key,\n      duration_ms: Date.now() - started,\n    });\n    delStart.delete(data);\n  });\n\n  keyv.on('error', (err: unknown) => {\n    const message = err instanceof Error ? err.message : String(err);\n    observable.log('error', 'cache.error', {\n      event: 'cache.error',\n      error_code: CACHE_ERROR_CODE_UNAVAILABLE,\n      message,\n    });\n  });\n}\n"],"mappings":"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","names":["import_keyv","DEFAULT_CONNECT_TIMEOUT_MS","DEFAULT_SOCKET_TIMEOUT_MS","TOKEN_WATCH_INTERVAL_MS","TOKEN_WATCH_DEBOUNCE_MS","CACHE_ERROR_CODE_UNAVAILABLE","registerHooks","keyv","observable","getStart","WeakMap","setStart","delStart","hooks","addHandler","KeyvHooks","PRE_GET","data","set","Date","now","POST_GET","started","get","result","value","undefined","log","event","cache_key","key","duration_ms","delete","PRE_SET","POST_SET","PRE_DELETE","POST_DELETE","on","err","message","Error","String","error_code","CACHE_ERROR_CODE_UNAVAILABLE","createCacheStore","options","connectionString","connectionTokenFilePath","connectTimeoutMs","DEFAULT_CONNECT_TIMEOUT_MS","socketTimeoutMs","DEFAULT_SOCKET_TIMEOUT_MS","observable","logger","manager","StoreManager","initialStore","buildStore","setInitialStore","keyv","Keyv","store","useKeyPrefix","throwOnErrors","registerHooks","attach","startTokenWatcher","dispose","stopTokenWatcher","disposeCurrentStore","currentStore","currentToken","currentResolvedConnectionString","connectionOpPromise","refreshing","tokenWatchFilePath","tokenWatchDebounceTimer","config","token","resolvedConnectionString","appendTokenToConnectionString","KeyvRedis","url","socket","connectTimeout","socketTimeout","connectionTimeout","tokenPath","unwatchFile","watchFile","interval","TOKEN_WATCH_INTERVAL_MS","scheduleTokenRefresh","clearTimeout","shutdownStoreSafely","setTimeout","refreshIfTokenChanged","TOKEN_WATCH_DEBOUNCE_MS","runWithLock","nextToken","readTokenFromFile","nextResolvedConnectionString","sameToken","sameConnStr","previousStore","nextStore","err","error","log","event","error_code","CACHE_ERROR_CODE_UNAVAILABLE","message","Error","String","operation","raw","readFile","trimmed","trim","length","warn","URL","redactConnectionString","currentOptions","searchParams","get","optionsWithoutToken","replace","tokenOption","nextOptions","filter","Boolean","join","set","toString","disconnectable","disconnect","input"]}

package/dist/core/index.d.cts

@@ -0,0 +1,32 @@
+import { C as CacheStoreOptions, a as CacheStoreHandle, O as ObservableAdapter } from '../types-CFj87Od0.cjs';
+export { b as CacheReadResult, c as CacheTraceEvent, L as LoggerAdapter } from '../types-CFj87Od0.cjs';
+import Keyv from 'keyv';
+
+/**
+ * 构造一个带 hooks 上报与 token 热刷新能力的 Keyv 实例
+ *
+ * 关键设计：
+ * - `forRoot` 只构造不握手，KeyvRedis 首次读写时才实际连接 Redis
+ * - `connectionTokenFilePath` 存在时启动 watchFile 轮询 + 防抖 + 单例锁重建 store
+ * - store 替换通过 `keyv.store = newStore` 完成，业务侧 DI 引用保持稳定
+ */
+declare function createCacheStore(options: CacheStoreOptions): CacheStoreHandle;
+
+/**
+ * 给 keyv 实例挂 hooks + error 监听，将缓存事件桥接到 Observable
+ *
+ * 事件契约：
+ * - cache.read: cache_key / result(hit|miss) / duration_ms
+ * - cache.write: cache_key / duration_ms
+ * - cache.delete: cache_key / duration_ms
+ * - cache.error: error_code / message
+ */
+declare function registerHooks(keyv: Keyv, observable: ObservableAdapter): void;
+
+declare const DEFAULT_CONNECT_TIMEOUT_MS = 10000;
+declare const DEFAULT_SOCKET_TIMEOUT_MS = 5000;
+declare const TOKEN_WATCH_INTERVAL_MS = 600000;
+declare const TOKEN_WATCH_DEBOUNCE_MS = 300;
+declare const CACHE_ERROR_CODE_UNAVAILABLE = "CACHE_SERVICE_UNAVAILABLE";
+
+export { CACHE_ERROR_CODE_UNAVAILABLE, CacheStoreHandle, CacheStoreOptions, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_SOCKET_TIMEOUT_MS, ObservableAdapter, TOKEN_WATCH_DEBOUNCE_MS, TOKEN_WATCH_INTERVAL_MS, createCacheStore, registerHooks };

package/dist/core/index.d.ts

@@ -0,0 +1,32 @@
+import { C as CacheStoreOptions, a as CacheStoreHandle, O as ObservableAdapter } from '../types-CFj87Od0.js';
+export { b as CacheReadResult, c as CacheTraceEvent, L as LoggerAdapter } from '../types-CFj87Od0.js';
+import Keyv from 'keyv';
+
+/**
+ * 构造一个带 hooks 上报与 token 热刷新能力的 Keyv 实例
+ *
+ * 关键设计：
+ * - `forRoot` 只构造不握手，KeyvRedis 首次读写时才实际连接 Redis
+ * - `connectionTokenFilePath` 存在时启动 watchFile 轮询 + 防抖 + 单例锁重建 store
+ * - store 替换通过 `keyv.store = newStore` 完成，业务侧 DI 引用保持稳定
+ */
+declare function createCacheStore(options: CacheStoreOptions): CacheStoreHandle;
+
+/**
+ * 给 keyv 实例挂 hooks + error 监听，将缓存事件桥接到 Observable
+ *
+ * 事件契约：
+ * - cache.read: cache_key / result(hit|miss) / duration_ms
+ * - cache.write: cache_key / duration_ms
+ * - cache.delete: cache_key / duration_ms
+ * - cache.error: error_code / message
+ */
+declare function registerHooks(keyv: Keyv, observable: ObservableAdapter): void;
+
+declare const DEFAULT_CONNECT_TIMEOUT_MS = 10000;
+declare const DEFAULT_SOCKET_TIMEOUT_MS = 5000;
+declare const TOKEN_WATCH_INTERVAL_MS = 600000;
+declare const TOKEN_WATCH_DEBOUNCE_MS = 300;
+declare const CACHE_ERROR_CODE_UNAVAILABLE = "CACHE_SERVICE_UNAVAILABLE";
+
+export { CACHE_ERROR_CODE_UNAVAILABLE, CacheStoreHandle, CacheStoreOptions, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_SOCKET_TIMEOUT_MS, ObservableAdapter, TOKEN_WATCH_DEBOUNCE_MS, TOKEN_WATCH_INTERVAL_MS, createCacheStore, registerHooks };

package/dist/core/index.js

@@ -0,0 +1,19 @@
+import {
+  CACHE_ERROR_CODE_UNAVAILABLE,
+  DEFAULT_CONNECT_TIMEOUT_MS,
+  DEFAULT_SOCKET_TIMEOUT_MS,
+  TOKEN_WATCH_DEBOUNCE_MS,
+  TOKEN_WATCH_INTERVAL_MS,
+  createCacheStore,
+  registerHooks
+} from "../chunk-BSJRPCEN.js";
+export {
+  CACHE_ERROR_CODE_UNAVAILABLE,
+  DEFAULT_CONNECT_TIMEOUT_MS,
+  DEFAULT_SOCKET_TIMEOUT_MS,
+  TOKEN_WATCH_DEBOUNCE_MS,
+  TOKEN_WATCH_INTERVAL_MS,
+  createCacheStore,
+  registerHooks
+};
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}