let cache = PrismCache<String, User>(maxEntries: 1000, defaultTTL: 300)

// Store
await cache.set("user:1", value: user)

// Retrieve
if let cached = await cache.get("user:1") {
    print("Cache hit: \(cached.name)")
}

// Store with custom TTL
await cache.set("session:abc", value: session, ttl: 3600)

await cache.set(key, value: value)           // Store with default TTL
await cache.set(key, value: value, ttl: 60)  // Store with custom TTL
await cache.get(key)                         // Get or nil if expired
await cache.has(key)                         // Check existence
await cache.remove(key)                      // Remove specific key
await cache.clear()                          // Remove everything
await cache.purgeExpired()                   // Remove only expired entries
await cache.count                            // Number of entries

let cache = PrismCache<String, String>(maxEntries: 3, defaultTTL: 60)

await cache.set("a", value: "1")
await cache.set("b", value: "2")
await cache.set("c", value: "3")
_ = await cache.get("a")          // "a" promoted to most recent

await cache.set("d", value: "4")  // "b" evicted (least recently used)
await cache.get("b")              // nil — evicted

await server.use(PrismResponseCacheMiddleware(
    maxEntries: 500,
    ttl: 60
))

await server.use(PrismResponseCacheMiddleware(
    maxEntries: 1000,
    ttl: 120,
    cachePredicate: { request in
        request.method == .GET && request.path.hasPrefix("/api/")
    }
))

let queryCache = PrismCache<String, [User]>(maxEntries: 100, defaultTTL: 60)

await server.get("/users") { request in
    let cacheKey = "users:\(request.queryParameters["page"] ?? "1")"

    if let cached = await queryCache.get(cacheKey) {
        return .json(cached)
    }

    let users = try await db.query("SELECT * FROM users LIMIT 20")
    await queryCache.set(cacheKey, value: users)
    return .json(users)
}

// Invalidate on writes
await server.post("/users") { request in
    let user = try request.decodeJSON() as CreateUser
    try await db.execute("INSERT INTO users ...")
    await queryCache.clear()  // Invalidate all user caches
    return .json(["status": "created"], status: .created)
}