SPB Git

Repository Public

AlertSettingsView.swift 20.4 KB 296 lines swift

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
Files main
Menu

Theme