Added the "analytics.recorder" flag to the Website service.

2026-08-13 01:29:44 +02:00
parent 4bb3e9098c
commit 397ad6b896
6 changed files with 143 additions and 0 deletions
@@ -14,6 +14,43 @@ package extension ConfigReader {

    // MARK: Computed

+    /// The analytics tracker the landing page embeds, built from the `analytics.*` keys, or `nil` when `analytics.websiteID` resolves
+    /// empty — a deployment disables analytics entirely by clearing the identifier.
+    ///
+    /// The script URL is not configurable: its origin is single-sourced in `String.Analytics`, so the tracker tag and the
+    /// `Content-Security-Policy` that must allow it derive from one constant and cannot drift apart.
+    ///
+    /// The `analytics.domains` filter must name the host the pages are served from — i.e. the host of ``siteOrigin``. The two keys are
+    /// independent, so a deployment that overrides `site.origin` without matching `analytics.domains` reports from a host it no longer
+    /// serves and records nothing; change them together.
+    ///
+    /// Recorder mode is on by default — the pages embed the session recorder script alongside the tracker — and the `analytics.recorder`
+    /// flag turns it off for a deployment. The recorder loads from the same origin as the tracker, so the `Content-Security-Policy` needs
+    /// no extra allowance.
+    var analytics: Analytics? {
+        let websiteID = string(
+            forKey: .Analytics.websiteID,
+            default: .Analytics.websiteID
+        )
+
+        guard !websiteID.isEmpty else {
+            return nil
+        }
+
+        return .init(
+            scriptURL: .Analytics.scriptURL,
+            websiteID: websiteID,
+            domains: string(
+                forKey: .Analytics.domains,
+                default: .Analytics.domains
+            ),
+            recorder: bool(
+                forKey: .Analytics.recorder,
+                default: true
+            )
+        )
+    }
+
    /// 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