@lytjs/cache 6.8.0 → 6.9.0

package/dist/index.cjs

@@ -0,0 +1,278 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MemoryCache: () => MemoryCache,
+  MultiLayerCache: () => MultiLayerCache,
+  createCache: () => createCache,
+  getDefaultCache: () => getDefaultCache
+});
+module.exports = __toCommonJS(index_exports);
+var DEFAULT_TTL = 36e5;
+var MAX_SIZE = 100 * 1024 * 1024;
+var MemoryCache = class {
+  constructor(options = {}) {
+    this.cache = /* @__PURE__ */ new Map();
+    this.tagIndex = /* @__PURE__ */ new Map();
+    this.stats = {
+      size: 0,
+      totalSize: 0,
+      hits: 0,
+      misses: 0,
+      hitRate: 0
+    };
+    this.defaultTTL = options.ttl ?? DEFAULT_TTL;
+    this.maxSize = options.maxSize ?? MAX_SIZE;
+  }
+  async get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      this.stats.misses++;
+      this.updateHitRate();
+      return void 0;
+    }
+    const now = Date.now();
+    if (entry.expiresAt < now) {
+      this.delete(key);
+      this.stats.misses++;
+      this.updateHitRate();
+      return void 0;
+    }
+    this.stats.hits++;
+    this.updateHitRate();
+    return entry.value;
+  }
+  async set(key, value, options = {}) {
+    const now = Date.now();
+    const ttl = options.ttl ?? this.defaultTTL;
+    const tags = options.tags ?? [];
+    const size = this.calculateSize(value);
+    if (this.stats.totalSize + size > this.maxSize) {
+      this.evictOldest();
+    }
+    const entry = {
+      value,
+      createdAt: now,
+      expiresAt: now + ttl,
+      tags,
+      size
+    };
+    this.cache.set(key, entry);
+    for (const tag of tags) {
+      if (!this.tagIndex.has(tag)) {
+        this.tagIndex.set(tag, /* @__PURE__ */ new Set());
+      }
+      this.tagIndex.get(tag).add(key);
+    }
+    this.stats.size = this.cache.size;
+    this.stats.totalSize += size;
+  }
+  async delete(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      return false;
+    }
+    for (const tag of entry.tags) {
+      const tagKeys = this.tagIndex.get(tag);
+      if (tagKeys) {
+        tagKeys.delete(key);
+        if (tagKeys.size === 0) {
+          this.tagIndex.delete(tag);
+        }
+      }
+    }
+    if (entry.size) {
+      this.stats.totalSize -= entry.size;
+    }
+    this.stats.size = this.cache.size - 1;
+    return this.cache.delete(key);
+  }
+  async has(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      return false;
+    }
+    if (Date.now() > entry.expiresAt) {
+      await this.delete(key);
+      return false;
+    }
+    return true;
+  }
+  async clear() {
+    this.cache.clear();
+    this.tagIndex.clear();
+    this.stats = {
+      size: 0,
+      totalSize: 0,
+      hits: 0,
+      misses: 0,
+      hitRate: 0
+    };
+  }
+  async invalidateTag(tag) {
+    const keys = this.tagIndex.get(tag);
+    if (!keys) {
+      return;
+    }
+    for (const key of keys) {
+      await this.delete(key);
+    }
+  }
+  async invalidateTags(tags) {
+    for (const tag of tags) {
+      await this.invalidateTag(tag);
+    }
+  }
+  async getStats() {
+    return { ...this.stats };
+  }
+  /**
+   * 计算值的大小（字节）
+   */
+  calculateSize(value) {
+    try {
+      const str = JSON.stringify(value);
+      return new TextEncoder().encode(str).length;
+    } catch {
+      return 100;
+    }
+  }
+  /**
+   * 淘汰最旧的条目
+   */
+  evictOldest() {
+    let oldestKey = null;
+    let oldestTime = Infinity;
+    for (const [key, entry] of this.cache) {
+      if (entry.createdAt < oldestTime) {
+        oldestTime = entry.createdAt;
+        oldestKey = key;
+      }
+    }
+    if (oldestKey) {
+      this.delete(oldestKey);
+    }
+  }
+  /**
+   * 更新命中率
+   */
+  updateHitRate() {
+    const total = this.stats.hits + this.stats.misses;
+    this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+  }
+};
+var MultiLayerCache = class {
+  constructor(config = {}) {
+    this.layers = [];
+    if (config.memory !== false) {
+      const memoryOptions = typeof config.memory === "object" ? config.memory : void 0;
+      this.layers.push(new MemoryCache(memoryOptions));
+    }
+    if (config.redis) {
+    }
+    if (config.http) {
+    }
+  }
+  async get(key) {
+    for (const layer of this.layers) {
+      const value = await layer.get(key);
+      if (value !== void 0) {
+        for (let i = 0; i < this.layers.indexOf(layer); i++) {
+          await this.layers[i].set(key, value);
+        }
+        return value;
+      }
+    }
+    return void 0;
+  }
+  async set(key, value, options) {
+    for (const layer of this.layers) {
+      await layer.set(key, value, options);
+    }
+  }
+  async delete(key) {
+    let result = false;
+    for (const layer of this.layers) {
+      const layerResult = await layer.delete(key);
+      if (layerResult) {
+        result = true;
+      }
+    }
+    return result;
+  }
+  async has(key) {
+    for (const layer of this.layers) {
+      if (await layer.has(key)) {
+        return true;
+      }
+    }
+    return false;
+  }
+  async clear() {
+    for (const layer of this.layers) {
+      await layer.clear();
+    }
+  }
+  async invalidateTag(tag) {
+    for (const layer of this.layers) {
+      await layer.invalidateTag(tag);
+    }
+  }
+  async invalidateTags(tags) {
+    for (const tag of tags) {
+      await this.invalidateTag(tag);
+    }
+  }
+  async getStats() {
+    const statsList = await Promise.all(this.layers.map((layer) => layer.getStats()));
+    const merged = {
+      size: statsList.reduce((sum, stat) => sum + stat.size, 0),
+      totalSize: statsList.reduce((sum, stat) => sum + stat.totalSize, 0),
+      hits: statsList.reduce((sum, stat) => sum + stat.hits, 0),
+      misses: statsList.reduce((sum, stat) => sum + stat.misses, 0),
+      hitRate: 0
+    };
+    const total = merged.hits + merged.misses;
+    merged.hitRate = total > 0 ? merged.hits / total : 0;
+    return merged;
+  }
+};
+function createCache(options) {
+  if (options?.type === "multi") {
+    return new MultiLayerCache(options.config);
+  }
+  return new MemoryCache(options?.config);
+}
+var defaultCache = null;
+function getDefaultCache() {
+  if (!defaultCache) {
+    defaultCache = new MemoryCache();
+  }
+  return defaultCache;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MemoryCache,
+  MultiLayerCache,
+  createCache,
+  getDefaultCache
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @lytjs/cache - 统一缓存系统入口\n *\n * 提供多层缓存（Memory → Redis → HTTP）支持，\n * 包含缓存标签、TTL、统计等功能。\n */\n\n/**\n * 缓存条目接口\n */\nexport interface CacheEntry<T = unknown> {\n  /** 缓存值 */\n  value: T;\n  /** 创建时间戳 */\n  createdAt: number;\n  /** 过期时间戳 */\n  expiresAt: number;\n  /** 缓存标签 */\n  tags: string[];\n  /** 数据大小（字节） */\n  size?: number;\n}\n\n/**\n * 缓存配置选项\n */\nexport interface CacheOptions {\n  /** 生存时间（毫秒） */\n  ttl?: number;\n  /** 缓存标签 */\n  tags?: string[];\n  /** 重新验证时间（毫秒） */\n  revalidate?: number;\n  /** 最大大小（字节） */\n  maxSize?: number;\n}\n\n/**\n * 统一缓存接口\n */\nexport interface Cache {\n  /**\n   * 获取缓存值\n   */\n  get<T>(key: string): Promise<T | undefined>;\n\n  /**\n   * 设置缓存值\n   */\n  set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;\n\n  /**\n   * 删除缓存值\n   */\n  delete(key: string): Promise<boolean>;\n\n  /**\n   * 检查缓存是否存在\n   */\n  has(key: string): Promise<boolean>;\n\n  /**\n   * 清除所有缓存\n   */\n  clear(): Promise<void>;\n\n  /**\n   * 按标签无效化缓存\n   */\n  invalidateTag(tag: string): Promise<void>;\n\n  /**\n   * 批量按标签无效化缓存\n   */\n  invalidateTags(tags: string[]): Promise<void>;\n\n  /**\n   * 获取缓存统计信息\n   */\n  getStats(): Promise<CacheStats>;\n}\n\n/**\n * 缓存统计信息\n */\nexport interface CacheStats {\n  /** 键的数量 */\n  size: number;\n  /** 总大小（字节） */\n  totalSize: number;\n  /** 命中次数 */\n  hits: number;\n  /** 未命中次数 */\n  misses: number;\n  /** 命中率 */\n  hitRate: number;\n}\n\n/**\n * 多层缓存配置\n */\nexport interface MultiLayerCacheConfig {\n  /** 内存缓存配置 */\n  memory?: CacheOptions | boolean;\n  /** Redis 缓存配置 */\n  redis?: CacheOptions & {\n    host?: string;\n    port?: number;\n    password?: string;\n    db?: number;\n  };\n  /** HTTP 缓存配置 */\n  http?: CacheOptions & {\n    baseUrl?: string;\n    headers?: Record<string, string>;\n  };\n}\n\n/**\n * 数据预取上下文\n */\nexport interface PrefetchContext {\n  /** 路径 */\n  path?: string;\n  /** 参数 */\n  params?: Record<string, string>;\n  /** 查询参数 */\n  query?: Record<string, string>;\n}\n\n/**\n * 预取结果\n */\nexport interface PrefetchResult<T = unknown> {\n  /** 预取的数据 */\n  data: T;\n  /** 过期时间戳 */\n  expiresAt?: number;\n  /** 缓存标签 */\n  tags?: string[];\n}\n\nconst DEFAULT_TTL = 3600000; // 1 小时\nconst MAX_SIZE = 100 * 1024 * 1024; // 100 MB\n\n/**\n * 内存缓存实现\n */\nexport class MemoryCache implements Cache {\n  private cache: Map<string, CacheEntry> = new Map();\n  private tagIndex: Map<string, Set<string>> = new Map();\n  private stats: CacheStats = {\n    size: 0,\n    totalSize: 0,\n    hits: 0,\n    misses: 0,\n    hitRate: 0,\n  };\n  private defaultTTL: number;\n  private maxSize: number;\n\n  constructor(options: CacheOptions = {}) {\n    this.defaultTTL = options.ttl ?? DEFAULT_TTL;\n    this.maxSize = options.maxSize ?? MAX_SIZE;\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const entry = this.cache.get(key);\n    if (!entry) {\n      this.stats.misses++;\n      this.updateHitRate();\n      return undefined;\n    }\n\n    const now = Date.now();\n    if (entry.expiresAt < now) {\n      this.delete(key);\n      this.stats.misses++;\n      this.updateHitRate();\n      return undefined;\n    }\n\n    this.stats.hits++;\n    this.updateHitRate();\n    return entry.value as T;\n  }\n\n  async set<T>(key: string, value: T, options: CacheOptions = {}): Promise<void> {\n    const now = Date.now();\n    const ttl = options.ttl ?? this.defaultTTL;\n    const tags = options.tags ?? [];\n    const size = this.calculateSize(value);\n\n    // 检查是否超出最大大小\n    if (this.stats.totalSize + size > this.maxSize) {\n      this.evictOldest();\n    }\n\n    const entry: CacheEntry = {\n      value,\n      createdAt: now,\n      expiresAt: now + ttl,\n      tags,\n      size,\n    };\n\n    // 更新缓存\n    this.cache.set(key, entry);\n\n    // 更新标签索引\n    for (const tag of tags) {\n      if (!this.tagIndex.has(tag)) {\n        this.tagIndex.set(tag, new Set());\n      }\n      this.tagIndex.get(tag)!.add(key);\n    }\n\n    // 更新统计\n    this.stats.size = this.cache.size;\n    this.stats.totalSize += size;\n  }\n\n  async delete(key: string): Promise<boolean> {\n    const entry = this.cache.get(key);\n    if (!entry) {\n      return false;\n    }\n\n    // 从标签索引中删除\n    for (const tag of entry.tags) {\n      const tagKeys = this.tagIndex.get(tag);\n      if (tagKeys) {\n        tagKeys.delete(key);\n        if (tagKeys.size === 0) {\n          this.tagIndex.delete(tag);\n        }\n      }\n    }\n\n    // 更新统计\n    if (entry.size) {\n      this.stats.totalSize -= entry.size;\n    }\n    this.stats.size = this.cache.size - 1;\n\n    return this.cache.delete(key);\n  }\n\n  async has(key: string): Promise<boolean> {\n    const entry = this.cache.get(key);\n    if (!entry) {\n      return false;\n    }\n    if (Date.now() > entry.expiresAt) {\n      await this.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  async clear(): Promise<void> {\n    this.cache.clear();\n    this.tagIndex.clear();\n    this.stats = {\n      size: 0,\n      totalSize: 0,\n      hits: 0,\n      misses: 0,\n      hitRate: 0,\n    };\n  }\n\n  async invalidateTag(tag: string): Promise<void> {\n    const keys = this.tagIndex.get(tag);\n    if (!keys) {\n      return;\n    }\n\n    for (const key of keys) {\n      await this.delete(key);\n    }\n  }\n\n  async invalidateTags(tags: string[]): Promise<void> {\n    for (const tag of tags) {\n      await this.invalidateTag(tag);\n    }\n  }\n\n  async getStats(): Promise<CacheStats> {\n    return { ...this.stats };\n  }\n\n  /**\n   * 计算值的大小（字节）\n   */\n  private calculateSize(value: unknown): number {\n    try {\n      const str = JSON.stringify(value);\n      return new TextEncoder().encode(str).length;\n    } catch {\n      return 100; // 估算大小\n    }\n  }\n\n  /**\n   * 淘汰最旧的条目\n   */\n  private evictOldest(): void {\n    let oldestKey: string | null = null;\n    let oldestTime = Infinity;\n\n    for (const [key, entry] of this.cache) {\n      if (entry.createdAt < oldestTime) {\n        oldestTime = entry.createdAt;\n        oldestKey = key;\n      }\n    }\n\n    if (oldestKey) {\n      this.delete(oldestKey);\n    }\n  }\n\n  /**\n   * 更新命中率\n   */\n  private updateHitRate(): void {\n    const total = this.stats.hits + this.stats.misses;\n    this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;\n  }\n}\n\n/**\n * 多层缓存实现（Memory → Redis → HTTP）\n */\nexport class MultiLayerCache implements Cache {\n  private layers: Cache[];\n\n  constructor(config: MultiLayerCacheConfig = {}) {\n    this.layers = [];\n\n    // 内存缓存始终作为第一层\n    if (config.memory !== false) {\n      const memoryOptions = typeof config.memory === 'object' ? config.memory : undefined;\n      this.layers.push(new MemoryCache(memoryOptions));\n    }\n\n    // Redis 缓存作为第二层（可选）\n    if (config.redis) {\n      // Redis 缓存可以在实际环境配置\n      // 这里我们预留接口\n    }\n\n    // HTTP 缓存作为第三层（可选）\n    if (config.http) {\n      // HTTP 缓存可以在实际环境配置\n    }\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    for (const layer of this.layers) {\n      const value = await layer.get<T>(key);\n      if (value !== undefined) {\n        // 回写上层缓存\n        for (let i = 0; i < this.layers.indexOf(layer); i++) {\n          await this.layers[i].set(key, value);\n        }\n        return value;\n      }\n    }\n    return undefined;\n  }\n\n  async set<T>(key: string, value: T, options?: CacheOptions): Promise<void> {\n    // 写入所有层\n    for (const layer of this.layers) {\n      await layer.set(key, value, options);\n    }\n  }\n\n  async delete(key: string): Promise<boolean> {\n    let result = false;\n    for (const layer of this.layers) {\n      const layerResult = await layer.delete(key);\n      if (layerResult) {\n        result = true;\n      }\n    }\n    return result;\n  }\n\n  async has(key: string): Promise<boolean> {\n    for (const layer of this.layers) {\n      if (await layer.has(key)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  async clear(): Promise<void> {\n    for (const layer of this.layers) {\n      await layer.clear();\n    }\n  }\n\n  async invalidateTag(tag: string): Promise<void> {\n    for (const layer of this.layers) {\n      await layer.invalidateTag(tag);\n    }\n  }\n\n  async invalidateTags(tags: string[]): Promise<void> {\n    for (const tag of tags) {\n      await this.invalidateTag(tag);\n    }\n  }\n\n  async getStats(): Promise<CacheStats> {\n    // 合并所有层的统计信息\n    const statsList = await Promise.all(this.layers.map((layer) => layer.getStats()));\n    const merged: CacheStats = {\n      size: statsList.reduce((sum, stat) => sum + stat.size, 0),\n      totalSize: statsList.reduce((sum, stat) => sum + stat.totalSize, 0),\n      hits: statsList.reduce((sum, stat) => sum + stat.hits, 0),\n      misses: statsList.reduce((sum, stat) => sum + stat.misses, 0),\n      hitRate: 0,\n    };\n    const total = merged.hits + merged.misses;\n    merged.hitRate = total > 0 ? merged.hits / total : 0;\n    return merged;\n  }\n}\n\n/**\n * 创建默认缓存实例\n */\nexport function createCache(options?: {\n  type?: 'memory' | 'multi';\n  config?: CacheOptions | MultiLayerCacheConfig;\n}) {\n  if (options?.type === 'multi') {\n    return new MultiLayerCache(options.config as MultiLayerCacheConfig);\n  }\n  return new MemoryCache(options?.config as CacheOptions);\n}\n\n// 默认实例\nlet defaultCache: MemoryCache | null = null;\n\nexport function getDefaultCache() {\n  if (!defaultCache) {\n    defaultCache = new MemoryCache();\n  }\n  return defaultCache;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,183 @@
+/**
+ * @lytjs/cache - 统一缓存系统入口
+ *
+ * 提供多层缓存（Memory → Redis → HTTP）支持，
+ * 包含缓存标签、TTL、统计等功能。
+ */
+/**
+ * 缓存条目接口
+ */
+interface CacheEntry<T = unknown> {
+    /** 缓存值 */
+    value: T;
+    /** 创建时间戳 */
+    createdAt: number;
+    /** 过期时间戳 */
+    expiresAt: number;
+    /** 缓存标签 */
+    tags: string[];
+    /** 数据大小（字节） */
+    size?: number;
+}
+/**
+ * 缓存配置选项
+ */
+interface CacheOptions {
+    /** 生存时间（毫秒） */
+    ttl?: number;
+    /** 缓存标签 */
+    tags?: string[];
+    /** 重新验证时间（毫秒） */
+    revalidate?: number;
+    /** 最大大小（字节） */
+    maxSize?: number;
+}
+/**
+ * 统一缓存接口
+ */
+interface Cache {
+    /**
+     * 获取缓存值
+     */
+    get<T>(key: string): Promise<T | undefined>;
+    /**
+     * 设置缓存值
+     */
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    /**
+     * 删除缓存值
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * 检查缓存是否存在
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 清除所有缓存
+     */
+    clear(): Promise<void>;
+    /**
+     * 按标签无效化缓存
+     */
+    invalidateTag(tag: string): Promise<void>;
+    /**
+     * 批量按标签无效化缓存
+     */
+    invalidateTags(tags: string[]): Promise<void>;
+    /**
+     * 获取缓存统计信息
+     */
+    getStats(): Promise<CacheStats>;
+}
+/**
+ * 缓存统计信息
+ */
+interface CacheStats {
+    /** 键的数量 */
+    size: number;
+    /** 总大小（字节） */
+    totalSize: number;
+    /** 命中次数 */
+    hits: number;
+    /** 未命中次数 */
+    misses: number;
+    /** 命中率 */
+    hitRate: number;
+}
+/**
+ * 多层缓存配置
+ */
+interface MultiLayerCacheConfig {
+    /** 内存缓存配置 */
+    memory?: CacheOptions | boolean;
+    /** Redis 缓存配置 */
+    redis?: CacheOptions & {
+        host?: string;
+        port?: number;
+        password?: string;
+        db?: number;
+    };
+    /** HTTP 缓存配置 */
+    http?: CacheOptions & {
+        baseUrl?: string;
+        headers?: Record<string, string>;
+    };
+}
+/**
+ * 数据预取上下文
+ */
+interface PrefetchContext {
+    /** 路径 */
+    path?: string;
+    /** 参数 */
+    params?: Record<string, string>;
+    /** 查询参数 */
+    query?: Record<string, string>;
+}
+/**
+ * 预取结果
+ */
+interface PrefetchResult<T = unknown> {
+    /** 预取的数据 */
+    data: T;
+    /** 过期时间戳 */
+    expiresAt?: number;
+    /** 缓存标签 */
+    tags?: string[];
+}
+/**
+ * 内存缓存实现
+ */
+declare class MemoryCache implements Cache {
+    private cache;
+    private tagIndex;
+    private stats;
+    private defaultTTL;
+    private maxSize;
+    constructor(options?: CacheOptions);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    invalidateTag(tag: string): Promise<void>;
+    invalidateTags(tags: string[]): Promise<void>;
+    getStats(): Promise<CacheStats>;
+    /**
+     * 计算值的大小（字节）
+     */
+    private calculateSize;
+    /**
+     * 淘汰最旧的条目
+     */
+    private evictOldest;
+    /**
+     * 更新命中率
+     */
+    private updateHitRate;
+}
+/**
+ * 多层缓存实现（Memory → Redis → HTTP）
+ */
+declare class MultiLayerCache implements Cache {
+    private layers;
+    constructor(config?: MultiLayerCacheConfig);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    invalidateTag(tag: string): Promise<void>;
+    invalidateTags(tags: string[]): Promise<void>;
+    getStats(): Promise<CacheStats>;
+}
+/**
+ * 创建默认缓存实例
+ */
+declare function createCache(options?: {
+    type?: 'memory' | 'multi';
+    config?: CacheOptions | MultiLayerCacheConfig;
+}): MemoryCache | MultiLayerCache;
+declare function getDefaultCache(): MemoryCache;
+
+export { type Cache, type CacheEntry, type CacheOptions, type CacheStats, MemoryCache, MultiLayerCache, type MultiLayerCacheConfig, type PrefetchContext, type PrefetchResult, createCache, getDefaultCache };

package/dist/index.d.ts

@@ -0,0 +1,183 @@
+/**
+ * @lytjs/cache - 统一缓存系统入口
+ *
+ * 提供多层缓存（Memory → Redis → HTTP）支持，
+ * 包含缓存标签、TTL、统计等功能。
+ */
+/**
+ * 缓存条目接口
+ */
+interface CacheEntry<T = unknown> {
+    /** 缓存值 */
+    value: T;
+    /** 创建时间戳 */
+    createdAt: number;
+    /** 过期时间戳 */
+    expiresAt: number;
+    /** 缓存标签 */
+    tags: string[];
+    /** 数据大小（字节） */
+    size?: number;
+}
+/**
+ * 缓存配置选项
+ */
+interface CacheOptions {
+    /** 生存时间（毫秒） */
+    ttl?: number;
+    /** 缓存标签 */
+    tags?: string[];
+    /** 重新验证时间（毫秒） */
+    revalidate?: number;
+    /** 最大大小（字节） */
+    maxSize?: number;
+}
+/**
+ * 统一缓存接口
+ */
+interface Cache {
+    /**
+     * 获取缓存值
+     */
+    get<T>(key: string): Promise<T | undefined>;
+    /**
+     * 设置缓存值
+     */
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    /**
+     * 删除缓存值
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * 检查缓存是否存在
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 清除所有缓存
+     */
+    clear(): Promise<void>;
+    /**
+     * 按标签无效化缓存
+     */
+    invalidateTag(tag: string): Promise<void>;
+    /**
+     * 批量按标签无效化缓存
+     */
+    invalidateTags(tags: string[]): Promise<void>;
+    /**
+     * 获取缓存统计信息
+     */
+    getStats(): Promise<CacheStats>;
+}
+/**
+ * 缓存统计信息
+ */
+interface CacheStats {
+    /** 键的数量 */
+    size: number;
+    /** 总大小（字节） */
+    totalSize: number;
+    /** 命中次数 */
+    hits: number;
+    /** 未命中次数 */
+    misses: number;
+    /** 命中率 */
+    hitRate: number;
+}
+/**
+ * 多层缓存配置
+ */
+interface MultiLayerCacheConfig {
+    /** 内存缓存配置 */
+    memory?: CacheOptions | boolean;
+    /** Redis 缓存配置 */
+    redis?: CacheOptions & {
+        host?: string;
+        port?: number;
+        password?: string;
+        db?: number;
+    };
+    /** HTTP 缓存配置 */
+    http?: CacheOptions & {
+        baseUrl?: string;
+        headers?: Record<string, string>;
+    };
+}
+/**
+ * 数据预取上下文
+ */
+interface PrefetchContext {
+    /** 路径 */
+    path?: string;
+    /** 参数 */
+    params?: Record<string, string>;
+    /** 查询参数 */
+    query?: Record<string, string>;
+}
+/**
+ * 预取结果
+ */
+interface PrefetchResult<T = unknown> {
+    /** 预取的数据 */
+    data: T;
+    /** 过期时间戳 */
+    expiresAt?: number;
+    /** 缓存标签 */
+    tags?: string[];
+}
+/**
+ * 内存缓存实现
+ */
+declare class MemoryCache implements Cache {
+    private cache;
+    private tagIndex;
+    private stats;
+    private defaultTTL;
+    private maxSize;
+    constructor(options?: CacheOptions);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    invalidateTag(tag: string): Promise<void>;
+    invalidateTags(tags: string[]): Promise<void>;
+    getStats(): Promise<CacheStats>;
+    /**
+     * 计算值的大小（字节）
+     */
+    private calculateSize;
+    /**
+     * 淘汰最旧的条目
+     */
+    private evictOldest;
+    /**
+     * 更新命中率
+     */
+    private updateHitRate;
+}
+/**
+ * 多层缓存实现（Memory → Redis → HTTP）
+ */
+declare class MultiLayerCache implements Cache {
+    private layers;
+    constructor(config?: MultiLayerCacheConfig);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    invalidateTag(tag: string): Promise<void>;
+    invalidateTags(tags: string[]): Promise<void>;
+    getStats(): Promise<CacheStats>;
+}
+/**
+ * 创建默认缓存实例
+ */
+declare function createCache(options?: {
+    type?: 'memory' | 'multi';
+    config?: CacheOptions | MultiLayerCacheConfig;
+}): MemoryCache | MultiLayerCache;
+declare function getDefaultCache(): MemoryCache;
+
+export { type Cache, type CacheEntry, type CacheOptions, type CacheStats, MemoryCache, MultiLayerCache, type MultiLayerCacheConfig, type PrefetchContext, type PrefetchResult, createCache, getDefaultCache };

package/dist/index.js

@@ -0,0 +1,250 @@
+// src/index.ts
+var DEFAULT_TTL = 36e5;
+var MAX_SIZE = 100 * 1024 * 1024;
+var MemoryCache = class {
+  constructor(options = {}) {
+    this.cache = /* @__PURE__ */ new Map();
+    this.tagIndex = /* @__PURE__ */ new Map();
+    this.stats = {
+      size: 0,
+      totalSize: 0,
+      hits: 0,
+      misses: 0,
+      hitRate: 0
+    };
+    this.defaultTTL = options.ttl ?? DEFAULT_TTL;
+    this.maxSize = options.maxSize ?? MAX_SIZE;
+  }
+  async get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      this.stats.misses++;
+      this.updateHitRate();
+      return void 0;
+    }
+    const now = Date.now();
+    if (entry.expiresAt < now) {
+      this.delete(key);
+      this.stats.misses++;
+      this.updateHitRate();
+      return void 0;
+    }
+    this.stats.hits++;
+    this.updateHitRate();
+    return entry.value;
+  }
+  async set(key, value, options = {}) {
+    const now = Date.now();
+    const ttl = options.ttl ?? this.defaultTTL;
+    const tags = options.tags ?? [];
+    const size = this.calculateSize(value);
+    if (this.stats.totalSize + size > this.maxSize) {
+      this.evictOldest();
+    }
+    const entry = {
+      value,
+      createdAt: now,
+      expiresAt: now + ttl,
+      tags,
+      size
+    };
+    this.cache.set(key, entry);
+    for (const tag of tags) {
+      if (!this.tagIndex.has(tag)) {
+        this.tagIndex.set(tag, /* @__PURE__ */ new Set());
+      }
+      this.tagIndex.get(tag).add(key);
+    }
+    this.stats.size = this.cache.size;
+    this.stats.totalSize += size;
+  }
+  async delete(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      return false;
+    }
+    for (const tag of entry.tags) {
+      const tagKeys = this.tagIndex.get(tag);
+      if (tagKeys) {
+        tagKeys.delete(key);
+        if (tagKeys.size === 0) {
+          this.tagIndex.delete(tag);
+        }
+      }
+    }
+    if (entry.size) {
+      this.stats.totalSize -= entry.size;
+    }
+    this.stats.size = this.cache.size - 1;
+    return this.cache.delete(key);
+  }
+  async has(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      return false;
+    }
+    if (Date.now() > entry.expiresAt) {
+      await this.delete(key);
+      return false;
+    }
+    return true;
+  }
+  async clear() {
+    this.cache.clear();
+    this.tagIndex.clear();
+    this.stats = {
+      size: 0,
+      totalSize: 0,
+      hits: 0,
+      misses: 0,
+      hitRate: 0
+    };
+  }
+  async invalidateTag(tag) {
+    const keys = this.tagIndex.get(tag);
+    if (!keys) {
+      return;
+    }
+    for (const key of keys) {
+      await this.delete(key);
+    }
+  }
+  async invalidateTags(tags) {
+    for (const tag of tags) {
+      await this.invalidateTag(tag);
+    }
+  }
+  async getStats() {
+    return { ...this.stats };
+  }
+  /**
+   * 计算值的大小（字节）
+   */
+  calculateSize(value) {
+    try {
+      const str = JSON.stringify(value);
+      return new TextEncoder().encode(str).length;
+    } catch {
+      return 100;
+    }
+  }
+  /**
+   * 淘汰最旧的条目
+   */
+  evictOldest() {
+    let oldestKey = null;
+    let oldestTime = Infinity;
+    for (const [key, entry] of this.cache) {
+      if (entry.createdAt < oldestTime) {
+        oldestTime = entry.createdAt;
+        oldestKey = key;
+      }
+    }
+    if (oldestKey) {
+      this.delete(oldestKey);
+    }
+  }
+  /**
+   * 更新命中率
+   */
+  updateHitRate() {
+    const total = this.stats.hits + this.stats.misses;
+    this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+  }
+};
+var MultiLayerCache = class {
+  constructor(config = {}) {
+    this.layers = [];
+    if (config.memory !== false) {
+      const memoryOptions = typeof config.memory === "object" ? config.memory : void 0;
+      this.layers.push(new MemoryCache(memoryOptions));
+    }
+    if (config.redis) {
+    }
+    if (config.http) {
+    }
+  }
+  async get(key) {
+    for (const layer of this.layers) {
+      const value = await layer.get(key);
+      if (value !== void 0) {
+        for (let i = 0; i < this.layers.indexOf(layer); i++) {
+          await this.layers[i].set(key, value);
+        }
+        return value;
+      }
+    }
+    return void 0;
+  }
+  async set(key, value, options) {
+    for (const layer of this.layers) {
+      await layer.set(key, value, options);
+    }
+  }
+  async delete(key) {
+    let result = false;
+    for (const layer of this.layers) {
+      const layerResult = await layer.delete(key);
+      if (layerResult) {
+        result = true;
+      }
+    }
+    return result;
+  }
+  async has(key) {
+    for (const layer of this.layers) {
+      if (await layer.has(key)) {
+        return true;
+      }
+    }
+    return false;
+  }
+  async clear() {
+    for (const layer of this.layers) {
+      await layer.clear();
+    }
+  }
+  async invalidateTag(tag) {
+    for (const layer of this.layers) {
+      await layer.invalidateTag(tag);
+    }
+  }
+  async invalidateTags(tags) {
+    for (const tag of tags) {
+      await this.invalidateTag(tag);
+    }
+  }
+  async getStats() {
+    const statsList = await Promise.all(this.layers.map((layer) => layer.getStats()));
+    const merged = {
+      size: statsList.reduce((sum, stat) => sum + stat.size, 0),
+      totalSize: statsList.reduce((sum, stat) => sum + stat.totalSize, 0),
+      hits: statsList.reduce((sum, stat) => sum + stat.hits, 0),
+      misses: statsList.reduce((sum, stat) => sum + stat.misses, 0),
+      hitRate: 0
+    };
+    const total = merged.hits + merged.misses;
+    merged.hitRate = total > 0 ? merged.hits / total : 0;
+    return merged;
+  }
+};
+function createCache(options) {
+  if (options?.type === "multi") {
+    return new MultiLayerCache(options.config);
+  }
+  return new MemoryCache(options?.config);
+}
+var defaultCache = null;
+function getDefaultCache() {
+  if (!defaultCache) {
+    defaultCache = new MemoryCache();
+  }
+  return defaultCache;
+}
+export {
+  MemoryCache,
+  MultiLayerCache,
+  createCache,
+  getDefaultCache
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @lytjs/cache - 统一缓存系统入口\n *\n * 提供多层缓存（Memory → Redis → HTTP）支持，\n * 包含缓存标签、TTL、统计等功能。\n */\n\n/**\n * 缓存条目接口\n */\nexport interface CacheEntry<T = unknown> {\n  /** 缓存值 */\n  value: T;\n  /** 创建时间戳 */\n  createdAt: number;\n  /** 过期时间戳 */\n  expiresAt: number;\n  /** 缓存标签 */\n  tags: string[];\n  /** 数据大小（字节） */\n  size?: number;\n}\n\n/**\n * 缓存配置选项\n */\nexport interface CacheOptions {\n  /** 生存时间（毫秒） */\n  ttl?: number;\n  /** 缓存标签 */\n  tags?: string[];\n  /** 重新验证时间（毫秒） */\n  revalidate?: number;\n  /** 最大大小（字节） */\n  maxSize?: number;\n}\n\n/**\n * 统一缓存接口\n */\nexport interface Cache {\n  /**\n   * 获取缓存值\n   */\n  get<T>(key: string): Promise<T | undefined>;\n\n  /**\n   * 设置缓存值\n   */\n  set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;\n\n  /**\n   * 删除缓存值\n   */\n  delete(key: string): Promise<boolean>;\n\n  /**\n   * 检查缓存是否存在\n   */\n  has(key: string): Promise<boolean>;\n\n  /**\n   * 清除所有缓存\n   */\n  clear(): Promise<void>;\n\n  /**\n   * 按标签无效化缓存\n   */\n  invalidateTag(tag: string): Promise<void>;\n\n  /**\n   * 批量按标签无效化缓存\n   */\n  invalidateTags(tags: string[]): Promise<void>;\n\n  /**\n   * 获取缓存统计信息\n   */\n  getStats(): Promise<CacheStats>;\n}\n\n/**\n * 缓存统计信息\n */\nexport interface CacheStats {\n  /** 键的数量 */\n  size: number;\n  /** 总大小（字节） */\n  totalSize: number;\n  /** 命中次数 */\n  hits: number;\n  /** 未命中次数 */\n  misses: number;\n  /** 命中率 */\n  hitRate: number;\n}\n\n/**\n * 多层缓存配置\n */\nexport interface MultiLayerCacheConfig {\n  /** 内存缓存配置 */\n  memory?: CacheOptions | boolean;\n  /** Redis 缓存配置 */\n  redis?: CacheOptions & {\n    host?: string;\n    port?: number;\n    password?: string;\n    db?: number;\n  };\n  /** HTTP 缓存配置 */\n  http?: CacheOptions & {\n    baseUrl?: string;\n    headers?: Record<string, string>;\n  };\n}\n\n/**\n * 数据预取上下文\n */\nexport interface PrefetchContext {\n  /** 路径 */\n  path?: string;\n  /** 参数 */\n  params?: Record<string, string>;\n  /** 查询参数 */\n  query?: Record<string, string>;\n}\n\n/**\n * 预取结果\n */\nexport interface PrefetchResult<T = unknown> {\n  /** 预取的数据 */\n  data: T;\n  /** 过期时间戳 */\n  expiresAt?: number;\n  /** 缓存标签 */\n  tags?: string[];\n}\n\nconst DEFAULT_TTL = 3600000; // 1 小时\nconst MAX_SIZE = 100 * 1024 * 1024; // 100 MB\n\n/**\n * 内存缓存实现\n */\nexport class MemoryCache implements Cache {\n  private cache: Map<string, CacheEntry> = new Map();\n  private tagIndex: Map<string, Set<string>> = new Map();\n  private stats: CacheStats = {\n    size: 0,\n    totalSize: 0,\n    hits: 0,\n    misses: 0,\n    hitRate: 0,\n  };\n  private defaultTTL: number;\n  private maxSize: number;\n\n  constructor(options: CacheOptions = {}) {\n    this.defaultTTL = options.ttl ?? DEFAULT_TTL;\n    this.maxSize = options.maxSize ?? MAX_SIZE;\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const entry = this.cache.get(key);\n    if (!entry) {\n      this.stats.misses++;\n      this.updateHitRate();\n      return undefined;\n    }\n\n    const now = Date.now();\n    if (entry.expiresAt < now) {\n      this.delete(key);\n      this.stats.misses++;\n      this.updateHitRate();\n      return undefined;\n    }\n\n    this.stats.hits++;\n    this.updateHitRate();\n    return entry.value as T;\n  }\n\n  async set<T>(key: string, value: T, options: CacheOptions = {}): Promise<void> {\n    const now = Date.now();\n    const ttl = options.ttl ?? this.defaultTTL;\n    const tags = options.tags ?? [];\n    const size = this.calculateSize(value);\n\n    // 检查是否超出最大大小\n    if (this.stats.totalSize + size > this.maxSize) {\n      this.evictOldest();\n    }\n\n    const entry: CacheEntry = {\n      value,\n      createdAt: now,\n      expiresAt: now + ttl,\n      tags,\n      size,\n    };\n\n    // 更新缓存\n    this.cache.set(key, entry);\n\n    // 更新标签索引\n    for (const tag of tags) {\n      if (!this.tagIndex.has(tag)) {\n        this.tagIndex.set(tag, new Set());\n      }\n      this.tagIndex.get(tag)!.add(key);\n    }\n\n    // 更新统计\n    this.stats.size = this.cache.size;\n    this.stats.totalSize += size;\n  }\n\n  async delete(key: string): Promise<boolean> {\n    const entry = this.cache.get(key);\n    if (!entry) {\n      return false;\n    }\n\n    // 从标签索引中删除\n    for (const tag of entry.tags) {\n      const tagKeys = this.tagIndex.get(tag);\n      if (tagKeys) {\n        tagKeys.delete(key);\n        if (tagKeys.size === 0) {\n          this.tagIndex.delete(tag);\n        }\n      }\n    }\n\n    // 更新统计\n    if (entry.size) {\n      this.stats.totalSize -= entry.size;\n    }\n    this.stats.size = this.cache.size - 1;\n\n    return this.cache.delete(key);\n  }\n\n  async has(key: string): Promise<boolean> {\n    const entry = this.cache.get(key);\n    if (!entry) {\n      return false;\n    }\n    if (Date.now() > entry.expiresAt) {\n      await this.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  async clear(): Promise<void> {\n    this.cache.clear();\n    this.tagIndex.clear();\n    this.stats = {\n      size: 0,\n      totalSize: 0,\n      hits: 0,\n      misses: 0,\n      hitRate: 0,\n    };\n  }\n\n  async invalidateTag(tag: string): Promise<void> {\n    const keys = this.tagIndex.get(tag);\n    if (!keys) {\n      return;\n    }\n\n    for (const key of keys) {\n      await this.delete(key);\n    }\n  }\n\n  async invalidateTags(tags: string[]): Promise<void> {\n    for (const tag of tags) {\n      await this.invalidateTag(tag);\n    }\n  }\n\n  async getStats(): Promise<CacheStats> {\n    return { ...this.stats };\n  }\n\n  /**\n   * 计算值的大小（字节）\n   */\n  private calculateSize(value: unknown): number {\n    try {\n      const str = JSON.stringify(value);\n      return new TextEncoder().encode(str).length;\n    } catch {\n      return 100; // 估算大小\n    }\n  }\n\n  /**\n   * 淘汰最旧的条目\n   */\n  private evictOldest(): void {\n    let oldestKey: string | null = null;\n    let oldestTime = Infinity;\n\n    for (const [key, entry] of this.cache) {\n      if (entry.createdAt < oldestTime) {\n        oldestTime = entry.createdAt;\n        oldestKey = key;\n      }\n    }\n\n    if (oldestKey) {\n      this.delete(oldestKey);\n    }\n  }\n\n  /**\n   * 更新命中率\n   */\n  private updateHitRate(): void {\n    const total = this.stats.hits + this.stats.misses;\n    this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;\n  }\n}\n\n/**\n * 多层缓存实现（Memory → Redis → HTTP）\n */\nexport class MultiLayerCache implements Cache {\n  private layers: Cache[];\n\n  constructor(config: MultiLayerCacheConfig = {}) {\n    this.layers = [];\n\n    // 内存缓存始终作为第一层\n    if (config.memory !== false) {\n      const memoryOptions = typeof config.memory === 'object' ? config.memory : undefined;\n      this.layers.push(new MemoryCache(memoryOptions));\n    }\n\n    // Redis 缓存作为第二层（可选）\n    if (config.redis) {\n      // Redis 缓存可以在实际环境配置\n      // 这里我们预留接口\n    }\n\n    // HTTP 缓存作为第三层（可选）\n    if (config.http) {\n      // HTTP 缓存可以在实际环境配置\n    }\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    for (const layer of this.layers) {\n      const value = await layer.get<T>(key);\n      if (value !== undefined) {\n        // 回写上层缓存\n        for (let i = 0; i < this.layers.indexOf(layer); i++) {\n          await this.layers[i].set(key, value);\n        }\n        return value;\n      }\n    }\n    return undefined;\n  }\n\n  async set<T>(key: string, value: T, options?: CacheOptions): Promise<void> {\n    // 写入所有层\n    for (const layer of this.layers) {\n      await layer.set(key, value, options);\n    }\n  }\n\n  async delete(key: string): Promise<boolean> {\n    let result = false;\n    for (const layer of this.layers) {\n      const layerResult = await layer.delete(key);\n      if (layerResult) {\n        result = true;\n      }\n    }\n    return result;\n  }\n\n  async has(key: string): Promise<boolean> {\n    for (const layer of this.layers) {\n      if (await layer.has(key)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  async clear(): Promise<void> {\n    for (const layer of this.layers) {\n      await layer.clear();\n    }\n  }\n\n  async invalidateTag(tag: string): Promise<void> {\n    for (const layer of this.layers) {\n      await layer.invalidateTag(tag);\n    }\n  }\n\n  async invalidateTags(tags: string[]): Promise<void> {\n    for (const tag of tags) {\n      await this.invalidateTag(tag);\n    }\n  }\n\n  async getStats(): Promise<CacheStats> {\n    // 合并所有层的统计信息\n    const statsList = await Promise.all(this.layers.map((layer) => layer.getStats()));\n    const merged: CacheStats = {\n      size: statsList.reduce((sum, stat) => sum + stat.size, 0),\n      totalSize: statsList.reduce((sum, stat) => sum + stat.totalSize, 0),\n      hits: statsList.reduce((sum, stat) => sum + stat.hits, 0),\n      misses: statsList.reduce((sum, stat) => sum + stat.misses, 0),\n      hitRate: 0,\n    };\n    const total = merged.hits + merged.misses;\n    merged.hitRate = total > 0 ? merged.hits / total : 0;\n    return merged;\n  }\n}\n\n/**\n * 创建默认缓存实例\n */\nexport function createCache(options?: {\n  type?: 'memory' | 'multi';\n  config?: CacheOptions | MultiLayerCacheConfig;\n}) {\n  if (options?.type === 'multi') {\n    return new MultiLayerCache(options.config as MultiLayerCacheConfig);\n  }\n  return new MemoryCache(options?.config as CacheOptions);\n}\n\n// 默认实例\nlet defaultCache: MemoryCache | null = null;\n\nexport function getDefaultCache() {\n  if (!defaultCache) {\n    defaultCache = new MemoryCache();\n  }\n  return defaultCache;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lytjs/cache",
-  "version": "6.8.0",
+  "version": "6.9.0",
   "description": "LytJS unified caching system with memory, Redis, and HTTP cache support",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -24,8 +24,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@lytjs/common-cache": "workspace:*",
-    "@lytjs/common-is": "workspace:*"
+    "@lytjs/common-cache": "^6.9.0",
+    "@lytjs/common-is": "^6.9.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",