@unkey/cache

npm install @unkey/cache

import { createCache, DefaultStatefulContext, Namespace } from "@unkey/cache";
import { MemoryStore } from "@unkey/cache/stores";

type User = { id: string; email: string };

// Cloudflare Workers and Vercel hand you an execution context; elsewhere use this one.
const ctx = new DefaultStatefulContext();

const memory = new MemoryStore({ persistentMap: new Map() });

const cache = createCache({
  user: new Namespace<User>(ctx, {
    stores: [memory],
    fresh: 60_000,   // serve without revalidating for 60 s
    stale: 900_000,  // serve stale and revalidate in the background for up to 15 min
  }),
});

await cache.user.set("user_42", { id: "user_42", email: "ada@example.com" });

const { val: user, err } = await cache.user.get("user_42");
if (err) {
  // a CacheError from a store; decide whether to fall through to the origin
}

const { val: user } = await cache.user.swr("user_42", async (id) => {
  return await db.users.findById(id);
});

import { withEncryption } from "@unkey/cache/middleware";

const encrypted = await withEncryption(process.env.CACHE_ENCRYPTION_KEY ?? "");

const cache = createCache({
  user: new Namespace<User>(ctx, {
    stores: [encrypted.wrap(memory)],
    fresh: 60_000,
    stale: 900_000,
  }),
});