Cache Control Plugin - no more manually setting HTTP headers

[johnny-woodtke]

🚀 Introducing elysiajs-cdn-cache: Type-Safe CDN Caching Made Simple!

Hey Elysia community! 👋

I'm excited to share a new plugin that solves one of the most tedious parts of building performant APIs: managing Cache-Control headers.

🎯 What is elysiajs-cdn-cache?

A TypeScript-first CDN caching plugin that provides a fluent, chainable API for managing cache directives. No more manually crafting cache header strings or worrying about typos!

import { Elysia } from "elysia";
import { cacheControl, CacheControl } from "elysiajs-cdn-cache";

const app = new Elysia()

  .use(
    cacheControl(
      "Cache-Control",
      "Vercel-CDN-Cache-Control"
    )
  )
  
  .get("/api/posts", ({ cacheControl }) => {
    // ✨ Type-safe, chainable cache control
    cacheControl.set(
      "Cache-Control",
      new CacheControl()
        .set("public", true)
        .set("max-age", 300) // Browser: 5 minutes
    );

    cacheControl.set(
      "Vercel-CDN-Cache-Control", 
      new CacheControl()
        .set("public", true)
        .set("s-maxage", 3600) // Vercel CDN: 1 hour
    );

    return await getPosts();
  });

🔥 Why You'll Love It

• 🎯 Type-safe - Full TypeScript support with auto-completion
• 🔧 Fluent API - Chainable methods that feel natural
• 🌐 Multi-CDN support - Handle any Cache-Control HTTP header
• 📝 Auto-parsing - Parse existing headers from requests
• ⚡ Zero dependencies - Lightweight with only Elysia as dependency

🌐 See It In Action

Live Demo: https://elysiajs-cdn-cache.vercel.app/

Try these endpoints to see different caching strategies:

• General API: https://elysiajs-cdn-cache.vercel.app/api
• Private content: https://elysiajs-cdn-cache.vercel.app/api/user123
• Bulk data: https://elysiajs-cdn-cache.vercel.app/api/all

Open DevTools → Network tab and check the Cache-Control headers! 🔍

💡 Perfect For

• Static assets with long-term caching + immutable
• API responses with different browser/CDN cache durations
• Private content that should only cache in browsers
• Multi-tier CDN setups (Vercel + Cloudflare, etc.)

📦 Get Started

bun add elysiajs-cdn-cache

Docs & Examples: https://github.com/johnny-woodtke/elysiajs-cdn-cache

---

What do you think? Have you been manually setting cache headers? Would love to hear your thoughts and use cases!