From 75506b48b74535abda5995cef6517b8c713b98d6 Mon Sep 17 00:00:00 2001
From: FuelBoard Contributor <fuelboard@localhost>
Date: Fri, 14 Aug 2026 23:23:06 +0100
Subject: [PATCH] =?UTF-8?q?Telemetry:=20tag=20relay=20fetches=20with=20X-C?=
 =?UTF-8?q?lient=20(app/widget)=20=E2=80=94=20app=20via=20RelayFuelProvide?=
 =?UTF-8?q?r,=20widget=20focused/fuel-only=20fetches=20+=20diag=20beacon;?=
 =?UTF-8?q?=20Siri=20untouched=20(cached-only).=20Purely=20observational?=
 =?UTF-8?q?=20for=20relay=20admin=20/stats.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 FuelBoardWidgets/FuelPriceWidget.swift |  9 +++------
 Shared/FuelPriceProvider.swift         | 16 +++++++++++++++-
 2 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/FuelBoardWidgets/FuelPriceWidget.swift b/FuelBoardWidgets/FuelPriceWidget.swift
index 409e6a0..d897cad 100644
--- a/FuelBoardWidgets/FuelPriceWidget.swift
+++ b/FuelBoardWidgets/FuelPriceWidget.swift
@@ -166,8 +166,7 @@ struct FuelPriceTimelineProvider<Configuration: WidgetConfigurationIntent & Widg
             URLQueryItem(name: "price", value: String(first?.prices[entry.fuel] ?? -1)),
         ]
         guard let url = components.url else { return }
-        var request = URLRequest(url: url)
-        request.timeoutInterval = 2
+        var request = RelayFuelProvider.relayRequest(url, client: "widget", timeout: 2)
         Task {
             _ = try? await URLSession.shared.data(for: request)
         }
@@ -313,8 +312,7 @@ struct FuelPriceTimelineProvider<Configuration: WidgetConfigurationIntent & Widg
             URLQueryItem(name: "radius", value: String(radiusKM)),
             URLQueryItem(name: "limit", value: "500"),
         ]
-        var request = URLRequest(url: components.url!)
-        request.timeoutInterval = 5
+        var request = RelayFuelProvider.relayRequest(components.url!, client: "widget", timeout: 5)
         do {
             let (data, response) = try await URLSession.shared.data(for: request)
             guard let http = response as? HTTPURLResponse, http.statusCode == 200 else { return nil }
@@ -337,8 +335,7 @@ struct FuelPriceTimelineProvider<Configuration: WidgetConfigurationIntent & Widg
             URLQueryItem(name: "fuel", value: fuel.rawValue),
             URLQueryItem(name: "limit", value: String(limit)),
         ]
-        var request = URLRequest(url: components.url!)
-        request.timeoutInterval = 5
+        var request = RelayFuelProvider.relayRequest(components.url!, client: "widget", timeout: 5)
         do {
             let (data, response) = try await URLSession.shared.data(for: request)
             guard let http = response as? HTTPURLResponse, http.statusCode == 200 else { return nil }
diff --git a/Shared/FuelPriceProvider.swift b/Shared/FuelPriceProvider.swift
index f769ec6..a9fafaf 100644
--- a/Shared/FuelPriceProvider.swift
+++ b/Shared/FuelPriceProvider.swift
@@ -71,6 +71,19 @@ struct RelayFuelProvider: FuelPriceProviding {
     /// dataset update time). Written by fetchStations, read by the view.
     static var latestMeta: RelayMeta?
 
+    /// Admin telemetry: the relay tags inbound connections by client kind
+    /// (app vs widget) so the developer can monitor the poll model. Siri
+    /// never fetches (cached-data-first). Purely observational — the relay
+    /// ignores the header for responses.
+    static let clientTagHeader = "X-Client"
+
+    static func relayRequest(_ url: URL, client: String, timeout: TimeInterval = 30) -> URLRequest {
+        var request = URLRequest(url: url)
+        request.timeoutInterval = timeout
+        request.setValue(client, forHTTPHeaderField: clientTagHeader)
+        return request
+    }
+
     func fetchStations(near lat: Double?, lng: Double?, fuel: FuelType, radiusKM: Double?) async throws -> [FuelStation] {
         var components = URLComponents(url: baseURL.appendingPathComponent("api/v1/stations"), resolvingAgainstBaseURL: false)!
         var query: [URLQueryItem] = [URLQueryItem(name: "fuel", value: fuel.rawValue)]
@@ -89,7 +102,8 @@ struct RelayFuelProvider: FuelPriceProviding {
         }
         components.queryItems = query
 
-        let (data, response) = try await URLSession.shared.data(from: components.url!)
+        let request = RelayFuelProvider.relayRequest(components.url!, client: "app")
+        let (data, response) = try await URLSession.shared.data(for: request)
         guard let http = response as? HTTPURLResponse, http.statusCode == 200 else {
             throw FuelProviderError.relayUnavailable
         }