Interface CacheControlOptions

src/utils/cacheControl.ts:17–41

}

interface CacheControlOptions {
  // Cacheability
  public?: boolean; // Allow caching in both browsers and CDNs
  private?: boolean; // Allow caching only in browsers, not CDNs

  // No caching
  noCache?: boolean; // Cache exists but verifies with server every time
  noStore?: boolean; // Don't cache at all, fetch fresh every time

  // Freshness (in seconds)
  maxAge?: number; // How long browsers should keep cache without checking server
  sMaxAge?: number; // How long CDNs should keep cache without checking server

  // Stale content handling (in seconds)
  staleWhileRevalidate?: number; // Show old cache while fetching new data in background
  staleIfError?: number; // Show old cache if server fails to respond

  // Revalidation
  mustRevalidate?: boolean; // Force check with server when cache expires (both cdn and browser)
  proxyRevalidate?: boolean; // Force only CDNs to check with server when cache expires

  // Other directives
  immutable?: boolean; // Content won't change while cache is valid
  noTransform?: boolean; // Don't allow CDNs to modify the response
}

export function setCacheHeaders(
  res: NextApiResponse,