Repository Public
1// SP Wallet iOS2// File: Features/Alerts/AlertSettingsView.swift3// Description: The owner's alert settings as the server stores them: one switch per switchable kind (fixed kinds are shown4// locked, with the reason), quiet hours, hourly cap, thresholds, and the outgoing webhook. The webhook secret is5// write-only: the screen only knows « défini / non défini »; a rotation shows the new secret ONCE, in memory only.6//7// Author: Simon-Pierre Boucher8// Contact: contact@spboucher.ai9import SwiftUI10import SPWalletCore11import UniformTypeIdentifiers1213typealias ServerAlertSettings = SPWalletCore.AlertSettingsView1415struct AlertSettingsScreen: View {16 @Environment(AppModel.self) private var model17 @State private var view: Phase = .loading18 @State private var saveError: Error?19 @State private var saving = false20 static let cacheKey = "alerts-settings"2122 enum Phase { case loading, failed(Error), loaded(ServerAlertSettings, cachedAt: Date?) }2324 private var api: AlertsAPI { AlertsAPI(model.env.client) }2526 var body: some View {27 Form {28 if !model.canOperate { Section { FreshnessBanner().listRowInsets(.init()).listRowBackground(Color.clear) } }29 switch view {30 case .loading: Section { ProgressView().frame(maxWidth: .infinity) }31 case .failed(let e): Section { ErrorNotice(error: e) { Task { await load() } } }32 case .loaded(let v, let cachedAt):33 if let cachedAt {34 Section { Notice(tone: .warn, title: String(localized: "Réglages du \(cachedAt.formatted(date: .abbreviated, time: .shortened))"), message: String(localized: "Instantané hors ligne : lecture seule."), icon: "clock") }35 }36 if let e = saveError { Section { ErrorNotice(error: e) } }37 content(v).disabled(!model.canOperate || saving)38 }39 }40 .navigationTitle(String(localized: "Réglages des alertes")).navigationBarTitleDisplayMode(.inline)41 .task { await load() }42 .refreshable { await load() }43 }4445 private func load() async {46 guard model.canOperate else {47 if let c = await model.env.cache.load(ServerAlertSettings.self, key: Self.cacheKey) { view = .loaded(c.value, cachedAt: c.savedAt) }48 else { view = .failed(APIError(status: 0, code: "offline", message: "offline")) }49 return50 }51 do { let v = try await api.settings(); view = .loaded(v, cachedAt: nil); await model.env.cache.save(v, key: Self.cacheKey) }52 catch let e { if case .loaded = view { saveError = e } else { view = .failed(e) } }53 }5455 /** Send one partial change; what is shown afterwards is the server's answer, never the value that was typed. */56 private func save(_ patch: AlertSettingsPatch) async {57 saving = true; defer { saving = false }58 do { let v = try await api.update(patch); view = .loaded(v, cachedAt: nil); saveError = nil; await model.env.cache.save(v, key: Self.cacheKey) }59 catch let e { saveError = e }60 }6162 @ViewBuilder private func content(_ v: ServerAlertSettings) -> some View {63 let s = v.settings64 Section {65 NotificationSettingsRows()66 } header: { Text(String(localized: "Sur cet appareil")) } footer: {67 Text(String(localized: "Le serveur n’envoie pas de notification push aux apps natives (push web seulement). L’app relève donc les alertes elle-même : toutes les minutes quand elle est ouverte, et de temps en temps en arrière-plan, quand iOS le décide. Une alerte peut donc être notifiée en retard ; ne compte pas sur ce canal pour une urgence."))68 }69 Section {70 Toggle(String(localized: "Heures calmes"), isOn: Binding(get: { s.quiet.enabled }, set: { on in Task { await save(.init(quiet: .init(enabled: on))) } }))71 .accessibilityIdentifier("alertSettings.quiet")72 DatePicker(String(localized: "De"), selection: timeBinding(s.quiet.start) { v in .init(quiet: .init(start: v)) }, displayedComponents: .hourAndMinute)73 DatePicker(String(localized: "À"), selection: timeBinding(s.quiet.end) { v in .init(quiet: .init(end: v)) }, displayedComponents: .hourAndMinute)74 LabeledContent(String(localized: "Fuseau horaire"), value: s.quiet.tz)75 NumberSettingRow(label: String(localized: "Plafond par heure"), value: Double(s.capPerHour), range: 1...500, integer: true) { n in await save(.init(capPerHour: Int(n))) }76 } header: { Text(String(localized: "Heures calmes et plafond (serveur)")) } footer: {77 Text(String(localized: "Appliqués par le serveur à ses propres canaux (push web, webhook) ; les alertes critiques ne sont jamais retenues. Cette app ne notifie pas une alerte que le serveur a marquée « retenue ». Sans appareil web ni webhook, le serveur ne retient rien : les notifications locales suivent alors seulement l’interrupteur ci-dessus."))78 }79 Section {80 Toggle(String(localized: "Détails dans les push web"), isOn: Binding(get: { s.showDetails }, set: { on in Task { await save(.init(showDetails: on)) } }))81 } header: { Text(String(localized: "Confidentialité")) } footer: {82 Text(String(localized: "Concerne les notifications push des navigateurs. Les notifications de cette app n’affichent jamais de montant ni d’adresse sur l’écran verrouillé, quel que soit ce réglage."))83 }84 ForEach(AlertGroup.allCases, id: \.rawValue) { g in85 let kinds = v.kinds.filter { $0.group == g }86 if !kinds.isEmpty {87 Section(String(localized: "Alertes : \(g.label)")) {88 ForEach(kinds, id: \.kind) { k in kindRow(k, settings: s) }89 }90 }91 }92 let other = v.kinds.filter { !AlertGroup.allCases.contains($0.group) }93 if !other.isEmpty { Section(String(localized: "Alertes : autres")) { ForEach(other, id: \.kind) { k in kindRow(k, settings: s) } } }94 Section {95 let t = s.thresholds96 NumberSettingRow(label: String(localized: "Opération en attente après (min)"), value: Double(t.stuckMinutes), range: 5...1440, integer: true) { n in var p = AlertSettingsPatch.Thresholds(); p.stuckMinutes = Int(n); await save(.init(thresholds: p)) }97 NumberSettingRow(label: String(localized: "Transfert entre réseaux en attente après (min)"), value: Double(t.bridgeStuckMinutes), range: 10...2880, integer: true) { n in var p = AlertSettingsPatch.Thresholds(); p.bridgeStuckMinutes = Int(n); await save(.init(thresholds: p)) }98 NumberSettingRow(label: String(localized: "Regroupement des ordres d’agent (min, 0 = aucun)"), value: Double(t.agentDigestMinutes), range: 0...1440, integer: true) { n in var p = AlertSettingsPatch.Thresholds(); p.agentDigestMinutes = Int(n); await save(.init(thresholds: p)) }99 NumberSettingRow(label: String(localized: "Barres manquantes avant alerte"), value: Double(t.staleBars), range: 1...100, integer: true) { n in var p = AlertSettingsPatch.Thresholds(); p.staleBars = Int(n); await save(.init(thresholds: p)) }100 NumberSettingRow(label: String(localized: "Échecs de signal avant alerte"), value: Double(t.signalFailures), range: 1...50, integer: true) { n in var p = AlertSettingsPatch.Thresholds(); p.signalFailures = Int(n); await save(.init(thresholds: p)) }101 NumberSettingRow(label: String(localized: "Paiement de financement (USD)"), value: t.fundingUsd, range: 0...1_000_000, integer: false) { n in var p = AlertSettingsPatch.Thresholds(); p.fundingUsd = n; await save(.init(thresholds: p)) }102 NumberSettingRow(label: String(localized: "Source indisponible depuis (s)"), value: Double(t.feedDebounceSec), range: 30...3600, integer: true) { n in var p = AlertSettingsPatch.Thresholds(); p.feedDebounceSec = Int(n); await save(.init(thresholds: p)) }103 NumberSettingRow(label: String(localized: "Disque libre minimal (%)"), value: t.diskFreePct, range: 1...50, integer: false) { n in var p = AlertSettingsPatch.Thresholds(); p.diskFreePct = n; await save(.init(thresholds: p)) }104 NumberSettingRow(label: String(localized: "Sauvegarde absente après (h)"), value: Double(t.backupHours), range: 1...720, integer: true) { n in var p = AlertSettingsPatch.Thresholds(); p.backupHours = Int(n); await save(.init(thresholds: p)) }105 LabeledContent(String(localized: "Ordre réel sans réponse après (s)"), value: String(t.unknownOrderSec))106 } header: { Text(String(localized: "Seuils")) } footer: { Text(String(localized: "Valeurs enregistrées sur le serveur. Chaque champ accepte la plage que le serveur accepte ; une valeur hors plage n’est pas envoyée.")) }107 WebhookSection(view: v, save: save, reload: load)108 }109110 private func kindRow(_ k: AlertKindInfo, settings s: AlertSettings) -> some View {111 let title = AlertCatalog.definition(k.kind)?.title[AlertPresentation.locale == .fr ? 0 : 1] ?? k.kind.rawValue112 return HStack(spacing: 12) {113 SeverityPlate(severity: k.severity, size: 30)114 VStack(alignment: .leading, spacing: 2) {115 Text(title).font(.system(size: 15)).foregroundStyle(Theme.ink).fixedSize(horizontal: false, vertical: true)116 Text(k.fixed ? k.severity.word + " · " + String(localized: "non désactivable : imposée par le serveur") : k.severity.word)117 .font(.system(size: 12)).foregroundStyle(Theme.mute).fixedSize(horizontal: false, vertical: true)118 }119 Spacer(minLength: 8)120 if k.fixed {121 Pill(text: String(localized: "Toujours active"), tone: .ok, icon: "lock.fill")122 } else if let on = s.rules[k.kind.rawValue] {123 Toggle(title, isOn: Binding(get: { on }, set: { v in Task { await save(.rule(k.kind, on: v)) } })).labelsHidden()124 .accessibilityIdentifier("alertSettings.rule.\(k.kind.rawValue)")125 } else {126 // the server lists the kind but serves no switch state for it: nothing is assumed127 Text(String(localized: "état non servi")).font(.spFootnote).foregroundStyle(Theme.mute)128 }129 }130 .accessibilityElement(children: .contain)131 .listRowBackground(Theme.surface)132 .accessibilityHint(k.fixed ? String(localized: "Le serveur n’autorise pas à désactiver cette alerte.") : "")133 }134135 /** `HH:MM` ⇄ a Date of today; a change is sent as `HH:MM`. A value the app cannot parse is shown as midnight and never sent back unless changed. */136 private func timeBinding(_ hhmm: String, patch: @escaping (String) -> AlertSettingsPatch) -> Binding<Date> {137 Binding(get: { AlertTime.date(hhmm) ?? Calendar.current.startOfDay(for: Date()) }, set: { d in let v = AlertTime.text(d); if v != hhmm { Task { await save(patch(v)) } } })138 }139}140141enum AlertTime {142 static func date(_ hhmm: String, calendar: Calendar = .current) -> Date? {143 let p = hhmm.split(separator: ":").compactMap { Int($0) }144 guard p.count == 2, (0..<24).contains(p[0]), (0..<60).contains(p[1]) else { return nil }145 return calendar.date(bySettingHour: p[0], minute: p[1], second: 0, of: Date())146 }147 static func text(_ d: Date, calendar: Calendar = .current) -> String {148 let c = calendar.dateComponents([.hour, .minute], from: d)149 return String(format: "%02d:%02d", c.hour ?? 0, c.minute ?? 0)150 }151}152153/** A numeric server setting: typed, validated against the server's range, sent on « OK »; the row then shows the server's answer. */154struct NumberSettingRow: View {155 let label: String156 let value: Double157 let range: ClosedRange<Double>158 let integer: Bool159 let onSave: (Double) async -> Void160 @State private var text = ""161 @FocusState private var focused: Bool162163 static func parse(_ s: String, range: ClosedRange<Double>, integer: Bool) -> Double? {164 let t = s.trimmingCharacters(in: .whitespaces).replacingOccurrences(of: ",", with: ".")165 guard !t.isEmpty, let n = Double(t), n.isFinite, range.contains(n), !integer || n == n.rounded() else { return nil }166 return n167 }168 static func show(_ v: Double, integer: Bool) -> String { integer || v == v.rounded() ? String(Int64(v)) : String(v) }169170 var body: some View {171 let parsed = Self.parse(text, range: range, integer: integer)172 VStack(alignment: .leading, spacing: 4) {173 HStack {174 Text(label).font(.system(size: 15)).fixedSize(horizontal: false, vertical: true)175 Spacer(minLength: 8)176 TextField("", text: $text).keyboardType(.numbersAndPunctuation).multilineTextAlignment(.trailing).frame(width: 90)177 .focused($focused).submitLabel(.done)178 .foregroundStyle(parsed == nil ? Theme.danger : Theme.ink)179 .onSubmit { commit() }180 .accessibilityLabel(label)181 }182 if focused || parsed == nil {183 Text(String(localized: "Plage acceptée : \(Self.show(range.lowerBound, integer: true)) à \(Self.show(range.upperBound, integer: true))") + (parsed == nil ? " · " + String(localized: "valeur non envoyée") : ""))184 .font(.system(size: 12)).foregroundStyle(parsed == nil ? Theme.danger : Theme.mute)185 }186 }187 .onAppear { text = Self.show(value, integer: integer) }188 .onChange(of: value) { _, v in text = Self.show(v, integer: integer) }189 .onChange(of: focused) { _, f in if !f { commit() } }190 }191192 private func commit() {193 guard let n = Self.parse(text, range: range, integer: integer) else { text = Self.show(value, integer: integer); return }194 if n != value { Task { await onSave(n) } }195 }196}197198/** A webhook secret that was just generated: lives in view state only, shown once, copied with an expiring, device-only pasteboard item. */199struct WebhookSection: View {200 @Environment(AppModel.self) private var model201 let view: ServerAlertSettings202 let save: (AlertSettingsPatch) async -> Void203 let reload: () async -> Void204 @State private var url = ""205 @State private var secret: String?206 @State private var copied = false207 @State private var busy = false208 @State private var confirmRotate = false209 @State private var error: Error?210 @State private var test: AlertWebhookTestResult?211 static let pasteboardLifetime: TimeInterval = 60212213 static func urlProblem(_ s: String) -> String? {214 let t = s.trimmingCharacters(in: .whitespaces)215 if t.isEmpty { return nil }216 guard let u = URL(string: t), u.scheme == "https", let h = u.host, !h.isEmpty else { return String(localized: "Le serveur n’accepte qu’une URL https.") }217 return nil218 }219220 var body: some View {221 let w = view.settings.webhook222 Section {223 HStack { Text(String(localized: "État")); Spacer(); Pill(text: w.enabled ? String(localized: "Activé") : String(localized: "Désactivé"), tone: w.enabled ? .ok : .neutral, icon: w.enabled ? "checkmark" : "minus") }224 VStack(alignment: .leading, spacing: 4) {225 TextField(String(localized: "URL https du récepteur"), text: $url, axis: .vertical).font(.spMono).textInputAutocapitalization(.never).autocorrectionDisabled().keyboardType(.URL)226 .accessibilityIdentifier("webhook.url")227 if let p = Self.urlProblem(url) { Text(p).font(.system(size: 12)).foregroundStyle(Theme.danger) }228 if url.trimmingCharacters(in: .whitespaces) != w.url {229 Button(String(localized: "Enregistrer l’URL")) { Task { await save(.init(webhook: .init(url: url.trimmingCharacters(in: .whitespaces)))) } }230 .disabled(Self.urlProblem(url) != nil).accessibilityIdentifier("webhook.saveURL")231 }232 }233 HStack {234 VStack(alignment: .leading, spacing: 2) {235 Text(String(localized: "Secret partagé"))236 Text(view.webhook.secretSet ? String(localized: "défini") : String(localized: "non défini")).font(.spFootnote).foregroundStyle(view.webhook.secretSet ? Theme.emerald : Theme.mute)237 .accessibilityIdentifier("webhook.secretState")238 }239 Spacer()240 Button(view.webhook.secretSet ? String(localized: "Remplacer") : String(localized: "Générer")) { if view.webhook.secretSet { confirmRotate = true } else { Task { await rotate() } } }241 .buttonStyle(.bordered).disabled(busy).accessibilityIdentifier("webhook.rotate")242 }243 if let secret {244 VStack(alignment: .leading, spacing: 8) {245 Notice(tone: .warn, title: String(localized: "Copie ce secret maintenant"), message: String(localized: "Il n’est affiché qu’une fois. Ni l’app ni le serveur ne le montreront de nouveau ; il disparaît en quittant cet écran."))246 Text(secret).font(.spMono).textSelection(.enabled).fixedSize(horizontal: false, vertical: true).privacySensitive().accessibilityIdentifier("webhook.secret")247 HStack {248 Button { copy(secret) } label: { Label(copied ? String(localized: "Copié (effacé du presse-papiers dans 60 s)") : String(localized: "Copier"), systemImage: copied ? "checkmark" : "doc.on.doc") }249 .buttonStyle(.bordered).accessibilityIdentifier("webhook.copy")250 Spacer()251 Button(String(localized: "J’ai noté le secret")) { self.secret = nil; copied = false }.accessibilityIdentifier("webhook.dismissSecret")252 }253 }254 }255 Toggle(String(localized: "Montants et motifs dans les appels"), isOn: Binding(get: { w.details }, set: { on in Task { await save(.init(webhook: .init(details: on))) } }))256 if let sample = view.webhookSample, !sample.isNull {257 DisclosureGroup(String(localized: "Contenu exact d’un appel (exemple du serveur)")) { JSONFields(value: sample) }.font(.spCallout)258 }259 Toggle(String(localized: "Activer le webhook"), isOn: Binding(get: { w.enabled }, set: { on in Task { await save(.init(webhook: .init(enabled: on))) } }))260 .disabled(!w.enabled && (w.url.isEmpty || !view.webhook.secretSet)).accessibilityIdentifier("webhook.enable")261 Button { Task { await runTest() } } label: { HStack { Text(String(localized: "Envoyer un appel de test")); if busy { Spacer(); ProgressView() } } }262 .disabled(busy || w.url.isEmpty || !view.webhook.secretSet).accessibilityIdentifier("webhook.test")263 if let t = test {264 Notice(tone: t.ok ? .ok : .danger, title: t.ok ? String(localized: "Le récepteur a accepté l’appel (HTTP \(t.status))") : String(localized: "L’appel de test a échoué"),265 message: t.ok ? nil : (t.error ?? (t.status == 0 ? String(localized: "aucune réponse reçue") : "HTTP \(t.status)")))266 }267 if let error { ErrorNotice(error: error) }268 } header: { Text("Webhook") } footer: {269 Text(String(localized: "Le serveur appelle cette URL à chaque alerte, signée avec le secret partagé. L’appel de test envoie « Notification de test » au récepteur ; il ne crée pas d’alerte dans l’app."))270 }271 .onAppear { url = w.url }272 .onChange(of: w.url) { _, v in url = v }273 .onDisappear { secret = nil } // the secret never outlives the screen274 .confirmationDialog(String(localized: "Remplacer le secret ?"), isPresented: $confirmRotate, titleVisibility: .visible) {275 Button(String(localized: "Remplacer : l’ancien secret cesse de fonctionner"), role: .destructive) { Task { await rotate() } }276 }277 }278279 private func rotate() async {280 busy = true; defer { busy = false }281 do { secret = try await AlertsAPI(model.env.client).rotateWebhookSecret().secret; copied = false; error = nil; await reload() }282 catch let e { error = e }283 }284285 private func runTest() async {286 busy = true; defer { busy = false }287 do { test = try await AlertsAPI(model.env.client).testWebhook(); error = nil } catch let e { test = nil; error = e }288 }289290 /** This device only (no Universal Clipboard), gone after a minute. */291 private func copy(_ s: String) {292 UIPasteboard.general.setItems([[UTType.plainText.identifier: s]], options: [.localOnly: true, .expirationDate: Date().addingTimeInterval(Self.pasteboardLifetime)])293 copied = true294 }295}296