@lytjs/cache-isr 6.6.0

package/README.md

@@ -0,0 +1,40 @@
+# @lytjs/cache-isr
+
+> LytJS ISR 缓存系统。
+
+[![npm version](https://img.shields.io/npm/v/@lytjs/cache-isr.svg)](https://www.npmjs.com/package/@lytjs/cache-isr)
+[![license](https://img.shields.io/npm/l/@lytjs/cache-isr.svg)](https://gitee.com/lytjs/lytjs/blob/main/LICENSE)
+
+## 简介
+
+`@lytjs/cache-isr` 是 LytJS 框架的增量静态再生成缓存系统，支持灵活的缓存管理和重新验证。
+
+### 核心特性
+
+- **自定义存储**：支持自定义存储后端
+- **增量重新验证**：支持增量更新缓存
+- **ETag 支持**：内置 ETag 支持
+- **零依赖**：不引入任何外部依赖
+
+## 安装
+
+```bash
+npm install @lytjs/cache-isr
+```
+
+或使用 pnpm：
+
+```bash
+pnpm add @lytjs/cache-isr
+```
+
+## 许可证
+
+MIT License - [查看许可证](https://gitee.com/lytjs/lytjs/blob/main/LICENSE)
+
+## 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+- [Gitee 仓库](https://gitee.com/lytjs/lytjs)
+- [问题反馈](https://gitee.com/lytjs/lytjs/issues)

package/dist/index.cjs

@@ -0,0 +1,88 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/cache.ts
+var ISRCache = class {
+  constructor(config = {}) {
+    __publicField(this, "cache", /* @__PURE__ */ new Map());
+    __publicField(this, "defaultMaxAge");
+    this.defaultMaxAge = config.maxAge ?? 36e5;
+  }
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return null;
+    const now = Date.now();
+    if (entry.expiry < now) {
+      this.cache.delete(key);
+      return null;
+    }
+    return entry.value;
+  }
+  set(key, value, config) {
+    const now = Date.now();
+    const { maxAge = this.defaultMaxAge, revalidate } = {
+      maxAge: this.defaultMaxAge,
+      revalidate: config?.revalidate
+    };
+    this.cache.set(key, {
+      value,
+      expiry: now + maxAge,
+      revalidateAt: revalidate ? now + revalidate : void 0,
+      createdAt: now
+    });
+  }
+  has(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    if (Date.now() > entry.expiry) {
+      this.cache.delete(key);
+      return false;
+    }
+    return true;
+  }
+  delete(key) {
+    return this.cache.delete(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+  isStale(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    if (!entry.revalidateAt) return false;
+    return Date.now() >= entry.revalidateAt;
+  }
+};
+
+// src/revalidate.ts
+var ISRRevaluator = class {
+  constructor(cache) {
+    __publicField(this, "cache", cache);
+  }
+  async revalidate(key, generator) {
+    const value = await generator();
+    this.cache.set(key, value);
+    return value;
+  }
+  async revalidateIfStale(key, generator) {
+    if (!this.cache.has(key)) {
+      const value = await generator();
+      this.cache.set(key, value);
+      return value;
+    }
+    if (this.cache.isStale(key)) {
+      const value = await generator();
+      this.cache.set(key, value);
+      return value;
+    }
+    return this.cache.get(key);
+  }
+};
+
+exports.ISRCache = ISRCache;
+exports.ISRRevaluator = ISRRevaluator;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts","../src/revalidate.ts"],"names":[],"mappings":";;;;;;;AASO,IAAM,WAAN,MAAe;AAAA,EAIpB,WAAA,CAAY,MAAA,GAAyB,EAAC,EAAG;AAHzC,IAAA,aAAA,CAAA,IAAA,EAAQ,OAAA,sBAAsD,GAAA,EAAI,CAAA;AAClE,IAAA,aAAA,CAAA,IAAA,EAAQ,eAAA,CAAA;AAGN,IAAA,IAAA,CAAK,aAAA,GAAgB,OAAO,MAAA,IAAU,IAAA;AAAA,EACxC;AAAA,EAEA,IAAO,GAAA,EAAuB;AAC5B,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AAEnB,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,IAAI,KAAA,CAAM,SAAS,GAAA,EAAK;AACtB,MAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AACrB,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,OAAO,KAAA,CAAM,KAAA;AAAA,EACf;AAAA,EAEA,GAAA,CAAO,GAAA,EAAa,KAAA,EAAU,MAAA,EAA+B;AAC3D,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,MAAM,EAAE,MAAA,GAAS,IAAA,CAAK,aAAA,EAAe,YAAW,GAAI;AAAA,MAClD,QAAQ,IAAA,CAAK,aAAA;AAAA,MACb,YAAY,MAAA,EAAQ;AAAA,KACtB;AAEA,IAAA,IAAA,CAAK,KAAA,CAAM,IAAI,GAAA,EAAK;AAAA,MAClB,KAAA;AAAA,MACA,QAAQ,GAAA,GAAM,MAAA;AAAA,MACd,YAAA,EAAc,UAAA,GAAa,GAAA,GAAM,UAAA,GAAa,MAAA;AAAA,MAC9C,SAAA,EAAW;AAAA,KACZ,CAAA;AAAA,EACH;AAAA,EAEA,IAAI,GAAA,EAAsB;AACxB,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,KAAA;AACnB,IAAA,IAAI,IAAA,CAAK,GAAA,EAAI,GAAI,KAAA,CAAM,MAAA,EAAQ;AAC7B,MAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AACrB,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,OAAO,GAAA,EAAsB;AAC3B,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,GAAG,CAAA;AAAA,EAC9B;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACnB;AAAA,EAEA,QAAQ,GAAA,EAAsB;AAC5B,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,KAAA;AACnB,IAAA,IAAI,CAAC,KAAA,CAAM,YAAA,EAAc,OAAO,KAAA;AAChC,IAAA,OAAO,IAAA,CAAK,GAAA,EAAI,IAAK,KAAA,CAAM,YAAA;AAAA,EAC7B;AACF;;;ACnEO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,KAAA,EAAiB;AAAjB,IAAA,aAAA,CAAA,IAAA,EAAA,OAAA,EAAA,KAAA,CAAA;AAAA,EAAkB;AAAA,EAEtC,MAAM,UAAA,CAAc,GAAA,EAAa,SAAA,EAAyC;AACxE,IAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,EAAU;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,MAAM,iBAAA,CAAqB,GAAA,EAAa,SAAA,EAAgD;AACtF,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA,EAAG;AACxB,MAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,EAAU;AAC9B,MAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AACzB,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AAC3B,MAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,EAAU;AAC9B,MAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AACzB,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAO,GAAG,CAAA;AAAA,EAC9B;AACF","file":"index.cjs","sourcesContent":["import type { ISRCacheConfig } from './types';\n\ninterface ExtendedCacheEntry<V> {\n  value: V;\n  expiry: number;\n  revalidateAt?: number;\n  createdAt: number;\n}\n\nexport class ISRCache {\n  private cache: Map<string, ExtendedCacheEntry<unknown>> = new Map();\n  private defaultMaxAge: number;\n\n  constructor(config: ISRCacheConfig = {}) {\n    this.defaultMaxAge = config.maxAge ?? 3600000;\n  }\n\n  get<T>(key: string): T | null {\n    const entry = this.cache.get(key);\n    if (!entry) return null;\n\n    const now = Date.now();\n    if (entry.expiry < now) {\n      this.cache.delete(key);\n      return null;\n    }\n\n    return entry.value as T;\n  }\n\n  set<T>(key: string, value: T, config?: ISRCacheConfig): void {\n    const now = Date.now();\n    const { maxAge = this.defaultMaxAge, revalidate } = {\n      maxAge: this.defaultMaxAge,\n      revalidate: config?.revalidate,\n    };\n\n    this.cache.set(key, {\n      value,\n      expiry: now + maxAge,\n      revalidateAt: revalidate ? now + revalidate : undefined,\n      createdAt: now,\n    });\n  }\n\n  has(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n    if (Date.now() > entry.expiry) {\n      this.cache.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  delete(key: string): boolean {\n    return this.cache.delete(key);\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  isStale(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n    if (!entry.revalidateAt) return false;\n    return Date.now() >= entry.revalidateAt;\n  }\n}\n","import type { ISRCache } from './cache';\n\nexport class ISRRevaluator {\n  constructor(private cache: ISRCache) {}\n\n  async revalidate<T>(key: string, generator: () => Promise<T>): Promise<T> {\n    const value = await generator();\n    this.cache.set(key, value);\n    return value;\n  }\n\n  async revalidateIfStale<T>(key: string, generator: () => Promise<T>): Promise<T | null> {\n    if (!this.cache.has(key)) {\n      const value = await generator();\n      this.cache.set(key, value);\n      return value;\n    }\n\n    if (this.cache.isStale(key)) {\n      const value = await generator();\n      this.cache.set(key, value);\n      return value;\n    }\n\n    return this.cache.get<T>(key);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+interface ISRCacheConfig {
+    maxAge?: number;
+    revalidate?: number;
+    staleWhileRevalidate?: number;
+}
+interface ISRCacheEntry<T = unknown> {
+    key: string;
+    value: T;
+    createdAt: number;
+    expiresAt: number;
+    revalidateAt?: number;
+}
+
+declare class ISRCache {
+    private cache;
+    private defaultMaxAge;
+    constructor(config?: ISRCacheConfig);
+    get<T>(key: string): T | null;
+    set<T>(key: string, value: T, config?: ISRCacheConfig): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    isStale(key: string): boolean;
+}
+
+declare class ISRRevaluator {
+    private cache;
+    constructor(cache: ISRCache);
+    revalidate<T>(key: string, generator: () => Promise<T>): Promise<T>;
+    revalidateIfStale<T>(key: string, generator: () => Promise<T>): Promise<T | null>;
+}
+
+export { ISRCache, type ISRCacheConfig, type ISRCacheEntry, ISRRevaluator };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+interface ISRCacheConfig {
+    maxAge?: number;
+    revalidate?: number;
+    staleWhileRevalidate?: number;
+}
+interface ISRCacheEntry<T = unknown> {
+    key: string;
+    value: T;
+    createdAt: number;
+    expiresAt: number;
+    revalidateAt?: number;
+}
+
+declare class ISRCache {
+    private cache;
+    private defaultMaxAge;
+    constructor(config?: ISRCacheConfig);
+    get<T>(key: string): T | null;
+    set<T>(key: string, value: T, config?: ISRCacheConfig): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    isStale(key: string): boolean;
+}
+
+declare class ISRRevaluator {
+    private cache;
+    constructor(cache: ISRCache);
+    revalidate<T>(key: string, generator: () => Promise<T>): Promise<T>;
+    revalidateIfStale<T>(key: string, generator: () => Promise<T>): Promise<T | null>;
+}
+
+export { ISRCache, type ISRCacheConfig, type ISRCacheEntry, ISRRevaluator };

package/dist/index.mjs

@@ -0,0 +1,85 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/cache.ts
+var ISRCache = class {
+  constructor(config = {}) {
+    __publicField(this, "cache", /* @__PURE__ */ new Map());
+    __publicField(this, "defaultMaxAge");
+    this.defaultMaxAge = config.maxAge ?? 36e5;
+  }
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return null;
+    const now = Date.now();
+    if (entry.expiry < now) {
+      this.cache.delete(key);
+      return null;
+    }
+    return entry.value;
+  }
+  set(key, value, config) {
+    const now = Date.now();
+    const { maxAge = this.defaultMaxAge, revalidate } = {
+      maxAge: this.defaultMaxAge,
+      revalidate: config?.revalidate
+    };
+    this.cache.set(key, {
+      value,
+      expiry: now + maxAge,
+      revalidateAt: revalidate ? now + revalidate : void 0,
+      createdAt: now
+    });
+  }
+  has(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    if (Date.now() > entry.expiry) {
+      this.cache.delete(key);
+      return false;
+    }
+    return true;
+  }
+  delete(key) {
+    return this.cache.delete(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+  isStale(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    if (!entry.revalidateAt) return false;
+    return Date.now() >= entry.revalidateAt;
+  }
+};
+
+// src/revalidate.ts
+var ISRRevaluator = class {
+  constructor(cache) {
+    __publicField(this, "cache", cache);
+  }
+  async revalidate(key, generator) {
+    const value = await generator();
+    this.cache.set(key, value);
+    return value;
+  }
+  async revalidateIfStale(key, generator) {
+    if (!this.cache.has(key)) {
+      const value = await generator();
+      this.cache.set(key, value);
+      return value;
+    }
+    if (this.cache.isStale(key)) {
+      const value = await generator();
+      this.cache.set(key, value);
+      return value;
+    }
+    return this.cache.get(key);
+  }
+};
+
+export { ISRCache, ISRRevaluator };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts","../src/revalidate.ts"],"names":[],"mappings":";;;;;AASO,IAAM,WAAN,MAAe;AAAA,EAIpB,WAAA,CAAY,MAAA,GAAyB,EAAC,EAAG;AAHzC,IAAA,aAAA,CAAA,IAAA,EAAQ,OAAA,sBAAsD,GAAA,EAAI,CAAA;AAClE,IAAA,aAAA,CAAA,IAAA,EAAQ,eAAA,CAAA;AAGN,IAAA,IAAA,CAAK,aAAA,GAAgB,OAAO,MAAA,IAAU,IAAA;AAAA,EACxC;AAAA,EAEA,IAAO,GAAA,EAAuB;AAC5B,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AAEnB,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,IAAI,KAAA,CAAM,SAAS,GAAA,EAAK;AACtB,MAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AACrB,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,OAAO,KAAA,CAAM,KAAA;AAAA,EACf;AAAA,EAEA,GAAA,CAAO,GAAA,EAAa,KAAA,EAAU,MAAA,EAA+B;AAC3D,IAAA,MAAM,GAAA,GAAM,KAAK,GAAA,EAAI;AACrB,IAAA,MAAM,EAAE,MAAA,GAAS,IAAA,CAAK,aAAA,EAAe,YAAW,GAAI;AAAA,MAClD,QAAQ,IAAA,CAAK,aAAA;AAAA,MACb,YAAY,MAAA,EAAQ;AAAA,KACtB;AAEA,IAAA,IAAA,CAAK,KAAA,CAAM,IAAI,GAAA,EAAK;AAAA,MAClB,KAAA;AAAA,MACA,QAAQ,GAAA,GAAM,MAAA;AAAA,MACd,YAAA,EAAc,UAAA,GAAa,GAAA,GAAM,UAAA,GAAa,MAAA;AAAA,MAC9C,SAAA,EAAW;AAAA,KACZ,CAAA;AAAA,EACH;AAAA,EAEA,IAAI,GAAA,EAAsB;AACxB,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,KAAA;AACnB,IAAA,IAAI,IAAA,CAAK,GAAA,EAAI,GAAI,KAAA,CAAM,MAAA,EAAQ;AAC7B,MAAA,IAAA,CAAK,KAAA,CAAM,OAAO,GAAG,CAAA;AACrB,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,OAAO,GAAA,EAAsB;AAC3B,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,GAAG,CAAA;AAAA,EAC9B;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACnB;AAAA,EAEA,QAAQ,GAAA,EAAsB;AAC5B,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,OAAO,OAAO,KAAA;AACnB,IAAA,IAAI,CAAC,KAAA,CAAM,YAAA,EAAc,OAAO,KAAA;AAChC,IAAA,OAAO,IAAA,CAAK,GAAA,EAAI,IAAK,KAAA,CAAM,YAAA;AAAA,EAC7B;AACF;;;ACnEO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,KAAA,EAAiB;AAAjB,IAAA,aAAA,CAAA,IAAA,EAAA,OAAA,EAAA,KAAA,CAAA;AAAA,EAAkB;AAAA,EAEtC,MAAM,UAAA,CAAc,GAAA,EAAa,SAAA,EAAyC;AACxE,IAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,EAAU;AAC9B,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,MAAM,iBAAA,CAAqB,GAAA,EAAa,SAAA,EAAgD;AACtF,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAG,CAAA,EAAG;AACxB,MAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,EAAU;AAC9B,MAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AACzB,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AAC3B,MAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,EAAU;AAC9B,MAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AACzB,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAO,GAAG,CAAA;AAAA,EAC9B;AACF","file":"index.mjs","sourcesContent":["import type { ISRCacheConfig } from './types';\n\ninterface ExtendedCacheEntry<V> {\n  value: V;\n  expiry: number;\n  revalidateAt?: number;\n  createdAt: number;\n}\n\nexport class ISRCache {\n  private cache: Map<string, ExtendedCacheEntry<unknown>> = new Map();\n  private defaultMaxAge: number;\n\n  constructor(config: ISRCacheConfig = {}) {\n    this.defaultMaxAge = config.maxAge ?? 3600000;\n  }\n\n  get<T>(key: string): T | null {\n    const entry = this.cache.get(key);\n    if (!entry) return null;\n\n    const now = Date.now();\n    if (entry.expiry < now) {\n      this.cache.delete(key);\n      return null;\n    }\n\n    return entry.value as T;\n  }\n\n  set<T>(key: string, value: T, config?: ISRCacheConfig): void {\n    const now = Date.now();\n    const { maxAge = this.defaultMaxAge, revalidate } = {\n      maxAge: this.defaultMaxAge,\n      revalidate: config?.revalidate,\n    };\n\n    this.cache.set(key, {\n      value,\n      expiry: now + maxAge,\n      revalidateAt: revalidate ? now + revalidate : undefined,\n      createdAt: now,\n    });\n  }\n\n  has(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n    if (Date.now() > entry.expiry) {\n      this.cache.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  delete(key: string): boolean {\n    return this.cache.delete(key);\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  isStale(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n    if (!entry.revalidateAt) return false;\n    return Date.now() >= entry.revalidateAt;\n  }\n}\n","import type { ISRCache } from './cache';\n\nexport class ISRRevaluator {\n  constructor(private cache: ISRCache) {}\n\n  async revalidate<T>(key: string, generator: () => Promise<T>): Promise<T> {\n    const value = await generator();\n    this.cache.set(key, value);\n    return value;\n  }\n\n  async revalidateIfStale<T>(key: string, generator: () => Promise<T>): Promise<T | null> {\n    if (!this.cache.has(key)) {\n      const value = await generator();\n      this.cache.set(key, value);\n      return value;\n    }\n\n    if (this.cache.isStale(key)) {\n      const value = await generator();\n      this.cache.set(key, value);\n      return value;\n    }\n\n    return this.cache.get<T>(key);\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@lytjs/cache-isr",
+  "version": "6.6.0",
+  "description": "LytJS Incremental Static Regeneration (ISR) cache support",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@lytjs/common-cache": "workspace:*",
+    "@lytjs/common-is": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/lytjs/lytjs.git",
+    "directory": "packages/ecosystem/packages/ssr-kit/packages/cache-isr"
+  },
+  "keywords": [
+    "lytjs",
+    "isr",
+    "cache",
+    "incremental-static-regeneration"
+  ]
+}