Cache adapter (Redis)

The CacheAdapter is a small abstraction on top of Bun's native Redis client, focused on:

• set (permanent or with TTL)
• get (typed, always returns an object)
• exists
• remove

Import

import { CacheAdapter } from "@grupodiariodaregiao/bunstone";

Setup

By default it uses Bun's global redis client (reads REDIS_URL / VALKEY_URL).

const cache = new CacheAdapter();

Or pass a custom connection URL:

const cache = new CacheAdapter({ url: "redis://localhost:6379" });

Set

await cache.set("user:1", { id: 1, name: "Alice" }, { permanent: true });
await cache.set("session:123", { userId: 1 }, { ttlSeconds: 60 * 60 }); // 1 hour

Get (typed)

get<T>() parses JSON automatically and always returns an object (if the key is missing, it returns {}).

type UserCache = { id: number; name: string };
const user = await cache.get<UserCache>("user:1");

Exists / Remove

const exists = await cache.exists("user:1");
await cache.remove("user:1");

## Practical Example

See how to use the Cache Adapter in a controller:

<<< @/../examples/07-adapters/index.ts

[See it on GitHub](https://github.com/diariodaregiao/bunstone/blob/main/examples/07-adapters/index.ts)