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

package/LICENSE

@@ -0,0 +1,13 @@
+MIT License
+
+Copyright (c) 2026 Lark Technologies Pte. Ltd. and/or its affiliates
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted,provided that the above copyright notice and this permission notice appear in all copies.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
+INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO
+EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
+CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# @lark-apaas/cache-service
+
+FullStack 应用运行时缓存 SDK。当前提供 NestJS 装配层，`core/` 层框架无关，未来可无缝接入 Express。
+
+## 使用
+
+`PlatformModule` 已默认挂载 `NestjsCacheModule`，业务代码直接注入 `CACHE_MANAGER` 即可：
+
+```ts
+import { Inject, Injectable } from '@nestjs/common';
+import { CACHE_MANAGER } from '@nestjs/cache-manager';
+import type { Cache } from 'cache-manager';
+
+@Injectable()
+export class MyService {
+  constructor(@Inject(CACHE_MANAGER) private readonly cache: Cache) {}
+
+  async getUser(id: string) {
+    return this.cache.wrap(`user:${id}`, () => this.fetchUser(id), 60_000);
+  }
+}
+```
+
+## Trace 事件
+
+SDK 通过 `@lark-apaas/nestjs-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` |
+
+## 环境变量
+
+| 变量 | 说明 |
+|---|---|
+| `SUDA_CACHE_URL` | Redis 协议连接串，由 PlatformModule 装配层读取传入 |
+
+## 手动装配（非 PlatformModule 场景）
+
+```ts
+import { NestjsCacheModule } from '@lark-apaas/cache-service/nestjs';
+
+@Module({
+  imports: [
+    NestjsCacheModule.forRootAsync({
+      imports: [LoggerModule],
+      inject: [AppLogger],
+      useFactory: () => ({
+        connectionString: process.env.SUDA_CACHE_URL!,
+        connectionTokenFilePath: '/var/run/secrets/zti/credential',
+      }),
+    }),
+  ],
+})
+export class AppModule {}
+```

package/dist/chunk-BSJRPCEN.js

@@ -0,0 +1,307 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// 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
+import { KeyvHooks } from "keyv";
+function registerHooks(keyv, observable) {
+  const getStart = /* @__PURE__ */ new WeakMap();
+  const setStart = /* @__PURE__ */ new WeakMap();
+  const delStart = /* @__PURE__ */ new WeakMap();
+  keyv.hooks.addHandler(KeyvHooks.PRE_GET, (data) => {
+    getStart.set(data, Date.now());
+  });
+  keyv.hooks.addHandler(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(KeyvHooks.PRE_SET, (data) => {
+    setStart.set(data, Date.now());
+  });
+  keyv.hooks.addHandler(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(KeyvHooks.PRE_DELETE, (data) => {
+    delStart.set(data, Date.now());
+  });
+  keyv.hooks.addHandler(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
+import Keyv from "keyv";
+import KeyvRedis from "@keyv/redis";
+import { readFile } from "fs/promises";
+import { watchFile, unwatchFile } from "fs";
+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 Keyv({
+    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 KeyvRedis({
+      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) {
+      unwatchFile(this.tokenWatchFilePath);
+      this.tokenWatchFilePath = null;
+    }
+    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) {
+      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 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");
+
+export {
+  __name,
+  DEFAULT_CONNECT_TIMEOUT_MS,
+  DEFAULT_SOCKET_TIMEOUT_MS,
+  TOKEN_WATCH_INTERVAL_MS,
+  TOKEN_WATCH_DEBOUNCE_MS,
+  CACHE_ERROR_CODE_UNAVAILABLE,
+  registerHooks,
+  createCacheStore
+};
+//# sourceMappingURL=chunk-BSJRPCEN.js.map

package/dist/chunk-BSJRPCEN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/const.ts","../src/core/hooks.ts","../src/core/cache-store.ts"],"sourcesContent":["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","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"],"mappings":"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","names":["DEFAULT_CONNECT_TIMEOUT_MS","DEFAULT_SOCKET_TIMEOUT_MS","TOKEN_WATCH_INTERVAL_MS","TOKEN_WATCH_DEBOUNCE_MS","CACHE_ERROR_CODE_UNAVAILABLE","KeyvHooks","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","Keyv","KeyvRedis","readFile","watchFile","unwatchFile","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/chunk-SSW7W3K6.js

@@ -0,0 +1,225 @@
+import {
+  DEFAULT_CONNECT_TIMEOUT_MS,
+  DEFAULT_SOCKET_TIMEOUT_MS,
+  __name,
+  createCacheStore
+} from "./chunk-BSJRPCEN.js";
+
+// src/nestjs/nestjs-cache.module.ts
+import { Global, Inject, Module } from "@nestjs/common";
+import { CacheModule } from "@nestjs/cache-manager";
+import { OBSERVABLE_SERVICE, RequestContextService } from "@lark-apaas/nestjs-common";
+import { AppLogger } from "@lark-apaas/nestjs-logger";
+import { Observable } from "@lark-apaas/nestjs-observable";
+
+// src/nestjs/const.ts
+var NESTJS_CACHE_OPTIONS = /* @__PURE__ */ Symbol("NESTJS_CACHE_OPTIONS");
+var CACHE_STORE_HANDLE = /* @__PURE__ */ Symbol("CACHE_STORE_HANDLE");
+var CACHE_OBSERVABLE_ADAPTER = /* @__PURE__ */ Symbol("CACHE_OBSERVABLE_ADAPTER");
+var CACHE_LOGGER_ADAPTER = /* @__PURE__ */ Symbol("CACHE_LOGGER_ADAPTER");
+
+// src/nestjs/nestjs-cache.module.ts
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+function _ts_param(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param, "_ts_param");
+var NestjsCacheCoreModule = class NestjsCacheCoreModule2 {
+  static {
+    __name(this, "NestjsCacheCoreModule");
+  }
+  static forRoot(optionsProvider, imports) {
+    return {
+      module: NestjsCacheCoreModule2,
+      imports,
+      providers: [
+        optionsProvider,
+        {
+          provide: CACHE_OBSERVABLE_ADAPTER,
+          useFactory: /* @__PURE__ */ __name((observable, rtx) => {
+            const impl = observable ?? new Observable(rtx);
+            return {
+              log(level, event, attrs) {
+                impl.log(level, event, attrs);
+              }
+            };
+          }, "useFactory"),
+          inject: [
+            {
+              token: OBSERVABLE_SERVICE,
+              optional: true
+            },
+            RequestContextService
+          ]
+        },
+        {
+          provide: CACHE_LOGGER_ADAPTER,
+          useFactory: /* @__PURE__ */ __name((appLogger) => {
+            if (!appLogger) {
+              return {
+                warn: /* @__PURE__ */ __name((msg) => console.warn(msg), "warn"),
+                error: /* @__PURE__ */ __name((msg, err) => console.error(msg, err), "error")
+              };
+            }
+            return {
+              warn: /* @__PURE__ */ __name((msg) => appLogger.warn(msg), "warn"),
+              error: /* @__PURE__ */ __name((msg, err) => appLogger.error(msg, err), "error")
+            };
+          }, "useFactory"),
+          inject: [
+            {
+              token: AppLogger,
+              optional: true
+            }
+          ]
+        },
+        {
+          provide: CACHE_STORE_HANDLE,
+          useFactory: /* @__PURE__ */ __name((opts, observable, logger) => createCacheStore({
+            connectionString: opts.connectionString,
+            connectionTokenFilePath: opts.connectionTokenFilePath,
+            connectTimeoutMs: opts.connectTimeoutMs,
+            socketTimeoutMs: opts.socketTimeoutMs,
+            observable,
+            logger
+          }), "useFactory"),
+          inject: [
+            NESTJS_CACHE_OPTIONS,
+            CACHE_OBSERVABLE_ADAPTER,
+            CACHE_LOGGER_ADAPTER
+          ]
+        }
+      ],
+      exports: [
+        CACHE_STORE_HANDLE,
+        NESTJS_CACHE_OPTIONS
+      ]
+    };
+  }
+};
+NestjsCacheCoreModule = _ts_decorate([
+  Global(),
+  Module({})
+], NestjsCacheCoreModule);
+var NestjsCacheModule = class _NestjsCacheModule {
+  static {
+    __name(this, "NestjsCacheModule");
+  }
+  storeHandle;
+  constructor(storeHandle) {
+    this.storeHandle = storeHandle;
+  }
+  async onApplicationShutdown() {
+    await this.storeHandle.dispose();
+  }
+  /**
+  * 同步注册
+  */
+  static forRoot(options) {
+    const coreModule = NestjsCacheCoreModule.forRoot({
+      provide: NESTJS_CACHE_OPTIONS,
+      useValue: normalizeOptions(options)
+    }, []);
+    return {
+      module: _NestjsCacheModule,
+      imports: [
+        coreModule,
+        CacheModule.registerAsync({
+          isGlobal: true,
+          imports: [
+            coreModule
+          ],
+          inject: [
+            CACHE_STORE_HANDLE
+          ],
+          useFactory: /* @__PURE__ */ __name((handle) => ({
+            stores: [
+              handle.keyv
+            ]
+          }), "useFactory")
+        })
+      ],
+      exports: [
+        CacheModule,
+        coreModule
+      ]
+    };
+  }
+  /**
+  * 异步注册（从 ConfigService 等异步源读配置）
+  */
+  static forRootAsync(options) {
+    const optionsProvider = {
+      provide: NESTJS_CACHE_OPTIONS,
+      useFactory: /* @__PURE__ */ __name(async (...args) => {
+        const raw = await options.useFactory(...args);
+        return normalizeOptions(raw);
+      }, "useFactory"),
+      inject: options.inject ?? []
+    };
+    const coreModule = NestjsCacheCoreModule.forRoot(optionsProvider, options.imports ?? []);
+    return {
+      module: _NestjsCacheModule,
+      imports: [
+        coreModule,
+        CacheModule.registerAsync({
+          isGlobal: true,
+          imports: [
+            coreModule
+          ],
+          inject: [
+            CACHE_STORE_HANDLE
+          ],
+          useFactory: /* @__PURE__ */ __name((handle) => ({
+            stores: [
+              handle.keyv
+            ]
+          }), "useFactory")
+        })
+      ],
+      exports: [
+        CacheModule,
+        coreModule
+      ]
+    };
+  }
+};
+NestjsCacheModule = _ts_decorate([
+  Global(),
+  Module({}),
+  _ts_param(0, Inject(CACHE_STORE_HANDLE)),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof CacheStoreHandle === "undefined" ? Object : CacheStoreHandle
+  ])
+], NestjsCacheModule);
+function normalizeOptions(options) {
+  return {
+    connectionString: options.connectionString,
+    connectionTokenFilePath: options.connectionTokenFilePath,
+    connectTimeoutMs: options.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS,
+    socketTimeoutMs: options.socketTimeoutMs ?? DEFAULT_SOCKET_TIMEOUT_MS
+  };
+}
+__name(normalizeOptions, "normalizeOptions");
+
+export {
+  NESTJS_CACHE_OPTIONS,
+  CACHE_STORE_HANDLE,
+  CACHE_OBSERVABLE_ADAPTER,
+  CACHE_LOGGER_ADAPTER,
+  NestjsCacheModule
+};
+//# sourceMappingURL=chunk-SSW7W3K6.js.map

package/dist/chunk-SSW7W3K6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nestjs/nestjs-cache.module.ts","../src/nestjs/const.ts"],"sourcesContent":["import {\n  DynamicModule,\n  Global,\n  Inject,\n  InjectionToken,\n  Module,\n  ModuleMetadata,\n  OnApplicationShutdown,\n  Provider,\n} from '@nestjs/common';\nimport { CacheModule } from '@nestjs/cache-manager';\nimport {\n  OBSERVABLE_SERVICE,\n  RequestContextService,\n  type ObservableService,\n} from '@lark-apaas/nestjs-common';\nimport { AppLogger } from '@lark-apaas/nestjs-logger';\nimport { Observable } from '@lark-apaas/nestjs-observable';\n\nimport { createCacheStore } from '../core/cache-store';\nimport {\n  DEFAULT_CONNECT_TIMEOUT_MS,\n  DEFAULT_SOCKET_TIMEOUT_MS,\n} from '../core/const';\nimport type {\n  CacheStoreHandle,\n  LoggerAdapter,\n  ObservableAdapter,\n} from '../core/types';\nimport {\n  CACHE_LOGGER_ADAPTER,\n  CACHE_OBSERVABLE_ADAPTER,\n  CACHE_STORE_HANDLE,\n  NESTJS_CACHE_OPTIONS,\n} from './const';\n\n/**\n * 用户传入的运行时配置\n */\nexport interface NestjsCacheModuleOptions {\n  /**\n   * Redis 连接串（redis:// 或 rediss://）\n   */\n  connectionString: string;\n  /**\n   * ZTI Token 文件路径。存在则启动 watchFile 热刷新。\n   */\n  connectionTokenFilePath?: string;\n  /**\n   * Socket connect timeout（毫秒）。默认 10_000。\n   */\n  connectTimeoutMs?: number;\n  /**\n   * Socket idle timeout（毫秒）。默认 5_000。\n   */\n  socketTimeoutMs?: number;\n}\n\n/**\n * 异步配置选项\n */\nexport interface NestjsCacheModuleAsyncOptions {\n  imports?: ModuleMetadata['imports'];\n  useFactory: (\n    ...args: unknown[]\n  ) => Promise<NestjsCacheModuleOptions> | NestjsCacheModuleOptions;\n  inject?: InjectionToken[];\n}\n\n/**\n * 内部核心模块：只负责组装 options + adapters + CACHE_STORE_HANDLE 三层 provider，\n * 并 export 给 CacheModule 通过 imports 消费。\n *\n * 拆出独立 module 的原因：NestJS DynamicModule 里放在 imports 中的 CacheModule\n * 无法看到同级 providers 定义的 token，必须走 module-to-module 的 exports 链路。\n */\n@Global()\n@Module({})\nclass NestjsCacheCoreModule {\n  static forRoot(\n    optionsProvider: Provider,\n    imports: ModuleMetadata['imports'],\n  ): DynamicModule {\n    return {\n      module: NestjsCacheCoreModule,\n      imports,\n      providers: [\n        optionsProvider,\n        {\n          provide: CACHE_OBSERVABLE_ADAPTER,\n          useFactory: (\n            observable: ObservableService | null,\n            rtx: RequestContextService,\n          ): ObservableAdapter => {\n            const impl = observable ?? new Observable(rtx);\n            return {\n              log(level, event, attrs) {\n                impl.log(level, event, attrs);\n              },\n            };\n          },\n          inject: [\n            { token: OBSERVABLE_SERVICE, optional: true },\n            RequestContextService,\n          ],\n        },\n        {\n          provide: CACHE_LOGGER_ADAPTER,\n          useFactory: (appLogger: AppLogger | null): LoggerAdapter => {\n            if (!appLogger) {\n              return {\n                warn: (msg) => console.warn(msg),\n                error: (msg, err) => console.error(msg, err),\n              };\n            }\n            return {\n              warn: (msg) => appLogger.warn(msg),\n              error: (msg, err) => appLogger.error(msg, err),\n            };\n          },\n          inject: [{ token: AppLogger, optional: true }],\n        },\n        {\n          provide: CACHE_STORE_HANDLE,\n          useFactory: (\n            opts: NestjsCacheModuleOptions,\n            observable: ObservableAdapter,\n            logger: LoggerAdapter,\n          ): CacheStoreHandle =>\n            createCacheStore({\n              connectionString: opts.connectionString,\n              connectionTokenFilePath: opts.connectionTokenFilePath,\n              connectTimeoutMs: opts.connectTimeoutMs,\n              socketTimeoutMs: opts.socketTimeoutMs,\n              observable,\n              logger,\n            }),\n          inject: [\n            NESTJS_CACHE_OPTIONS,\n            CACHE_OBSERVABLE_ADAPTER,\n            CACHE_LOGGER_ADAPTER,\n          ],\n        },\n      ],\n      exports: [CACHE_STORE_HANDLE, NESTJS_CACHE_OPTIONS],\n    };\n  }\n}\n\n@Global()\n@Module({})\nexport class NestjsCacheModule implements OnApplicationShutdown {\n  constructor(\n    @Inject(CACHE_STORE_HANDLE)\n    private readonly storeHandle: CacheStoreHandle,\n  ) {}\n\n  async onApplicationShutdown(): Promise<void> {\n    await this.storeHandle.dispose();\n  }\n\n  /**\n   * 同步注册\n   */\n  static forRoot(options: NestjsCacheModuleOptions): DynamicModule {\n    const coreModule = NestjsCacheCoreModule.forRoot(\n      {\n        provide: NESTJS_CACHE_OPTIONS,\n        useValue: normalizeOptions(options),\n      },\n      [],\n    );\n\n    return {\n      module: NestjsCacheModule,\n      imports: [\n        coreModule,\n        CacheModule.registerAsync({\n          isGlobal: true,\n          imports: [coreModule],\n          inject: [CACHE_STORE_HANDLE],\n          useFactory: (handle: CacheStoreHandle) => ({\n            stores: [handle.keyv],\n          }),\n        }),\n      ],\n      exports: [CacheModule, coreModule],\n    };\n  }\n\n  /**\n   * 异步注册（从 ConfigService 等异步源读配置）\n   */\n  static forRootAsync(options: NestjsCacheModuleAsyncOptions): DynamicModule {\n    const optionsProvider: Provider = {\n      provide: NESTJS_CACHE_OPTIONS,\n      useFactory: async (...args: unknown[]) => {\n        const raw = await options.useFactory(...args);\n        return normalizeOptions(raw);\n      },\n      inject: options.inject ?? [],\n    };\n\n    const coreModule = NestjsCacheCoreModule.forRoot(\n      optionsProvider,\n      options.imports ?? [],\n    );\n\n    return {\n      module: NestjsCacheModule,\n      imports: [\n        coreModule,\n        CacheModule.registerAsync({\n          isGlobal: true,\n          imports: [coreModule],\n          inject: [CACHE_STORE_HANDLE],\n          useFactory: (handle: CacheStoreHandle) => ({\n            stores: [handle.keyv],\n          }),\n        }),\n      ],\n      exports: [CacheModule, coreModule],\n    };\n  }\n}\n\n/**\n * 应用默认值\n */\nfunction normalizeOptions(\n  options: NestjsCacheModuleOptions,\n): NestjsCacheModuleOptions {\n  return {\n    connectionString: options.connectionString,\n    connectionTokenFilePath: options.connectionTokenFilePath,\n    connectTimeoutMs: options.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS,\n    socketTimeoutMs: options.socketTimeoutMs ?? DEFAULT_SOCKET_TIMEOUT_MS,\n  };\n}\n","/**\n * @lark-apaas/cache-service - NestJS 层 DI tokens\n */\n\nexport const NESTJS_CACHE_OPTIONS = Symbol('NESTJS_CACHE_OPTIONS');\n\nexport const CACHE_STORE_HANDLE = Symbol('CACHE_STORE_HANDLE');\n\nexport const CACHE_OBSERVABLE_ADAPTER = Symbol('CACHE_OBSERVABLE_ADAPTER');\n\nexport const CACHE_LOGGER_ADAPTER = Symbol('CACHE_LOGGER_ADAPTER');\n"],"mappings":"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","names":["Global","Inject","Module","CacheModule","OBSERVABLE_SERVICE","RequestContextService","AppLogger","Observable","NESTJS_CACHE_OPTIONS","Symbol","CACHE_STORE_HANDLE","CACHE_OBSERVABLE_ADAPTER","CACHE_LOGGER_ADAPTER","NestjsCacheCoreModule","forRoot","optionsProvider","imports","module","providers","provide","CACHE_OBSERVABLE_ADAPTER","useFactory","observable","rtx","impl","Observable","log","level","event","attrs","inject","token","OBSERVABLE_SERVICE","optional","RequestContextService","CACHE_LOGGER_ADAPTER","appLogger","warn","msg","console","error","err","AppLogger","CACHE_STORE_HANDLE","opts","logger","createCacheStore","connectionString","connectionTokenFilePath","connectTimeoutMs","socketTimeoutMs","NESTJS_CACHE_OPTIONS","exports","NestjsCacheModule","storeHandle","onApplicationShutdown","dispose","options","coreModule","useValue","normalizeOptions","CacheModule","registerAsync","isGlobal","handle","stores","keyv","forRootAsync","args","raw","DEFAULT_CONNECT_TIMEOUT_MS","DEFAULT_SOCKET_TIMEOUT_MS"]}