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
@@ -1,6 +1,15 @@
 import Configuration

 extension AbsoluteConfigKey {
+    /// A namespace for the analytics configuration keys, as absolute keys.
+    public enum Analytics {
+        /// The absolute configuration key for the analytics website identifier.
+        public static let websiteID: AbsoluteConfigKey = .init(.Analytics.websiteID)
+        /// The absolute configuration key for the comma-delimited domains the tracker reports from.
+        public static let domains: AbsoluteConfigKey = .init(.Analytics.domains)
+        /// The absolute configuration key for recorder mode, loading the session recorder script alongside the tracker.
+        public static let recorder: AbsoluteConfigKey = .init(.Analytics.recorder)
+    }
    /// A namespace for the static files cache configuration keys, as absolute keys.
    public enum Cache {
        /// The absolute configuration key for the max-age, in seconds, applied to fingerprinted assets and fonts.
@@ -1,6 +1,15 @@
 import Configuration

 extension ConfigKey {
+    /// A namespace for the analytics configuration keys.
+    public enum Analytics {
+        /// The configuration key for the analytics website identifier (cleared to disable analytics).
+        public static let websiteID: ConfigKey = "analytics.websiteID"
+        /// The configuration key for the comma-delimited domains the tracker reports from.
+        public static let domains: ConfigKey = "analytics.domains"
+        /// The configuration key for recorder mode, loading the session recorder script alongside the tracker (set to `false` to disable).
+        public static let recorder: ConfigKey = "analytics.recorder"
+    }
    /// A namespace for the static files cache configuration keys.
    public enum Cache {
        /// The configuration key for the max-age, in seconds, applied to fingerprinted assets (CSS, JavaScript) and fonts.
@@ -1,4 +1,21 @@
 extension String {
+    /// A namespace for the analytics default configuration values.
+    public enum Analytics {
+        /// The origin the analytics scripts are loaded from and their beacons are sent to (scheme and host, no trailing slash).
+        ///
+        /// Single-sourced here: both ``scriptURL`` and the session recorder script the pages embed in recorder mode derive from this
+        /// constant, and the site's `Content-Security-Policy` must allow it.
+        public static let origin = "https://analytics.rock-n-code.com"
+        /// The URL the analytics tracker script is loaded from.
+        public static let scriptURL = "\(origin)/script"
+        /// The default analytics website identifier the tracker reports as.
+        public static let websiteID = "f28681d6-20e8-43f3-9c3b-5d6a0f8e0591"
+        /// The default comma-delimited domains the tracker reports from; visits from any other host are ignored.
+        ///
+        /// Keep it paired with the host the pages are served at: a deployment that serves from another host without overriding
+        /// `analytics.domains` to match reports from a host it no longer serves, so analytics silently records nothing.
+        public static let domains = "loud.amsterdam"
+    }
    /// A namespace for the persistence's default configuration values and recognized tokens.
    public enum Database {
        /// The default persistence driver: in-memory SQLite, which needs no external infrastructure.