Static file caching for the Website service (#6)

This PR contains the work done to add cache-control headers to static file responses by configuring the `FileMiddleware` middleware to tag served static files with *Cache-Control* directives, tuned per media type. To provide further details about the work done: * Added a cache control that sets per-type policies: text assets (CSS/JS) get public, max-age, must-revalidate; images get public, max-age; everything else gets a default public, max-age. * Files stay validated via `ETag/Last-Modified` header. * Made the max-age values configurable, with defaults, via new cache constants. Reviewed-on: rock-n-code/loud-amsterdam#6 Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>
2026-06-28 05:49:32 +00:00
parent a621ada0bf
commit 6c1a0f713b
6 changed files with 94 additions and 6 deletions
@@ -1,6 +1,15 @@
 import Configuration

 extension ConfigKey {
+    /// A namespace for the static files cache configuration keys.
+    public enum Cache {
+        /// The configuration key for the max-age, in seconds, applied to text-based static files (CSS, JavaScript, plain text).
+        public static let maxAgeText: ConfigKey = "cache.maxAge.text"
+        /// The configuration key for the max-age, in seconds, applied to image static files (ICO, PNG, SVG).
+        public static let maxAgeImage: ConfigKey = "cache.maxAge.image"
+        /// The configuration key for the max-age, in seconds, applied to all other static files (e.g. the web manifest).
+        public static let maxAgeDefault: ConfigKey = "cache.maxAge.default"
+    }
    /// A namespace for the HTTP server configuration keys.
    public enum HTTP {
        /// The configuration key for the host the server binds to.