@vizamodo/edge-cache-core 0.3.26 → 0.3.27

package/dist/runtime/cache.d.ts

@@ -1,6 +1,12 @@
-type Options = {
-    ttlSec?: number;
+export type CacheOptions = {
+    ttlSec: number;
     forceRefresh?: boolean;
 };
-export declare function getCachedOrFetch<T>(key: string, fetcher: () => Promise<T>, options?: Options): Promise<T>;
-export {};
+/**
+ * Two-level cache: L1 in-memory → L2 edge → L3 fetcher.
+ *
+ * - forceRefresh: skips L1 + L2, always calls the fetcher and writes back.
+ * - ttlSec: edge cache TTL in seconds (REQUIRED). Pass 0 to skip edge write.
+ * - Edge and memory write failures are non-fatal and will not throw.
+ */
+export declare function getCachedOrFetch<T>(key: string, fetcher: () => Promise<T>, options: CacheOptions): Promise<T>;

package/dist/runtime/cache.js

@@ -1,22 +1,35 @@
 import { getEdgeCache, setEdgeCache } from "./edge-cache";
 const memory = new Map();
+/**
+ * Two-level cache: L1 in-memory → L2 edge → L3 fetcher.
+ *
+ * - forceRefresh: skips L1 + L2, always calls the fetcher and writes back.
+ * - ttlSec: edge cache TTL in seconds (REQUIRED). Pass 0 to skip edge write.
+ * - Edge and memory write failures are non-fatal and will not throw.
+ */
 export async function getCachedOrFetch(key, fetcher, options) {
-    // L1: memory (skip if forceRefresh)
-    if (!options?.forceRefresh && memory.has(key)) {
-        return memory.get(key);
-    }
-    // L2: edge cache (skip if forceRefresh)
-    if (!options?.forceRefresh) {
+    const { forceRefresh = false, ttlSec } = options;
+    if (!forceRefresh) {
+        // L1: memory
+        if (memory.has(key)) {
+            return memory.get(key);
+        }
+        // L2: edge cache
         const edge = await getEdgeCache(key);
-        if (edge) {
+        if (edge !== null) {
             memory.set(key, edge);
             return edge;
         }
     }
-    // L3: fetch
+    // L3: fetch from source
     const value = await fetcher();
-    // write back
+    // Write back to both layers — edge write is best-effort
     memory.set(key, value);
-    await setEdgeCache(key, value, options?.ttlSec ?? 3000);
+    try {
+        await setEdgeCache(key, value, ttlSec);
+    }
+    catch {
+        // non-fatal
+    }
     return value;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizamodo/edge-cache-core",
-  "version": "0.3.26",
+  "version": "0.3.27",
   "description": "Edge cache primitives for Cloudflare Workers (L1 memory + L2 edge cache)",
   "type": "module",
   "main": "dist/index.js",