@vizamodo/edge-cache-core 0.3.26

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./runtime/cache";

package/dist/index.js

@@ -0,0 +1 @@
+export * from "./runtime/cache";

package/dist/runtime/cache.d.ts

@@ -0,0 +1,6 @@
+type Options = {
+    ttlSec?: number;
+    forceRefresh?: boolean;
+};
+export declare function getCachedOrFetch<T>(key: string, fetcher: () => Promise<T>, options?: Options): Promise<T>;
+export {};

package/dist/runtime/cache.js

@@ -0,0 +1,22 @@
+import { getEdgeCache, setEdgeCache } from "./edge-cache";
+const memory = new Map();
+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 edge = await getEdgeCache(key);
+        if (edge) {
+            memory.set(key, edge);
+            return edge;
+        }
+    }
+    // L3: fetch
+    const value = await fetcher();
+    // write back
+    memory.set(key, value);
+    await setEdgeCache(key, value, options?.ttlSec ?? 3000);
+    return value;
+}

package/dist/runtime/edge-cache.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generic edge cache GET helper
+ */
+export declare function getEdgeCache<T>(key: string): Promise<T | null>;
+/**
+ * Generic edge cache SET helper
+ */
+export declare function setEdgeCache(key: string, value: unknown, ttlSec: number): Promise<void>;

package/dist/runtime/edge-cache.js

@@ -0,0 +1,46 @@
+const CACHE_KEY_PREFIX = "https://edge-cache.internal/";
+/**
+ * Generic edge cache GET helper
+ */
+export async function getEdgeCache(key) {
+    try {
+        const cache = caches.default;
+        const req = new Request(CACHE_KEY_PREFIX + key);
+        const res = await cache.match(req);
+        if (!res)
+            return null;
+        try {
+            return (await res.json());
+        }
+        catch {
+            // corrupted cache entry → ignore
+            return null;
+        }
+    }
+    catch {
+        // cache API failure should not break runtime
+        return null;
+    }
+}
+/**
+ * Generic edge cache SET helper
+ */
+export async function setEdgeCache(key, value, ttlSec) {
+    if (ttlSec <= 0)
+        return;
+    const cache = caches.default;
+    const req = new Request(CACHE_KEY_PREFIX + key);
+    const body = JSON.stringify(value);
+    const res = new Response(body, {
+        headers: {
+            "Content-Type": "application/json",
+            "Cache-Control": `max-age=${ttlSec}`,
+        },
+    });
+    try {
+        await cache.put(req, res);
+    }
+    catch {
+        // cache write failure is non-fatal
+    }
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@vizamodo/edge-cache-core",
+  "version": "0.3.26",
+  "description": "Edge cache primitives for Cloudflare Workers (L1 memory + L2 edge cache)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "release:prod": "rm -rf dist && npx npm-check-updates -u && npm install && git add package.json package-lock.json && git commit -m 'chore(deps): auto update dependencies before release' || echo 'No changes' && node versioning.js && npm publish --tag latest --access public && git push",
+    "release:full": "rm -rf dist && npx npm-check-updates -u && npm install && git add package.json package-lock.json && git commit -m 'chore(deps): auto update dependencies before release' || echo 'No changes' && node versioning.js && npm login && npm publish --tag latest --access public && git push"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}