Added immutable caching to the fingerprinted media types for the ConfigReader+Properties extension in the Website service target.

2026-08-25 16:59:07 +02:00
parent 988090a511
commit 7aee1cd949
3 changed files with 56 additions and 6 deletions
@@ -56,10 +56,15 @@ package extension ConfigReader {
    /// The `Cache-Control` policy applied to static files, grouped by media type.
    ///
    /// The max-ages are read from the `cache.maxAge.asset`, `cache.maxAge.text`, `cache.maxAge.image`, and
-    /// `cache.maxAge.default` keys. Stylesheets and scripts are referenced through fingerprinted URLs (see `FingerprintAssets`) and
-    /// fonts are immutable subset files, so all three are served long-lived and `immutable` — a deploy busts them by changing the URL, never by
-    /// revalidation. The remaining text files (e.g. `robots.txt`) keep their unversioned URLs and require revalidation once stale; images and
-    /// everything else are served public with their max-age alone. The groups match in order, so the specific types precede the `text` category.
+    /// `cache.maxAge.default` keys. Stylesheets, scripts, videos, JPEGs, and WebPs are referenced through fingerprinted URLs (see
+    /// `FingerprintAssets`) and fonts are immutable subset files, so all of them are served long-lived and `immutable` — a deploy busts them by
+    /// changing the URL, never by revalidation. The remaining text files (e.g. `robots.txt`) keep their unversioned URLs and require revalidation
+    /// once stale; the remaining images cannot be `immutable` — the group covers the icons, and a browser fetches `/favicon.ico` unversioned
+    /// whatever the markup says — and everything else is served public with its max-age alone. The groups match in order, so the specific types
+    /// precede the `text` and `image` categories.
+    ///
+    /// - Important: an image the markup references without a `?v=` token must be in neither JPEG nor WebP, or it is served immutable for a year and
+    ///   a deploy cannot dislodge it.
    var cacheControl: CacheControl {
        let maxAgeAsset = int(
            forKey: .Cache.maxAgeAsset,
@@ -82,6 +87,9 @@ package extension ConfigReader {
            (.textCss, [.public, .maxAge(maxAgeAsset), .immutable]),
            (.textJavascript, [.public, .maxAge(maxAgeAsset), .immutable]),
            (.font, [.public, .maxAge(maxAgeAsset), .immutable]),
+            (.videoMp4, [.public, .maxAge(maxAgeAsset), .immutable]),
+            (.imageJpeg, [.public, .maxAge(maxAgeAsset), .immutable]),
+            (.imageWebp, [.public, .maxAge(maxAgeAsset), .immutable]),
            (.text, [.public, .maxAge(maxAgeText), .mustRevalidate]),
            (.image, [.public, .maxAge(maxAgeImage)]),
            (.init(type: .any), [.public, .maxAge(maxAgeDefault)]),